Contrôles de formulaire

Une fois que vous avez sélectionné un composant de formulaire, un assistant s'ouvre et affiche plusieurs onglets de configuration afin de permettre une personnalisation plus poussée des différentes fonctionnalités. Vérifiez la progression dans le volet de prévisualisation de l'assistant.

Lorsque vous êtes satisfait de la conception d'un composant, sélectionnez Enregistrer ( Save).

Le tableau ci-dessous décrit les paramètres et les commandes disponibles pour les onglets courants de l'assistant.

Onglet Assistant	Description	Mentions spéciales
Affichage	Configurez le mode d'affichage du composant de formulaire.	Le nom que vous avez défini dans le champ obligatoire Libellé (Label) devient le NomPropriété ( PropertyName ) dans l'onglet Clé de champ ( Field Key) .
Données	Configurez une valeur par défaut que les utilisateurs finaux voient dans le champ de texte.	Les composants pouvant contenir plusieurs éléments (par exemple, les zones de sélection, les onglets) peuvent être définis ici.
Validation	Configurez les exigences de validation pour activer d'autres composants d'IU.	NA
Clé de champ	Configurez le nom de propriété du composant que vous souhaitez utiliser dans le workflow.	Par défaut, cette valeur est celle indiquée par le champ Libellé de l'onglet Affichage.
Conditionnel	Configurez les conditions du composant.	Vous pouvez définir des conditions avancées (par exemple, Javascript ou JSON).
Logique	Configurez la logique qui déclenche les conditions.	NA

Certains composants de formulaire disposent d'onglets spécifiques, par exemple :

Composant (Component)	Onglet Assistant	Description
Date/Heure	Date	Configurez les dates minimale et maximale disponibles pour la sélection.
	Délai (Time)	Configurez l'étape incrémentielle pour les heures et les minutes.
Jour	Jour	Configurez la façon dont l'utilisateur professionnel sélectionne le jour (incrémentiel ou à partir d'une liste déroulante).
	Mois	Configurez la façon dont l'utilisateur professionnel sélectionne le mois (incrémentiel ou dans une liste déroulante).
	Année	Configurez la façon dont l'utilisateur professionnel sélectionne l'année (incrémentielle ou dans une liste déroulante), ainsi que les années minimale et maximale disponibles pour la sélection.
Modifier la grille	Modèles	Personnalisez les en-têtes et les lignes de vos données de grille de mise à jour.
Carte de données	Mise en page	Appliquez des modifications de mise en page à la marge à votre carte de données.

Affichage

Libellé : le titre du composant.

Position du libellé (Label Position ) - Position du libellé d'un champ.

Description : le texte qui apparaît sous le champ d'entrée.

Info-bulle (Tooltip ) : ajoute une icône d'info-bulle sur un côté de l'icône. Saisissez le texte de l'info-bulle.

Classe CSS personnalisée (Custom CSS Class ) - Ajoutez une classe CSS personnalisée au composant. Vous pouvez ajouter plusieurs classes, séparées par un espace.

Masqué (Hidden ) - Masquez un composant lorsque vous affichez le formulaire.

Remarque : le composant apparaît toujours dans le fichier JSON.

Masquer le libellé (Hide Label ) - Masquez le libellé d'un composant.

Désactivé (Disabled ) : désactive un champ du formulaire.

Espace réservé : le texte qui apparaît lorsque le champ est vide.

Préfixe (Prefix ) - Texte affiché avant un champ.

Suffixe (Suffix) - Texte affiché après un champ.

Unique : lorsque cette case est cochée, le champ est considéré comme unique par rapport au formulaire.

Protégé (Protected) - Lorsque cette case est cochée, le champ est disponible pour la saisie uniquement.

Persistent (Persistent) - Lorsque cette option est cochée, elle stocke un champ dans la base de données. Si vous ne souhaitez pas enregistrer un champ dans la base de données, décochez la case Persistent ( Persistent).

