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.

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 du Libellé devient la PropertyName dans l'onglet Clé du champ .
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é : position du libellé pour un champ.

Description : le texte qui apparaît au-dessous du champ d'entrée.

Info-bulle - Ajoute une icône d'info-bulle sur un côté de l'icône. Saisissez le texte de l'info-bulle.

Classe de CSS personnalisée : ajoutez une classe de CSS personnalisée au composant. Vous pouvez ajouter plusieurs classes, séparées par une espace.

Masqué : masque un composant lorsque vous affichez le formulaire.

Remarque :

Le composant s'affiche toujours dans le fichier JSON.

Masquer le libellé : masque le libellé d'un composant.

Désactivé : désactive un champ du formulaire.

Espace réservé : texte qui s'affiche lorsque le champ est vide.

Préfixe : le texte affiché avant un champ.

Suffixe - Texte affiché après un champ.

Unique - Lorsque cette option est cochée, le champ est considéré comme unique au formulaire.

Protégé : lorsque cette option est cochée, le champ est disponible pour l'entrée uniquement.

Persistance : 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 Persistance.

Vue de la table - Lorsque cette option est cochée, affiche la valeur dans la vue de la table des envois. Vous pouvez l'utiliser pour les composants enfants que vous ajoutez à l'intérieur des composants Modifier la grille , pour afficher les composants enfants à l'intérieur des lignes. Si cette option est laissée décochée, les données ne s'affichent pas dans la ligne réduite de l' activité Modifier la grille. Même si les données ne s'affichent pas, vous pouvez configurer un composant tout en modifiant une ligne.

Masque d'entrée Un masque d'entrée fournit un format prédéfini. Par exemple, pour un champ de numéro de téléphone, le masque d'entrée par défaut sera [phone].

Les éléments du masque de saisie sont :

• 9 – numérique
• a - Par ordre alphabétique
• * - alphanumérique

Données

Valeur par défaut : la valeur du champ avant que les utilisateurs n'interagissent avec elle. La valeur par défaut remplace le texte de l'espace réservé.

Valeurs multiples : lorsque cette option 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 est visible dans le champ.

Contenu : la section dans laquelle vous saisissez le contenu d'un composant.

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

Régénérer sur : régénérez ce composant si un autre composant du formulaire change. Choisissez l'événement où le composant doit être rafraîchi dans la liste déroulante. Les événements par défaut à choisir sont Toute modification et Soumettre.

Validation

Obligatoire - Lorsque cette case est cochée, ce champ doit avoir une valeur.

Valider le : détermine lorsque ce composant déclenche une validation du front-end. Choisissez un événement dans la liste déroulante : Modifier ou Flou.

Longueur minimale - La longueur minimale requise que ce champ doit respecter.

Longueur maximale : la longueur maximale requise que ce champ doit respecter.

Longueur minimale du mot : le nombre minimum de mots pouvant être ajoutés à ce composant.

Longueur maximale du mot : le nombre maximum de mots pouvant être ajoutés à ce champ.

Modèle d'expressions régulières : le modèle d'expression régulière que le composant doit définir 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 : lorsque cette option est cochée, effectue une vérification de validation pour s'assurer que la valeur sélectionnée est une option disponible.

Clé de champ

Nom de la propriété - Nom de l'argument correspondant pour un composant dans la collection d'arguments.

Vous pouvez utiliser le nom de propriété pour transmettre des arguments (à l'aide de l'activité Définir les valeurs du formulaire ) à l'intérieur du formulaire, ou pour obtenir des valeurs en dehors d'un formulaire (à l'aide de l'activité Obtenir les valeurs du formulaire ).

Conditionnel

L'onglet Conditionnel du Générateur de formulaires vous permet de placer des conditions sur les composants de votre formulaire, pour les masquer ou les afficher.

The Conditional tab has two sections:

• Simple
• Conditions avancées

Conditions simples

The Simple section of the Conditional tab allows you to hide or display a component, based on the value of another component.

The Simple section consists of three fields:

1. This component should Display - from this dropdown list, choose:

   • True if you want to condition when the component displays.
   • False if you want to condition when the component hides.

2. When the form component - from this dropdown list, choose a component in the form to act as a condition.

3. Has the value - type in the value that conditions the component when to display or hide.

   

Conditions avancées

La section Conditions avancées vous permet d'utiliser le code JavaScript ou la logique JSON pour effectuer des combinaisons de conditions.

Remarque :

La logique avancée remplace les résultats de la logique conditionnelle simple .

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

The show variable must be given a true or false value. The data variable is used to access other components in the form, through the API key.

Pour apprendre à utiliser des composants conditionnels, consultez la page Tutoriel sur les composants conditionnels .

Logique

L'onglet Logique 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 les 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 les données de formulaire. Recommandé dans les cas où JavaScript n’est pas autorisé. Impossible de 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 du composant disponibles, telles que Info-bulle, Description, 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 du composant trouvé dans le composant JSON. Pour voir les paramètres de schéma que vous pouvez modifier, survolez le composant correspondant et cliquez sur Modifier 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