Logo Docs
Logo Docs

@PICK_ONE_QUESTION

Spécifie qu’une variable sera une valeur provenant d’une liste de choix.

Avant de générer un document, DocuMold affichera une liste déroulante pour choisir la valeur.

Utilisation

<# @PICK_ONE_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
choices:

(Nommé, Requis) Les choix à afficher. Peut être une liste de valeurs, une liste de liste de deux valeurs, ou un DT_CHOICES. Voir “Plus d’information” ci-dessous pour les détails.
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 liste déroulante qui demande la valeur. Par défaut, le nom de la variable
optional:

(Nommé) Mettre à TRUE pour permettre à l’utilisateur de ne pas faire un choix . (La valeur serait alors NOTHING)
placeholder:

(Nommé) Si spécifié, texte affiché par défaut dans la boîte déroulante. Si non spécifié, le texte affiché par défaut est “Choisir”

Pour les paramètres avec “Nommé”, il faut indiquer le nom du paramètre puis un deux-point avant sa valeur. Ex: choices: "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

<# @PICK_ONE_QUESTION(pays, label: “Pays des participants”, choices: [“Belgique”, “Canada”, “Autre”]) #>

<# @PICK_ONE_QUESTION(ordre_liste, label: “Ordre des participants”,
choices: [[“Par nom”, “nom”], [“Par âge”, “âge”]],
help_text: “Ceci est l’ordre dans lequel les participants seront listés”) #>

<# @PICK_ONE_QUESTION(employé, label: “Employé”,
choices: DT_CHOICES(“employés”, CONCAT(.prénom, “ “, .nom_de_famille))) #>

<# @PICK_ONE_QUESTION(réduction, label: “Réduction à appliquer”,
choices: [[“Étudiant”, 0.1], [“Sénior”, 0.15]]) #>

Plus d'information

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

Les choix peuvent être :

  • Une liste de valeurs : chaque valeur sera affichée comme un choix, et c’est la valeur que la variable aura.
  • Une liste de liste de 2 valeurs : Fondamentalement une liste de paires. Pour chaque paire, la première valeur est le texte à afficher dans la liste déroulante et la seconde valeur est celle obtenue quand ceci est sélectionné. Donc [["Par nom", "nom"], ["Par âge", "âge"]] signifie que les choix sont Par nom et Par âge, et la variable sera définie soit à "nom" soit à "âge". Ceci est utile pour fournir un choix plus clair à l’utilisateur, sans avoir à écrire le texte plus long partout. Les valeurs peuvent être non textuelles, telles que des nombres, des dates, etc.
  • DT_CHOICES est une fonction qui permet d’obtenir des choix à partir d’une table de données. Voir DT_CHOICES pour plus de détails.

Si aucune valeur n’est sélectionnée dans le formulaire pour cette question, la variable sera définie à NOTHING.

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.

Voir aussi