Logo Docs
Logo Docs

Personnaliser le formulaire

À mesure qu’un modèle grandit, il devient important de personnaliser le formulaire utilisé pour donner leurs valeurs aux variables. Cela rend le modèle plus facile à utiliser.

Ce tutoriel vous montrera comment :

  • Avoir un libellé différent pour une variable. Ex : “Nom du client” au lieu de “nom_du_client”
  • Choisir l’ordre dans lequel les champs sont affichés
  • Fournir un texte d’aide à l’utilisateur
  • Offrir des choix à l’utilisateur (en affichant un menu déroulant)

1. Commencer un nouveau document Microsoft Word

Le bac à sable ne peut pas montrer le formulaire complet, donc nous devons utiliser des documents Word pour ce tutoriel. Nous parlerons de comment le bac à sable peut toujours être utile à la fin.

Pour l’instant, créez un nouveau document Word.

2. Utiliser le modèle dans DocuMold

Ouvrez le document immédiatement dans DocuMold.

  1. Sauvegardez votre modèle sur votre ordinateur, incluez “modèle” dans le nom pour aider à le distinguer. Assurez-vous qu’il est dans la version Word 2007 ou supérieure (365 est aussi correct)
  2. Connectez-vous sur https://documold.com
  3. Cliquez sur “Préparer un modèle” dans le menu à gauche
  4. Cliquez sur “Choisir un modèle” et trouvez le modèle

Puisque le modèle est vide, aucune variable n’est affichée.

Important : Gardez cette page ouverte, nous pourrons appuyer sur “Rafraîchir le modèle actuel” pour voir rapidement les changements dans le formulaire.

3. Ajouter des variables

Ajoutez ces lignes à votre modèle :

Pour <# nom_du_client #>
Pays : <# pays_du_client #>
Né le <# date_de_naissance_du_client #>

4. Voir le nouveau formulaire

Sauvegardez le modèle, revenez à la page DocuMold et appuyez sur “Rafraîchir le modèle actuel”. Vous devriez voir 3 zones de texte avec des noms similaires à vos variables.

5. Réordonner

Les variables dans le formulaire sont dans l’ordre alphabétique. C’est le comportement par défaut quand aucune information n’a été fournie à leur sujet.

En ce moment, nom_du_client n’est pas en premier dans le formulaire, mais il semble plus naturel que ce le soit. Faisons cela.

À la fin du document, ajoutez les lignes suivantes :

Pour <# nom_du_client #>
Pays : <# pays_du_client #>
Né le <# date_de_naissance_du_client #>

<# @TEXT_QUESTION(nom_du_client) #>
<# @TEXT_QUESTION(pays_du_client) #>
<# @TEXT_QUESTION(date_de_naissance_du_client) #>

Ceci utilise l’action @TEXT_QUESTION. Au lieu d’écrire quelque chose dans le document, @TEXT_QUESTION indique à DocuMold comment afficher le formulaire pour cette variable. Les actions ont été introduites dans le tutoriel Contenu conditionnel.

Lorsque vous générez un document, ces commandes seront supprimées.

Sauvegardez votre modèle, allez dans DocuMold et appuyez sur le bouton “Rafraîchir le modèle actuel”, vous devriez maintenant voir les 3 noms de variables avec zone de texte dans le même ordre que les actions @TEXT_QUESTION sont dans le document.

Note : les variables sans une action @...QUESTION associée sont placées alphabétiquement après celles avec une action @...QUESTION.

6. Libellés plus clairs

Retournez au modèle et ajoutez , label: "Date de naissance du client" avant la parenthèse fermante de l’action @TEXT_QUESTION de date_de_naissance_du_client.

Le document devrait maintenant ressembler à ceci :

Pour <# nom_du_client #>
Pays : <# pays_du_client #>
Né le <# date_de_naissance_du_client #>

<# @TEXT_QUESTION(nom_du_client) #>
<# @TEXT_QUESTION(pays_du_client) #>
<# @TEXT_QUESTION(date_de_naissance_du_client, label: "Date de naissance du client") #>

Sauvegardez votre modèle, allez dans DocuMold et appuyez sur le bouton “Rafraîchir le modèle actuel”. Le formulaire devrait maintenant afficher Date de naissance du client au lieu de date_de_naissance_du_client.