Vue de la table (Table View ) : lorsque cette option est cochée, cette option affiche la valeur des envois dans la vue de la table. Vous pouvez l'utiliser pour les composants enfants que vous ajoutez dans les composants Modifier la grille ( Edit Grid ), afin d'afficher les composants enfants à l'intérieur des lignes. Si elle n'est pas cochée, les données ne s'affichent pas dans la ligne réduite de la grille d'édition. Même si les données ne s'affichent pas, vous pouvez configurer un composant tout en modifiant une ligne.

Masque de saisie (Input Mask ) : un masque de saisie fournit un format prédéfini. Par exemple, pour un champ de numéro de téléphone, le masque de saisie par défaut serait [phone]. Les éléments du masque de saisie sont :

• 9 - numérique
• a - alphabétique
• * - alphanumérique

Données

Valeur par défaut (Default Value ) : la valeur du champ avant que les utilisateurs n'interagissent avec celui-ci. La valeur par défaut remplace le texte de l'espace réservé.

Valeurs multiples (Multiple Values ) : lorsque cette case est cochée, plusieurs valeurs peuvent être ajoutées au champ. Les valeurs apparaissent sous forme de tableau dans l’API et un bouton Ajouter un autre ( Add Another Button ) est visible sur le champ.

Contenu (Content) - Section dans laquelle vous saisissez le contenu d'un composant.

Format des données : le format moment.js que vous utilisez pour enregistrer ce champ. Par exemple, HH:mm:ss.

Redessiner le (Redraw On ) : permet de redessiner ce composant si un autre composant du formulaire change. Choisissez l'événement lorsque le composant doit être redessiné dans la liste déroulante. Les événements par défaut à choisir sont Toute modification (Any Change ) et Soumettre(Submit).

Validation

Obligatoire (Required) - Lorsque cette option est cochée, ce champ doit obligatoirement contenir une valeur.

Valider le (Validate On ) : détermine quand ce composant déclenche la validation frontale. Choisissez un événement dans la liste déroulante : Modifier ( Change ) ou Flou(Flou) .

Longueur minimale (Minimum Length ) : la longueur minimale requise que ce champ doit respecter.

Longueur maximale (Maximum Length ) : la longueur maximale requise que ce champ doit respecter.

Longueur minimale des mots (Minimum Word Length ) - Le nombre minimum de mots pouvant être ajoutés à ce composant.

Longueur maximale des mots(Maximum Word Length) - Le nombre maximal de mots pouvant être ajoutés à ce champ.

Modèle d'expression régulière : le modèle d'expression régulière que le composant doit transmettre avant que le formulaire puisse être soumis.

Libellé d'erreur : le libellé qui s'affiche lorsqu'un message d'erreur de validation s'affiche.

Message d'erreur personnalisé : un message d'erreur personnalisé à afficher si une erreur se produit.

Autoriser uniquement les valeurs disponibles (Allow only available values ) - Lorsque cette case est cochée, effectue un contrôle de validation pour s'assurer que la valeur sélectionnée est une option disponible.

Clé de champ

Nom de lapropriété (Property Name ) : le nom de l'argument correspondant à un composant de la collection Arguments (Arguments Collection).

Vous pouvez utiliser le nom de propriété pour transmettre des arguments (à l'aide de l'activité Set Form Values ) à l'intérieur du formulaire ou pour obtenir des valeurs à l'extérieur d'un formulaire (à l'aide de l'activité Get Form Values ).

Conditionnel

L'onglet Condition (Conditional) du générateur de formulaires vous permet de placer des conditions sur les composants de votre formulaire, de les masquer ou de les afficher.

L'onglet Conditionnel (Conditional) comporte deux sections :

• Simple
• Conditions avancées

Conditions simples

La section Simple de l'onglet Conditionnel (Conditional ) vous permet de masquer ou d'afficher un composant, en fonction de la valeur d'un autre composant.

La section Simple se compose de trois champs :

