Découvrez comment utiliser les étapes de formulaire dans une application.
Creating and editing form steps will no longer be supported starting r401 /LTS18. Users should migrate existing form steps when possible.
As of r234, form steps have been disabled for all new Tulip Instances.
Migration des étapes de formulaire
À partir de la version r383 / LTS 17, Tulip propose un outil de migration assistée qui convertit une étape de formulaire en une étape standard dotée de widgets de saisie équivalents et de boutons « Soumettre » et « Annuler ». L’outil de migration ne fournit pas de remplacements exacts ; les utilisateurs doivent donc valider l’étape migrée avant sa publication.
L’outil ne modifie que la version de développement de votre application. Il ne modifie pas la version publiée de l’application et ne supprime pas l’étape de formulaire d’origine.
Pour migrer une étape de formulaire :
- Ouvrez l’application dans l’éditeur d’applications. Les étapes utilisant une étape de formulaire affichent une bannière : « La création et la modification d’étapes de formulaire ne seront plus prises en charge dans les prochaines versions. Convertissez cette étape en étape standard. »
- Cliquez sur « Convertir l’étape ».
- Vérifiez l’étape générée. La conversion est effectuée au mieux, il se peut donc que la mise en page, la validation et les déclencheurs nécessitent un ajustement manuel.
- Mettez à jour toutes les références restantes à l’ancienne étape de formulaire.
- Supprimez l'étape de formulaire et publiez l'application.
Champs de formulaire

Voici les différentes options disponibles dans le formulaire :
Booléen

Valeur par défaut : choisissez si la valeur par défaut doit être « Oui » ou « Non »
Liste déroulante

Valeur par défaut : choisissez une option qui doit être sélectionnée par défaut.
Afficher sous forme de boutons : affichez les options à l'écran plutôt que d'obliger l'opérateur à ouvrir la liste déroulante
Options du menu déroulant : ajoutez une nouvelle option à la liste déroulante ou créez un groupe au sein de la liste.
Vous pouvez ajouter une nouvelle option à l’aide de la touche « Entrée ». Vous pouvez également coller une liste d’options, à condition qu’elles soient séparées par des lignes distinctes dans un éditeur de texte (par exemple, Word ou une application de prise de notes).
Sélection multiple

Options de sélection multiple : ajoutez une nouvelle option à la liste ou ajoutez un groupe au sein de la liste.
Valeur(s) par défaut : choisissez une option qui doit être sélectionnée par défaut
Colonnes : si la liste d’options est longue, autorisez son fractionnement en plusieurs colonnes
Le widget de formulaire « Sélection multiple » stocke tous les choix sous forme de valeurs textuelles dans une variable.
Texte

Saisie multiligne : transformez un champ de saisie à ligne unique en champ multiligne pour encourager les réponses plus longues
Valeur par défaut : ajoutez une valeur par défaut pour le widget
Nombre

Valeur par défaut : ajoutez une valeur numérique par défaut pour le widget
Plage obligatoire : ne pas autoriser l'envoi du formulaire à moins que la valeur ne se situe dans une plage donnée
Masquer les commandes +/- : Masquez les boutons + et - du widget
Image

Options de saisie de photo : Choisissez si les opérateurs peuvent ajouter une photo via l'appareil photo, en la téléchargeant depuis leur ordinateur ou les deux.
Modifier les champs du formulaire
Vous pouvez modifier les options suivantes dans tous les types de widgets de formulaire :

Libellé du champ : le libellé affiché dans le formulaire
Taille de la police : taille de la police du libellé
Couleur de la police : couleur de la police du libellé
Style de police : style de la police du libellé
Variable : variable qui stocke la valeur saisie par un opérateur
Obligatoire : indique si l'opérateur doit saisir une valeur avant de pouvoir valider le formulaire
Pour plus de détails sur chaque widget de formulaire, consultez ce guide des widgets de formulaire
Modifier la mise en page du formulaire
Cliquez n'importe où sur l'étape elle-même pour afficher une liste d'options permettant de modifier la mise en page dans le volet de contexte situé à droite de l'écran.

Vous pouvez modifier la fonctionnalité des boutons « Annuler » et « Valider » à l’aide des menus déroulants du volet de contexte. Vous découvrirez comment créer une logique plus complexe avec ces options dans la section suivante.
Ajoutez plusieurs colonnes, puis faites glisser chaque champ vers la nouvelle colonne afin de pouvoir intégrer un plus grand nombre de champs dans le formulaire.
Toutes les étapes du formulaire comportent trois boutons en bas :

- « Annuler », qui propose plusieurs options pour les déclencheurs
- Menu
- Soumettre, qui propose plusieurs options pour les déclencheurs
Utilisation des variables dans les formulaires
Imaginons que vous souhaitiez créer une logique dynamique en fonction de la réponse spécifique fournie dans un formulaire.
Par exemple, si une personne effectue un contrôle qualité et qu’elle sélectionne l’option « Retouche » plutôt que « Rejet », vous souhaitez qu’elle place la pièce dans le bac approprié pour la retouche.
C’est là que vous aurez besoin d’une variable pour suivre la valeur d’un champ dans l’étape de formulaire.
Sélectionnez le champ, puis accédez à la section « Variable » dans le volet latéral.

Cliquez sur + pour créer une nouvelle variable qui suivra la valeur du champ.

