Découvrez comment valider les données dans Tulip à l’aide de widgets, de boutons et de déclencheurs.
L’utilisation de la validation des données pour les saisies des opérateurs réduit les problèmes de qualité et uniformise les formulaires utilisés dans votre processus. Si un utilisateur saisit une valeur qui ne respecte pas les critères de validation, un message d’erreur s’affiche. De plus, vous pouvez utiliser une logique de déclenchement pour empêcher un opérateur de poursuivre l’utilisation de l’application si les données saisies ne répondent pas aux exigences.
La validation des données rend le développement d’applications beaucoup plus fluide et offre les avantages suivants :
- Simplification de la gestion des déclencheurs: réduisez le nombre et la complexité des déclencheurs pour rationaliser le développement et la maintenance des applications. Consacrez moins de temps au développement des applications.
- Créer des étapes dynamiques : ajoutezun contrôle dynamique aux applications grâce à la fonctionnalité d’activation/désactivation des boutons, ce qui permet une plus grande interactivité et flexibilité.
- Réduire la maintenance des applications : consacrezmoins de temps à la révision et à la compréhension des applications. Copiez-collez des widgets sans vous soucier des implications au niveau des déclencheurs.
Vous pouvez également offrir une expérience utilisateur intuitive grâce à des boutons activés et désactivés de manière dynamique.
Règles de validation disponibles par widget de saisie
Bien que vous puissiez utiliser n’importe quel widget de saisie pour la validation des données, certains d’entre eux disposent de règles de validation permettant de définir les paramètres des données. Le tableau ci-dessous présente les règles de validation disponibles pour chaque Input Widget.
| Widget de saisie | Règles de validation |
|---|---|
| Case à cocher | N/A |
| Texte | Contient, Ne contient pas, Commence par, Se termine par, Nombre maximal de caractères, Nombre minimal de caractères, Est une adresse e-mail, Est une URL (selon cette page) |
| Multiligne | Contient, Commence par, Se termine par, Nombre maximal de caractères, Nombre minimal de caractères, Ne contient pas |
| Fichier | Sans objet |
| Nombre | Égal à, Différent de, Supérieur à, Supérieur ou égal à, Inférieur à, Inférieur ou égal à, Compris dans l'intervalle (inclus), Hors de l'intervalle (exclus), Nombre exact de décimales |
| Sélection unique | N/A |
| Sélection multiple | Sélection minimale, sélection maximale |
| Sélecteur de date | Est, Avant, Après, Dans la plage (inclus), Hors de la plage (exclus), Le ou avant, Le ou après |
| Image | Sans objet |
| Signature électronique | N/A |
Créer une règle de validation
- Sélectionnez un widget de saisie pour lequel des règles de validation sont disponibles (voir le tableau ci-dessus).
- Dans le volet de contexte, cliquez sur l'icône + à côté de « Règles de validation ».
- Sélectionnez la règle que vous souhaitez ajouter au widget de saisie.
- Sélectionnez une source de données que la règle doit valider. Il peut s'agir d'une valeur statique ou d'une variable.
- Cliquez sur le bouton « + » pour ajouter d'autres règles.
Réorganiser les règles de validation
L'ordre des règles de validation correspond au premier message d'erreur affiché si la valeur saisie n'est pas valide.
Dans les exemples ci-dessous, les données saisies ne respectent aucune des deux règles de validation. Cependant, le message d’erreur affiché correspond à la première règle configurée.
Exemple 1: «ContientTulip » est la première règle non respectée ; le message d’erreur s’affiche donc en conséquence.
Exemple 2 : « Commencepar Hello » est la première règle qui échoue ; le message d’erreur s’affiche donc en conséquence.
Cela permet aux développeurs d’applications de définir l’ordre de priorité des messages d’erreur à afficher à un opérateur. Pour réorganiser les règles de validation, cliquez sur l’icône représentant six points et faites-la glisser avant ou après une règle.
Rendre les données obligatoires
Marquer les règles de validation comme obligatoires ajoute une condition selon laquelle l’opérateur doit remplir le champ pour que la saisie soit considérée comme valide. Vous pouvez utiliser cette option pour tous les types de widgets de saisie. Lorsqu’un widget de saisie est marqué comme obligatoire, un astérisque rouge apparaît à côté de ce widget dans l’application. Pour ce faire, activez le curseur « Marquer comme obligatoire » situé sous l’en-tête de la section « Règles de validation » du volet latéral.
Messages d’erreur de validation des données saisies
Le menu déroulant « Formatage des erreurs » situé dans la section « Règles de validation » du volet latéral propose différentes options pour définir la manière dont une erreur liée aux données saisies s'affiche à l'opérateur lorsque l'application s'exécute dans le Player.
Les trois options permettant de signaler les erreurs à l’opérateur : 1. Afficher le message d’erreur de la règle de validation * Entoure le champ de saisie en rouge et affiche un message d’erreur à l’opérateur 2. Entourer uniquement le champ de saisie * Entoure le champ de saisie en rouge 3. Masquer l’erreur * Aucune indication visuelle n’est fournie
Activer et désactiver dynamiquement les boutons
Déterminez à quel moment les opérateurs peuvent appuyer sur un bouton grâce aux contrôles dynamiques. Lorsqu’un bouton est désactivé, il s’affiche dans des couleurs atténuées et l’opérateur ne peut pas appuyer dessus.
Vous pouvez même utiliser ce contrôle sur les widgets de signature électronique.
Les boutons peuvent être activés ou désactivés de manière dynamique en définissant l'état « Activé » dans la section « Interaction » du volet latéral correspondant au bouton sélectionné. Par défaut, l'état « Activé » d'un bouton est défini sur « Oui ».
Il existe plusieurs façons d’ajouter un contrôle dynamique pour déterminer l’état d’activation d’un bouton : 1. Spécifier une variable booléenne 2. Vérifier la validité des données saisies par l’utilisateur dans l’étape comportant des widgets de saisie dotés de règles de validation 3. L’option « Tous les widgets », qui vérifie si toutes les données saisies respectent les règles de validation
- Utiliser une expression
Utiliser des expressions pour activer/désactiver des boutons
Si vous souhaitez activer ou désactiver un bouton en fonction d’un sous-ensemble de widgets, sélectionnez « Utiliser une expression » pour écrire une condition personnalisée.
Vous devez écrire une expression dont le résultat est une condition booléenne (vrai ou faux). Si vous construisez correctement une expression valide, l’éditeur d’expressions l’indiquera en bas à gauche.
**Exemple 1 :**L'exemple ci-dessous utilise l'opération modulo pour déterminer si la valeur saisie dans un widget de saisie numérique est paire ou impaire. Si la valeur est impaire, le bouton sera activé. Si la valeur est paire, le bouton sera désactivé.
Exemple 2 : L'utilisationd'expressions vous permet également de combiner plusieurs conditions entre elles. Dans l'exemple ci-dessous, pour que le bouton soit activé, la valeur doit être impaire et respecter les conditions de validation définies pour le widget de saisie numérique.
La valeur saisie ci-dessous entraîne la désactivation du bouton. Même si la valeur saisie est impaire, elle ne respecte pas les règles de validation du widget de saisie.
La valeur saisie ci-dessous entraîne l'activation du bouton, car la valeur saisie est à la fois impaire et conforme aux règles de validation du widget de saisie.
Validation des widgets de saisie dans les déclencheurs
Vous pouvez utiliser la validation des widgets de saisie dans le cadre d’une condition « Si » au sein d’un déclencheur. Cela permet aux développeurs d’applications de créer rapidement une logique qui ne dépend pas des valeurs spécifiques saisies par les opérateurs, mais de la validité de ces valeurs.
Les informations de validité des widgets peuvent également être stockées dans des variables et des enregistrements de table à l'aide de déclencheurs.
Avez-vous trouvé ce que vous cherchiez ?
Vous pouvez également vous rendre sur community.tulip.co pour poser votre question ou voir si d'autres utilisateurs ont rencontré un problème similaire !