Configurer les sous-formulaires

Lors de la configuration d'un module, après avoir cliqué sur le bouton "Configurer les sous-formulaires" dans le menu contextuel des options avancées, une nouvelle fenêtre apparait listant les sous-formulaires configurés sur le module.

Un sous-formulaire est un formulaire de création ou de modification spécifique qui permet de créer des alternatives au formulaire de création et modification par défaut du module. Qu'ils s'agissent de valeurs par défaut différentes ou de champs affichés différemment, les sous-formulaires sont la solution.

Par exemple, ils sont particulièrement utiles lorsque vous voulez créer un formulaire en réduisant drastiquement les champs modifiables. Un formulaire nommé "Changer le statut" pourrait permettre modifier uniquement le statut d'un client.

Création d'un sous-formulaire

Il est possible de configurer différents sous-formulaire sur un même module. 

Pour créer un sous-formulaire :

• Cliquer sur le bouton "Créer un sous-formulaire" situé en bas à gauche à la suite des sous-formulaires configurés ;
• Une nouvelle fenêtre apparaît ;
• Remplissez les informations comme expliqué ci-dessous ;
• Pour valider votre création, cliquez sur le bouton "Enregistrer" situé en bas à droite de la fenêtre.

Configurer un sous formulaire

Chaque sous-formulaire est configuré en remplissant les informations suivantes : 

• Nom : Le nom du sous-formulaire affiché dans le menu contextuel. Un menu déroulant est présent pour faciliter l'insertion de variables dynamiques ;
• Icône :  L'icône qui sera affichée avant le nom dans le menu contextuel ;
• Couleur : La couleur de fond qui sera affiché dans le menu contextuel ;
• Type d'ouverture : Ce menu déroulant propose 3 types de formulaire différents :
  • Création : Ce type est utilisé pour créer un élément. Choisir ce type fait apparaître les champs suivants :
    • Message de chargement : Ce message est affiché pendant le traitement du sous-formulaire.
    • Message de succès : Ce message sera affiché après le lancement du sous-formulaire.
  • Modification : Ce type est utilisé pour modifier un élément. Choisir ce type fait apparaître les champs suivants :
    • Ajouter des actions dans le formulaire : TODO
    • Ajouter d'autres formulaires en visualisation : TODO
  • Modification multiple : Ce type est utilisé pour modifier tous les éléments du module. Choisir ce type fait apparaître les champs suivants :
    • Message de confirmation : Ce message sera affiché avant la validation du sous-formulaire sous la forme d'une fenêtre. Si l'utilisateur valide alors les traitements auront lieu.
    • Message de succès : Ce message sera affiché à la validation du sous-formulaire.
  • Visualisation : Ce type est utilisé pour visualiser un élément. Choisir ce type fait apparaître les champs suivants :
    • Ajouter des actions dans le formulaire : TODO
    • Ajouter d'autres formulaires en visualisation : TODO
• Texte du bouton : Le texte qui sera affiché sur le bouton de validation du formulaire.
• Référence interne : Une référence unique pour le sous-formulaire. Si le champ n'est pas rempli, la référence sera générée automatiquement :
• Restreindre avec les règles : Ce menu déroulant contient les règles qui permettent d'activer le droit d'affichage du sous-formulaire dans le menu contextuel. Il suffit qu'une règle soit vraie pour que le droit soit autorisé ;
• Ne pas afficher dans le menu contextuel : Cette case à cocher permet d'afficher ou de masquer le sous-formulaire dans le menu déroulant ;
• Afficher les tabs : Cette case à cocher permet d'afficher ou de masquer les onglets dans le formulaire.

Configurer les champs

En cliquant sur bouton "Editer les champs" avec l'icône de roue cranté, la fenêtre permettant de choisir une configuration s'affiche. À la droite de chaque champ se trouve deux boutons : 

• Un bouton permettant de modifier l'affichage de ce champ dans le sous-formulaire :
  • Cacher par défaut : Le champ sera par défaut caché. Il pourra cependant être affiché via des règles ;
  • Ne pas afficher :  Le champ ne sera pas retourné par l'API. Il ne pourra pas être affiché via des règles ;
  • Afficher en édition : Le champ apparaîtra en édition et sera modifiable.
  • Afficher en visualisation : Le champ apparaîtra en mode visualisation et ne sera pas modifiable 
• Un bouton de configuration avec l'icône de roue cranté. Cliquez sur ce bouton affiche une nouvelle fenêtre permettant de remplir les informations suivantes :
  • Valeur forcée : Ce champ permet de choisir la valeur qui sera forcée à l'affichage du sous-formulaire. Dans le cas des champs textes, Un menu déroulant est présent pour faciliter l'insertion de variables dynamiques ; 
  • Garder la valeur par défaut du champ ? : Cette case à cocher permet d'outre-passer la valeur par défaut qui a été configurée sur le champ à l'étape 2.
  • Rendre de champ obligatoire ? : Ce menu déroulant permet de rendre le champ obligatoire pour ce sous-formulaire.