Vous pouvez ensuite modifier le nom de la variable via le champ « Nom ».

Remplir un formulaire
As of r374, users can no longer copy, cut, or paste form triggers (i.e., form cancel or submit triggers) on form steps.
Plusieurs scénarios sont possibles lorsqu'un utilisateur est prêt à valider un formulaire. L'opérateur doit cliquer sur le bouton « Valider » situé dans le coin inférieur droit ou sur le bouton « Annuler » situé dans le coin inférieur gauche.

Pour choisir ce qui se passe après qu’un opérateur a cliqué sur l’un de ces boutons, vous pouvez sélectionner l’une des options situées au milieu du Side Pane lorsque vous cliquez sur l’arrière-plan de l’étape du formulaire.
Voici quelques options pour le bouton « Soumettre » :
- Aller à l’étape suivante: par défaut, l’utilisateur passe à l’étape suivante.
- Aller à l’étape…: choisissez une étape spécifique de l’application.
- Terminer l'application - L'utilisateur a terminé l'application.

- Action personnalisée - Vous pouvez ici ajouter un déclencheur personnalisé basé sur une variable mise à jour dans le formulaire (ou toute autre variable)
En savoir plus sur les actions personnalisées.
Il n'existe que deux façons d'effacer les valeurs d'une étape du formulaire :
- Terminer l'application
- Annuler l'application
Formulaire de signature
As of r234, Form steps have been disabled for all new Tulip Instances. Use the electronic signature widget instead.
L'étape « Formulaire de signature » oblige les opérateurs à ajouter une signature après avoir rempli un formulaire. Cela les empêche de passer à l'étape suivante tant qu'ils n'ont pas ajouté de signature.
Le formulaire de signature permet à un opérateur de valider un travail terminé ou un rapport de défaut. La signature sera automatiquement masquée par des astérisques (*) dans Tulip Player.
Pour ajouter un formulaire avec signature, cliquez sur le bouton « Ajouter » en haut à gauche de l'éditeur d'application et sélectionnez « Formulaire de signature ».

Vous disposerez alors de deux options concernant les signatures autorisées via l’option « Form Submitters » (Auteurs du formulaire) dans le volet latéral.

Tout utilisateur: n’importe quel opérateur peut ajouter une signature.
Tout opérateur sauf l'exécuteur de l'application: tout opérateur peut signer, à l'exception de celui qui est actuellement connecté.
Spécifier une liste d’utilisateurs autorisés: choisissez parmi la liste de tous les utilisateurs et opérateurs de votre compte Tulip. Plusieurs utilisateurs sont autorisés.
Utilisateur actuel: seul l'opérateur actuellement connecté peut ajouter sa signature.
Si vous choisissez cette option, la signature électronique sera automatiquement renseignée lorsque l'opérateur arrivera à l'étape du formulaire de signature. L'opérateur ne pourra pas modifier cette signature.
Remarque : le remplissage automatique des identifiants lorsque le widget est réglé sur « Utilisateur actuel » n’est disponible que lorsque :
- Votre organisation n’utilise pas le mode de validation
- Votre organisation exige que les opérateurs s’authentifient à l’aide d’identifiants LDAP ou SAML.
Un opérateur peut signer de trois manières différentes :
- Identifiant de badge
- Nom d'utilisateur/mot de passe LDAP : si votre organisation utilise LDAP pour authentifier les utilisateurs dans Tulip, l'opérateur doit alors saisir son nom d'utilisateur et son mot de passe issus de votre annuaire LDAP.
- Nom d'utilisateur/mot de passe SAML : si votre organisation utilise SAML pour authentifier les utilisateurs dans Tulip, l'opérateur doit alors saisir son nom d'utilisateur et son mot de passe issus de votre annuaire SAML dans une fenêtre contextuelle.
Vous pouvez ajouter plusieurs formulaires de signature au sein d’une même application.
Historique des signatures
Pour consulter la ou les signatures ajoutées à chaque achèvement d’application, accédez à l’onglet « Achèvements ». Une colonne est dédiée à chaque champ de signature, avec des détails sur l’opérateur et l’heure à laquelle il a rempli le formulaire de signature. Cet horodatage sera différent de celui de l’achèvement de l’application.

Utilisation des champs de formulaire dans Analytics
Vous pouvez analyser les données issues des formulaires, qu'elles contiennent ou non des variables.
Accédez à une analyse, puis sélectionnez la catégorie « Axe X » dans la barre latérale gauche.

Cliquez sur le point de données existant.

Sélectionnez ensuite la catégorie « Formulaires de l'application ».

Vous pourrez choisir n'importe quel champ de formulaire de l'ensemble de l'application.
Si vous choisissez de suivre le résultat d'un champ de formulaire dans une variable, vous pouvez également utiliser cette variable dans la catégorie « Variables de l'application ».

Une analyse sous forme de tableau peut afficher plusieurs champs de formulaire à la fois. Pour sélectionner plusieurs champs de formulaire, cliquez sur l'onglet « Opérations » dans le menu de gauche.

Cliquez sur le bouton « Ajouter une nouvelle opération », puis choisissez un champ de formulaire spécifique à ajouter.

Voici à quoi ressemblera le tableau.

{{snippet.Avez-vous trouvé ce que vous cherchiez ?}}

