@TEXT_QUESTION

Spécifie qu’une variable s’attend à recevoir du texte et personnalise la façon de demander la valeur.

Avant de générer un document, DocuMold affichera une zone de texte pour écrire une courte ligne de texte.

Utilisation

<# @TEXT_QUESTION(variable, **voir les paramètres ci-dessous**) #>

Paramètres

variable	(Requis) La variable cible. Ne pas utiliser de guillemets (`"`) de chaque côté, écrivez-la simplement comme une utilisation de la variable
example_value:	(Nommé) La valeur initiale dans le formulaire lors de la préparation d’un modèle (via “Préparer un modèle”). Si non fournie, la valeur de `initial_value` est utilisée.
help_text:	(Nommé) Affiche une bulle cliquable (?) à côté de l’étiquette. Cliquer dessus révélera ce texte. Utile pour donner des indications à l’utilisateur du modèle DocuMold
initial_value:	(Nommé) La valeur initiale dans le formulaire lors de l’utilisation d’un modèle (via “Utiliser un modèle”). Ceci est également la valeur par défaut du paramètre `example_value`.
label:	(Nommé) Le texte à afficher à côté de la zone de texte qui demande la valeur. Par défaut, le nom de la variable
optional:	(Nommé) Mettre à `TRUE` pour permettre à l’utilisateur de laisser le texte vide . (La valeur serait alors un texte vide)
placeholder:	(Nommé) Lorsque la zone de texte est vide, ceci sera affiché en gris comme un exemple ou un court message

Pour les paramètres avec “Nommé”, il faut indiquer le nom du paramètre puis un deux-point avant sa valeur. Ex: example_value: "une valeur". Pour cette raison, les noms de ces paramètres ne sont pas traduit en français dans la documentation.

Exemples

Exemple	Résultat
<# @TEXT_QUESTION(pays, label: “Pays du participant”, placeholder: “Canada”) #>
<# @TEXT_QUESTION(nom_client, label: “Nom complet du client”, help_text: “S’il y a plusieurs clients, utilisez une virgule et un espace entre chacun.”, placeholder: “Prénom Nom de famille”) #>

Plus d'information

Nettoyer la valeur entrée

@TEXT_QUESTION, tout comme @BIG_TEXT_QUESTION, nettoie la valeur saisie. Cela vise à réduire les problèmes causés par le placement accidentel d’un espace avant ou après la valeur, ou par l’utilisation accidentelle de plus d’un espace. Le nettoyage est effectué en exécutant la fonction TRIM sur chaque ligne de texte saisie.

Cela signifie que si l’utilisateur entre " Anna Logwatch " (sans les guillemets), la valeur dans la variable sera "Anna Logwatch".

Cela peut être modifié en utilisant le paramètre trim_with:. Soit en changeant ce qui est supprimé (en utilisant les valeurs "TRIMLEFT", "TRIMRIGHT" ou "TRIMSIDES" qui sont des noms de fonctions), soit en désactivant la fonctionnalité avec "NOTHING" ou NOTHING.

Autre

Cette action ne fait rien au document lui-même ; elle est effacée lors de la génération d’un document.

Toutes les actions @..._QUESTION sont normalement placées à la fin du modèle pour éviter de submerger les utilisateurs non familiers.

L’action @IF n’a aucun effet sur les actions @...QUESTION. Les actions @...QUESTION ont un effet même quand elles sont cachées.