1. Ce composant doit afficher : dans cette liste déroulante, choisissez :

   • Cette propriété a lavaleur True si vous souhaitez appliquer une condition à l'affichage du composant.
   • False (False) si vous souhaitez appliquer une condition au moment où le composant est masqué.
2. Lorsque le composant de formulaire : dans cette liste déroulante, choisissez un composant du formulaire devant servir de condition.

3. A la valeur : saisissez la valeur qui conditionne le moment où le composant doit être affiché ou masqué.

   
   

   

   
   

Conditions avancées

La section Conditions avancées (Advanced Conditions ) vous permet d'utiliser du code JavaScript ou JSONLogic pour effectuer des combinaisons de conditions.

Remarque : la logique avancée (Advanced Logic) remplace les résultats de la logique conditionnelle simple .

Dans la section Code JavaScript, entrez un code JavaScript personnalisé.

La variable show doit recevoir une valeur true ou false . La variable de données est utilisée pour accéder à d'autres composants du formulaire, via la clé API.

Pour apprendre à utiliser les composants conditionnels, consultez la page du tutoriel sur les composants conditionnels .

Logique

L'onglet Logique (Logic) du générateur de formulaires vous permet de créer des conditions et des scripts logiques avancés qui peuvent modifier l'état ou le comportement du composant de formulaire sélectionné.

À l'aide d'une logique avancée, vous pouvez modifier dynamiquement les commandes et l'apparence d'un composant de formulaire.

Une logique de formulaire se compose de deux parties : le déclencheur et l'action.

Déclencheur

Le déclencheur logique est la condition sur laquelle l'action a lieu. Par exemple, vous souhaiterez peut-être afficher un champ de formulaire spécifique uniquement lorsqu'une option de case à cocher est sélectionnée. Dans ce cas, l'option de case à cocher est le déclencheur et l'affichage du champ de formulaire est l'action.

Il existe quatre types de déclencheurs logiques :

Type de déclencheur	Description	Exemple
Simple	Sélectionnez le type de déclencheur et la valeur que vous souhaitez utiliser dans votre logique.
Javascript	Vous fournissez une logique JavaScript pour un composant de formulaire ou des données de formulaire. Utilisez la syntaxe JavaScript pour créer une logique complexe, telle qu'une boucle ou un comportement dynamique.
Logique JSON	Vous fournissez une logique JSON pour un composant de formulaire ou des données de formulaire. Recommandé dans les cas où JavaScript n'est pas autorisé. Ne peut pas prendre en charge les boucles ou les comportements dynamiques.
Événement (Event)	Vous définissez un événement de composant qui, une fois émis par le composant correspondant, déclenche l'action souhaitée.

Action

L'action logique est le comportement du composant de formulaire qui doit se produire en fonction des conditions logiques que vous définissez (c'est-à-dire le déclencheur). Par exemple, vous souhaiterez peut-être activer un bouton pour les utilisateurs d'un âge spécifique. Dans ce cas, la tranche d’âge est le déclencheur, et l’activation du bouton est l’action.

Il existe quatre types d’actions logiques :

Type d'action	Description	Exemple
Propriété	Le déclencheur modifie l'une des propriétés de composant disponibles, telles que l'info-bulle, la description, la classe CSS, etc. Les propriétés disponibles dépendent du type de composant déclencheur.
Valeur (Value)	Le déclencheur modifie la valeur du composant correspondant. L'action doit être définie à l'aide de la syntaxe JavaScript.
Schéma des composants de la fusion	Le déclencheur modifie les paramètres de schéma de composant trouvés dans le composant JSON. Pour voir les paramètres de schéma que vous pouvez modifier, survolez le composant correspondant et cliquez sur Modifier le JSON ( Edit JSON). Vous pouvez modifier plusieurs paramètres en une seule action.
Action personnalisée	Vous définissez une action personnalisée à l'aide de la syntaxe JavaScript, de la même manière que vous définiriez le type de déclencheur JavaScript.	NA