@TEXT_QUESTION a beaucoup de paramètres optionnels pour différentes choses. Pour permettre de donner une valeur seulement aux paramètres d’intérêt, le nom du paramètre recevant la valeur doit être spécifié avec deux points (:), comme : label: "Date de naissance du client".

Ajoutez un label: aux actions @TEXT_QUESTION restantes. Vous devriez finir avec quelque chose comme ceci :

Pour <# nom_du_client #>
Pays : <# pays_du_client #>
Né le <# date_de_naissance_du_client #>

<# @TEXT_QUESTION(nom_du_client, label: "Nom complet du client") #>
<# @TEXT_QUESTION(pays_du_client, label: "Pays du client") #>
<# @TEXT_QUESTION(date_de_naissance_du_client, label: "Date de naissance du client") #>

Sauvegardez votre modèle, allez dans DocuMold et appuyez sur le bouton “Rafraîchir le modèle actuel” pour vous assurer que tout est comme prévu et qu’il n’y a pas d’erreurs.

7. Valeur d’exemple

Lorsque vous travaillez sur des modèles, vous allez remplir le formulaire de nombreuses fois en essayant le modèle et visualisant le résultat pour valider son comportement.

Pour éviter de toujours devoir écrire une valeur pour chaque champ, vous pouvez fournir une valeur d’exemple qui sera préremplie dans le formulaire, mais seulement lors de l’utilisation de “Préparer un modèle”. Ajoutons-en une pour nom_du_client.

Ajoutez , example_value: "Anna Logwatch" avant la parenthèse fermante de l’action @TEXT_QUESTION de nom_du_client.

Le document devrait maintenant ressembler à ceci :

Pour <# nom_du_client #>
Pays : <# pays_du_client #>
Né le <# date_de_naissance_du_client #>

<# @TEXT_QUESTION(nom_du_client, label: "Nom complet du client", example_value: "Anna Logwatch") #>
<# @TEXT_QUESTION(pays_du_client, label: "Pays du client") #>
<# @TEXT_QUESTION(date_de_naissance_du_client, label: "Date de naissance du client") #>

Pour le voir en action :

  1. Sauvegardez le modèle
  2. Revenez à DocuMold
  3. Cliquez sur “Préparer un modèle” dans le menu à gauche pour actualiser la page
  4. Cliquez sur “Choisir un modèle” et trouvez le modèle à nouveau

Le formulaire devrait apparaître, mais avoir le “Anna Logwatch” déjà rempli comme “Nom complet du client”. Vous êtes libre de le changer quand vous en avez besoin, mais de cette façon, vous n’avez pas besoin de toujours le remplir pour vos tests.

Cela ne se produira pas dans “Utiliser un modèle”. Si vous voulez que cela se produise là aussi, vous pouvez utiliser le paramètre initial_value:. Cela peut être utile lorsque vous vous attendez à ce qu’un champ ait la même réponse la plupart du temps.

8. Texte d’aide

Certains des champs d’un modèle peuvent être complexes. Le paramètre help_text: vous permet de fournir autant d’informations que nécessaire aux utilisateurs qui en ont besoin.

Ajoutez-le avec un peu de texte à la variable pays_du_client de @TEXT_QUESTION. Cela devrait ressembler à ceci :

Pour <# nom_du_client #>
Pays : <# pays_du_client #>
Né le <# date_de_naissance_du_client #>

<# @TEXT_QUESTION(nom_du_client, label: "Nom complet du client") #>
<# @TEXT_QUESTION(pays_du_client, label: "Pays du client", help_text: "Ceci est le pays où le client fait des affaires.") #>
<# @TEXT_QUESTION(date_de_naissance_du_client, label: "Date de naissance du client") #>

Sauvegardez le modèle et cliquez sur “Rafraîchir le modèle actuel” dans DocuMold. Vous devriez voir apparaître une icône “” à côté du libellé Pays du client. Cliquer dessus affiche le texte d’aide donné au-dessus du champ. Cliquer sur l’icône “” à nouveau ou sur le texte d’aide cachera le texte d’aide.

9. Choix

Si vous travaillez seulement avec quelques pays, fournir une liste de choix à sélectionner serait utile, économisant du temps et réduisant les erreurs.

Remplacez l’action @TEXT_QUESTION de pays_du_client par @PICK_ONE_QUESTION et ajoutez cette valeur reçue : choices: ["Belgique", "Canada", "France", "États-Unis"]

Le modèle devrait maintenant ressembler à ceci :

Pour <# nom_du_client #>
Pays : <# pays_du_client #>
Né le <# date_de_naissance_du_client #>

<# @TEXT_QUESTION(nom_du_client, label: "Nom complet du client") #>
<# @PICK_ONE_QUESTION(pays_du_client, label: "Pays du client", help_text: "Ceci est le pays où le client fait des affaires.", choices: ["Belgique", "Canada", "France", "États-Unis"]) #>
<# @TEXT_QUESTION(date_de_naissance_du_client, label: "Date de naissance du client") #>

Sauvegardez le modèle et cliquez sur “Rafraîchir le modèle actuel” dans DocuMold. La boîte d’entrée du pays devrait maintenant être un menu déroulant sur lequel vous pouvez cliquer pour choisir le pays.

Note : Les [ et ] marquent le début et la fin d’une liste, de la même manière que nous utilisons " pour marquer du texte. Comme avec les valeurs qu’une fonction reçoit, nous utilisons une virgule pour séparer les éléments de la liste. Donc ["Belgique", "Canada", "France", "États-Unis"] est une liste de 4 valeurs textuelles.

Les choix sont affichés dans l’ordre dans lequel vous les mettez.

10. Essayez-le !

Maintenant, remplissez le formulaire et générez un exemple pour voir le résultat.

11. Actions QUESTION

Voici les actions QUESTION actuellement disponibles :

  • BIG_TEXT_QUESTION : Peut écrire n’importe quel texte même avec des changements de ligne
  • DATE_QUESTION : Affiche un sélecteur de date
  • NUMBER_QUESTION : Peut seulement écrire un nombre
  • PICK_MANY_QUESTION : Affiche des choix et permets d’en sélectionner plusieurs
  • PICK_ONE_QUESTION : Affiche des choix et vous permet d’en sélectionner un seul
  • TEXT_QUESTION : Peut écrire n’importe quel texte sans changements de ligne
  • YES_NO_QUESTION : Peut seulement choisir entre “Oui” ou “Non”, ce qui définit la variable à TRUE ou FALSE

DocuMold possède de nombreux paramètres pour personnaliser les questions. Vous pouvez trouver leur documentation dans le menu à gauche de cette page, sous “Toutes les actions” puis “Questions”.

12. Dans le bac à sable

Le bac à sable ne peut pas vous montrer un formulaire complet avec toutes les questions à la fois. Cependant, il peut afficher le formulaire pour une question à la fois.

Ouvrez le bac à sable :

  1. Connectez-vous sur https://documold.com
  2. Cliquez sur “Bac à sable” dans le menu à gauche
  3. Cliquez sur “Réinitialiser” en haut pour que vous commenciez avec le contenu que ce tutoriel attend

Dans la boîte à gauche, ajoutez un @PICK_ONE_QUESTION et utilisez sa variable. Voici un exemple :

<# @PICK_ONE_QUESTION(pays_du_client, label: "Pays du client",
  help_text: "Ceci est le pays où le client fait des affaires.",
  choices: ["Belgique", "Canada", "France", "États-Unis"]) #>

Pays : <# pays_du_client #>

Dans la boîte de droite, vous devriez voir le premier choix du @PICK_ONE_QUESTION. Le bac à sable choisit une valeur lorsque vous ajoutez une question pour la première fois.

En bas à gauche, la boîte ronde pour votre variable devrait également afficher le premier choix. Vous pouvez cliquer sur le choix ou l’icône de stylo à côté pour voir le formulaire pour cette question et fournir une nouvelle valeur.

Ceci est très utile non seulement pour apprendre comment chaque @...QUESTION se comporte, mais aussi pour que vous puissiez avoir différents types de valeurs dans le bac à sable. Par exemple, si vous voulez essayer des fonctions qui reçoivent des dates (comme DAY), vous pouvez utiliser l’action @DATE_QUESTION qui définira la variable à une date (au lieu de texte qui contient une date).

Conclusion

Personnaliser le formulaire est important. Passer du temps dessus peut économiser beaucoup de temps plus tard lorsque les utilisateurs utilisent le formulaire. Moins d’erreurs, moins de confusion, moins de temps à expliquer.