# Structure, sections et champs ## Structure du formulaire Un formulaire créé avec l’éditeur intégré dispose d’un en-tête, une ou plusieurs sections, un ou plusieurs champs par section, un bouton **Envoyer**, un bouton **Sauvegarder** optionnel et un pied de page.
{% hint style="info" %} Les attributs que vous définissez dans la section générale de la fenêtre de configuration de formulaire seront appliqués à toutes les sections. L'éditeur d’apparence propose ceux-ci ainsi que d'autres options de style (par exemple, la police et la taille du texte, les couleurs de fond, les styles de bordure, etc...) que vous pouvez personnaliser pour chaque élément de formulaire. Pour plus de renseignements, voir la section [Éditeur d'apparence](https://docs.workflowgen.com/admin-fr/8.3/formulaire/..#editeur-dapparence). {% endhint %} ### En-tête * L’en-tête comprend un titre, un libellé et une image en option.
* Le titre peut être utilisé pour afficher le nom du processus. Son texte peut être édité directement sur le formulaire.
* Le libellé est utilisé pour afficher le numéro de la demande actuelle. Son identifiant par défaut est `CURRENT_REQUEST` et peut être référencé dans un paramètre d’action pour recevoir la macro `Request.Id`.
* L’image est utilisée pour afficher un logo. Elle peut être redimensionnée ou réalignée dans la fenêtre de configuration du formulaire (**Général / En-tête**).
* Une largeur et une hauteur fixe peuvent être réglées pour l’en-tête. ### Section * Une section comprend un titre pour afficher le nom de la section. Son texte peut être édité directement sur le formulaire.
* Il peut avoir un ou plusieurs champs.
* Chaque section doit avoir un identifiant unique.
* Les sections peuvent seulement être alignées verticalement et réorganisées en utilisant le glisser-déplacer avec la souris.
* Lors de l’insertion d’une section sur le formulaire, la nouvelle section sera placée en dernière position.
* Les sections seront redimensionnées automatiquement en fonction du plus grand champ sur le formulaire chaque fois qu’il y a un changement d’une largeur de champ.
* Une largeur fixe peut être définie globalement pour les sections dans la configuration du formulaire (**Général / Sections**).
* Les paramètres de la section peuvent être édités en utilisant l’icône crayon sur le côté droit du nom de la section. ### Champs * Un champ comprend un libellé et un contrôle de saisie.
* Le libellé est utilisé pour afficher le nom du champ. Son texte peut être édité directement sur le formulaire. Il peut être redimensionné et réaligné.
* Une largeur fixe peut être définie globalement pour tous les libellés dans la configuration du formulaire (**Général / Libellés**).
* Le contrôle de saisie permet de capturée une valeur sur le formulaire. Il peut être redimensionné et réaligné.
* Chaque champ doit avoir un identifiant unique.
* Tous les champs dans la même section sont préfixés avec l'identifiant de la section suivi par une barre de soulignement.
* Les champs d’une section peuvent êtres réorganisés verticalement en utilisant le glisser-déplacer avec la souris.
* Un champ peut être déplacé d'une section à une autre en utilisant le glisser-déplacer avec la souris.
* Lors de l’insertion d'un outil de champ dans le formulaire, le nouveau champ sera placé dans la dernière position de la section sélectionnée ou la première section si aucune section n’a été choisie.
* Par défaut, les champs sont alignés verticalement sur la même colonne.
* Plusieurs champs peuvent être alignés horizontalement (sur la même ligne) en utilisant le bouton **Retirer le saut de ligne** (flèche vers la gauche) sur le côté droit du premier champ.
* Plusieurs champs peuvent être alignés verticalement en utilisant le bouton **Insérer un saut de ligne** (flèche vers la droite) sur le côté droit du premier champ.
* Les paramètres du champ peuvent être édités en utilisant l’icône crayon sur le côté droit du champ. ### Boutons * Les boutons **Soumettre** et **Enregistrer** peuvent être renommés dans la configuration du formulaire (**Général / Boutons**).
* Le bouton **Enregistrer** peut être activé ou désactivé.
* Leur identifiants sont `submitButton` et `saveAsDraftButton` respectivement ### Pied de page * Le pied de page comprend un libellé et une image en option.
* Le libellé peut être utilisé pour afficher une note. Son texte peut être édité directement sur le formulaire.
* L’image est utilisée pour afficher un logo. Elle peut être redimensionnée ou réalignée dans la configuration du formulaire (**Général / Pied de page**).
* Une largeur et une hauteur fixe peuvent être définies pour le pied de page. {% hint style="info" %} Pour modifier la feuille de style et autres attributs (en-tête, image, pied de page, textes, etc...) au moment de l'exécution du formulaire vous pouvez ajouter le code .NET suivant : ```csharp protected void Page_Load(object sender, EventArgs e) { base.Page_Load(sender, e); String stylePath=HttpContext.Current.Request.PhysicalApplicationPath.Replace("WfApps\\WebForms\\","App_Data\\Templates\\Forms\\En\\Default\\css"); Page.Header.Controls.Remove(this.FindControl("StyleSheet")); Page.Header.Controls.Add( new LiteralControl( System.IO.File.ReadAllText(stylePath + "\\" + "metal.css") ) ); string imageUrl="http://mywebsite/mylogo.jpg" HeaderImage.Style["background-image"] = "url('" + imageUrl+ "')"; HeaderTitleLabel.Text="My Title #"; FooterTitleLabel.Text="My footer"; imageUrl="http://mywebsite/myfooter.jpg"; FooterImage.Style["background-image"] = "url('" + imageUrl+ "')"; } ``` Cet exemple remplace les éléments suivants : * La feuille de style par la feuille de style nommée `metal.css`
* Le titre de l’en-tête
* L’image de l’en-tête
* Le titre du pied de page
* L’image du pied de page {% endhint %} {% hint style="info" %} Vous pouvez avoir besoin de modifier la largeur et la hauteur dans le code .NET si vous changez d’image. #### 📌 Exemple : ``` FooterImage.Style["width"] = "200px"; FooterImage.Style["height"] = "100px"; ``` Il est recommandé d’utiliser des adresses absolues pour les différentes ressources (images, CSS, etc...) de manière à ce que les copies comme le « Form Archive » puissent les afficher indépendamment de leur localisation (ex. : email de notification). {% endhint %} ## Sections et champs de formulaire ### Outils | **Nom** | **Description** | | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Gérer les outils personnalisés | Ouvre la fenêtre Gérer les outils personnalisés | | Sections personnalisées |

Liste de modèles de sections personnalisées

Un modèle de section personnalisée peut être créé en sauvegardant une section en tant qu’outil ou manuellement sur le serveur avec le dossier et structures de fichiers suivante : \wfgen\App\_Data\Templates\Forms\[langue]\[nom du dossier]\sections\[nom de la section].txt
📌 Exemple : \wfgen\App\_Data\Templates\Forms\FR\MonEntreprise\sections\MaSection.txt

✏️ Note : Un modèle de section personnalisée doit se conformer à la structuration des contenus et les règles utilisées et connues par l’éditeur de formulaire. Ceci est destiné aux utilisateurs avancés.

| | Champs personnalisés |

Liste des modèles de champs personnalisés

Un modèle de champ personnalisé peut être créé en sauvegardant un champ en tant qu’outil ou manuellement sur le serveur avec le dossier suivant et structures de fichiers suivantes : \wfgen\App\_Data\Templates\Forms\[langue]\[nom du dossier]\fields\[nom du champ].txt
📌 Exemple : \wfgen\App\_Data\Templates\Forms\Fr\MonEntreprise\fields\MonChamp.txt

✏️ Note : Un modèle de champ personnalisé doit se conformer à la structuration des contenus et les règles utilisées et connues par l’éditeur du formulaire. Ceci est destiné aux utilisateurs avancés.

| | **Sections par défaut** | | | Validation |



Une section qui contient un prénom, nom, et champ de date en lecture seule, ainsi qu’un bouton radio d’approbation et un champ texte multi-lignes pour commentaires.

| | Vide |



Une section qui n’a pas de champs

| | Demande |



Une section qui contient un prénom, nom, et champ de date en lecture seule, ainsi qu’une liste déroulante de catégories et un champ texte multi lignes pour description.

| | Standard |



Une section qui contient un prénom, nom et champ de date en lecture seule

| | **Champs par défaut** | | | Pièce jointe |



Joindre un fichier

| | Case à cocher |


Case à cocher

| | Case à cocher – liste |



Plusieurs cases à cocher en alignement horizontal

| | Case à cocher – liste verticale |



Plusieurs cases à cocher en alignement horizontal

| | Monétaire |



Contrôle pour saisir une valeur monétaire

| | Date |



Contrôle pour saisir une valeur date

| | Date heure |



Contrôle pour saisir une valeur date et heure

| | Liste déroulante |


Liste des éléments pour une sélection de choix unique

| | Tableau |



Tableau dynamique de champs de saisie; chaque colonne représente un champ et chaque ligne représente un enregistrement.

| | Libellé |



Texte affiché en lecture seule

| | Liste |



Liste des éléments pour une sélection multiple

| | Numérique |



Contrôle pour saisir une valeur numérique

| | Mot de passe |



Contrôle pour saisir un mot de passe (le texte saisi sera masqué)

| | Bouton radio |


Bouton radio

| | Bouton radio – liste |



Plusieurs boutons radio en alignement horizontal

| | Bouton radio – liste verticale |



Plusieurs boutons radio en alignement vertical

| | Monétaire – lecture seule |



Valeur monétaire en lecture seule

| | Date – lecture seule |



Valeur date en lecture seule

| | Date heure – lecture seule |



Valeur date/heure en lecture seule

| | Numérique – lecture seule |



Valeur numérique en lecture seule

| | Texte – lecture seule |



Valeur texte en lecture seule

| | Texte multi-lignes |



Zone de texte multi-ligne

| | Texte |



Zone de texte uni-ligne

| ### Enregistrement d’une section ou d’un champ comme outil Cette fonctionnalité vous permet d'enregistrer une section ou un champ existant en tant que champ ou section personnalisé réutilisable dans le formulaire actuel et dans d'autres formulaires. Tout d'abord, sélectionnez une section ou un champ, puis cliquez sur l'icône **Sauvegarder une section ou un champ en tant qu’outil** dans la barre d'outils.
| **Champs** | **Description** | | --------------------------- | ---------------------------------------------------------------------- | | **Enregistrer comme outil** | | | Nom | Entrez un nom unique pour l'outil personnalisé | | Outils | Sélectionnez un outil existant dans la liste déroulante pour l'écraser | ### Gestion des outils personnalisés Sélectionnez **Gérer les outils personnalisés** depuis la liste déroulante **Outils**.
| **Nom / Icône** | **Description** | | -------------------------------------------------------------------------------------------------------------- | --------------------------------------- | | **Sections** | | | Nom | Nom de l'outil de section personnalisé | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/iX3L5KCNIsaD1gI1gOpn/delete_icon_12x11.png) | Supprimer l'outil de champ personnalisé | | **Champs** | | | Nom | Nom de l'outil de champ personnalisé | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/yWwf7lOIYqddUDvk8I6x/delete_icon_12x11.png) | Supprimer l'outil de champ personnalisé | ### Paramètres de section | **Nom / Icône** | **Description** | | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/tNihgc4pBTTOYN3MvJTd/checkmark_icon_12x10.png) | Fermer et appliquer les modifications au champ | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/SKGJNe6sxObQOZPkrENB/close_icon_12x11.png) | Fermer et annuler les modifications au champ | | **Validation** | | | **Comportement** | ✏️ **Note :** Pour aider à la saisie de la condition, une liste exhaustive des champs du formulaire et une liste d’opérateurs sont proposées dans les menus déroulants **Sélectionner un champ** et **Sélectionner un opérateur**. Vous pouvez également appuyer sur **`Ctrl+Espace`** pour afficher un menu déroulant qui contient les variables et mots-clés disponibles. | | Requise | Définit les champs de la section comme obligatoire | | Condition |

Les champs des sections obligatoires sont basés sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# du côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

| | En lecture seule | Définit les champs de la section en lecture seule | | Condition |

Les champs de la section en lecture seule sont basés sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

| | Caché | Définit les champs de la section comme champs cachés | | Condition |

Les champs de la section cachés sont basés sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

| ### Paramètres de la pièce jointe
| **Nom / Icône** | **Description** | | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/5wj9qWVX3EYdvgv7raK5/checkmark_icon_12x10.png) | Fermer et appliquer les modifications au champ | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/I2vuRuzKySxdjM6hohu3/close_icon_12x11.png) | Fermer et annuler les modifications au champ | | **Comportement** | | | WorkflowFileUpload | Cochez pour activer l'utilisation du contrôle WorkflowFileUpload. Sinon, le FileUpload .NET v2.0 est utilisé par défaut. | | Lien de téléchargement | Vérifier si vous voulez le lien pour ouvrir le fichier permis | | Afficher la taille de fichier | Affiche la taille du fichier téléchargé à côté du lien de téléchargement | | Limite de taille du fichier (ko) | Définit la taille maximale du fichier téléchargé (ko) | | Message d'erreur de restriction de taille | Le message d'erreur qui s'affiche lorsque la taille maximale du fichier est dépassée | | Extensions autorisées | Limite les types de fichier autorisés par extensions séparées par des virgules (ex. : `txt,doc,html,xml,png`) | | Extensions interdites | Liste d'extensions de fichier interdites pour les liens | | Message d'erreur de restriction d'extension | Le message d'erreur qui s'affiche lorsque l'extension de fichier erreur se produit | | Message d'erreur de fichier vide | Le message d'erreur qui s'affiche quand il n'y a pas de fichier auquel créer un lien | | Libellé du bouton ajout | Le texte d'affichage pour le bouton d'ajout | | Libellé du bouton de suppression | Le texte d'affichage pour le bouton de suppression | | Libellé du bouton de mise à jour | Le texte d'affichage pour le bouton de mise à jour | | Libellé du bouton de remplacement | Vous permet de choisir un nouveau fichier | | Mode d'affichage |

Définit le mode d'affichage par défaut :

| | Lien de téléchargement | Cochez la case pour afficher un lien pour télécharger le fichier téléchargé fourni | | **Validation** | | | **Comportement du champ** | ✏️ **Note :** Pour aider à la saisie de la condition, une liste exhaustive des champs du formulaire et une liste d’opérateurs sont proposées dans les menus déroulants **Sélectionner un champ** et **Sélectionner un opérateur**. Vous pouvez également appuyer sur **`Ctrl+Espace`** pour afficher un menu déroulant, qui propose les variables et mots-clés disponibles. | | Requis | Définit le champ comme champ obligatoire | | Condition | Le champ obligatoire est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur. | | Lecture seule | Définit le champ en lecture seule | | Condition | Le champ en lecture seule est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur. | | Caché | Définit le champ comme champ caché | | Condition | Le champ caché est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur. | | **Attributs personnalisés** | | | Nom |

Tout nom qui n'est pas dans la liste du nom de l'attribut standard réservé (id, name, class, style, title, multiple, type, value, checked, runat)

Tout autre nom additionnel de l'attribut réservé spécifique au Fichier joint / Comportement : workflowfileupload, addtext, deletetext, updatetext, allowedextensions, displaymode, downloadlink, filesizelimit, showfilesize

Une liste d’exemples d’attributs personnalisés est proposée au début de l’onglet. Vous avez la possibilité d’en choisir un ou d’entrer un nom spécifique.

| | Valeur | Toute valeur | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/n98pVNOytpKX7E2ywQfQ/add_icon_12x12.png) | Ajouter un nouvel attribut | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/W4xWYSPi9IIkpJ5GQlLr/delete_icon_12x11.png) | Supprimer l'attribut actuel | ### Paramètres des cases à cocher et boutons de radio Ces paramètres s'appliquent aux champs de type : case à cocher – liste, case à cocher – liste verticale, bouton de radio – liste et bouton de radio – liste verticale.
| **Nom / Icône** | **Description** | | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/VQrNYyABM02B4SJ6xFm6/checkmark_icon_12x10.png) | Fermer et appliquer les modifications au champ | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/ZTx83Ym5YjzAebwe0NLP/close_icon_12x11.png) | Fermer et annuler les modifications | | **Éléments** | | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/WV33IETuNiMEAMJlvX1w/dragdrop_icon_12x15.png) | Utilisez le glisser-déplacer avec la souris pour changer l'ordre des éléments. | | Sélectionné | Cochez les éléments sélectionnés par défaut pour le champ. Une seule sélection est supportée pour un bouton radio alors qu’une case à cocher supporte plusieurs sélections. | | Valeur | Valeur de la case à cocher/bouton radio | | Libellé | Le texte d'affichage de case à cocher/bouton radio | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/QT3rZkPqBTYxgmONhC18/add_icon_12x12.png) | Ajouter une nouvelle case à cocher/bouton radio | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/HATXIcaJrHpQop59uQGb/delete_icon_12x11.png) | Supprimer la case à cocher/bouton radio actuelle | | **Validation** | | | **Comportement du champ** | ✏️ **Note :** Pour aider à la saisie de la condition, une liste exhaustive des champs du formulaire et une liste d’opérateurs sont proposées dans les menus déroulants **Sélectionner un champ** et **Sélectionner un opérateur**. Vous pouvez également appuyer sur **`Ctrl+Espace`** pour afficher un menu déroulant qui contient les variables et mots-clés disponibles. | | Requis | Définit le champ comme champ obligatoire | | Condition |

Le champ obligatoire est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

✏️ Note : Les champs de type case à cocher (liste ou unique) et bouton de radio unique ne sont pas supportés par ce comportement.

| | Lecture seule | Définit le champ en lecture seule | | Condition |

Le champ en lecture seule est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

| | Caché | Définit le champ comme champ caché | | Condition |

Le champ caché est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

| | **Attributs personnalisés** | | | `aslist` |

Cette propriété permet à un champ de type bouton radio ou case à cocher avec un item d’être converti en liste de contrôle (bouton radio liste/case à cocher liste) au lieu d’un contrôle de bouton radio/case à cocher dans le formulaire web.

Valeurs booléennes acceptées : true ou false

| ### Paramètres des textes Ces paramètres s'appliquent aux champs suivants : monétaire, date, date heure, numérique, mot de passe, texte multi-lignes.
| **Nom / Icône** | **Description** | | ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | Fermer et appliquer les modifications au champ | | | Fermer et annuler les modifications au champ | | **Validation** | | | **Comportement du champ** | ✏️ **Note :** Pour aider à la saisie de la condition, une liste exhaustive des champs du formulaire et une liste d’opérateurs sont proposées dans les menus déroulants **Sélectionner un champ** et **Sélectionner un opérateur**. Vous pouvez également appuyer sur **`Ctrl+Espace`** pour afficher un menu déroulant qui contient les variables et mots-clés disponibles. | | Longueur maximale |

Le nombre maximum de caractères pouvant être saisis

✏️ Note : Maintenant aussi disponible pour le champ texte multi-lignes.

| | Requis | Définit le champ comme champ obligatoire | | Condition |

Le champ obligatoire est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

| | Lecture seule | Définit le champ en lecture seule | | Condition |

Le champ en lecture seule est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

| | Caché | Définit le champ comme champ caché | | Condition |

Le champ caché est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

| | **Expression régulière** | | | Expression |

Une expression régulière pour déterminer la validité
📌 Exemple : adresse courriel : \b\[A-Za-z0-9.\_%+-]+@\[A-Za-z0-9.-]+.\[A-Za-z]{2,4}\b

Une expression régulière peut être saisie librement dans la zone à cet effet. Il est également possible d’utiliser une expression régulière dans la liste Sélectionner une expression régulière.

| | Message d'erreur | Message à afficher lorsque la valeur du champ n'est pas valide | | **Plage de valeurs** | | | Valeur minimum | Valeur minimum pour le champ en cours de validation | | Valeur maximum | Valeur maximum pour le champ en cours de validation | | Message d'erreur | Message à afficher lorsque la valeur du champ n'est pas valide | | **Personnalisé** | | | `OnServerValidate` | Code de validation de syntaxe C# côté serveur. La valeur de retour doit être une valeur booléenne (vraie ou fausse) | | Valider les textes vides | Cochez pour valider le texte d'un contrôle même si le texte est vide | | Message d'erreur | Message à afficher lorsque la valeur du champ n’est pas valide | | **Comparaison** | | | Valeur à comparer | Valeur à comparer | | Champ à comparer | Sélectionnez un autre champ du formulaire en comparaison | | Opérateur |

Opération comparaison à appliquer aux valeurs :

| | Message d'erreur | Message à afficher lorsque la valeur du champ n’est pas valide | | **Attributs personnalisés** | | | `timezoneconversion` |

Applicable seulement aux champs de types Date et Date Heure

Cette propriété permet de désactiver le comportement de conversion du fuseau horaire de l’utilisateur quand le format du champ du formulaire est Date ou Date Heure.

Cette fonctionnalité est utile si vous voulez enregistrer et maintenir une valeur unique de date cohérente et des données du processus sans appliquer la conversion de fuseau horaire qui change parfois la valeur de la date dépendamment du fuseau horaire original et des fuseaux horaires des utilisateurs.

Valeurs booléennes acceptées : true ou false

| | Tout autre nom additionnel spécifique de l'attribut à la validation | `maxlength`, `requiredcondition`, `readonlycondition`, `hiddencondition`, `validationexpression`, `regularexpressionerrormessage`, `minimumvalue`, `maximumvalue`, `rangeerrormessage`, `onservervalidate`, `validateemptytext`, `customerrormessage`, `valuetocompare`, `controltocompare`, `operator`, `compareerrormessage` | ### Paramètres des listes et des listes déroulantes Ces paramètres (exception aux éléments) s'appliquent aux champs suivants : libellé, monétaire - lecture seule, date – lecture seule, date heure – lecture seule, numérique – lecture seule, texte – lecture seule.
| **Nom / Icône** | **Description** | | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/dBaYvxrz25PiXxdLS3z9/checkmark_icon_12x10.png) | Fermer et appliquer les modifications au champ | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/lpeexlCsO3pIyg3zGalR/close_icon_12x11.png) | Fermer et annuler les modifications au champ | | **Élément** | | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/OnIh31k7oNC0g1TSl4UH/dragdrop_icon_12x15.png) | Utilisez le glisser-déplacer de la souris pour changer l'ordre des éléments | | Sélectionné |

Cochez les éléments sélectionnés par défaut pour le champ

Une seule sélection est supportée pour une liste déroulante. Les listes supportent plusieurs sélections.

| | Valeur | Valeur de l'élément | | Libellé | Texte d'affichage de l'élément | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/lg8bDaNqq0GJxrzXEQnZ/add_icon_12x12.png) | Ajouter un nouvel élément | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/GW0436Q15yLdiyeiJ2XY/delete_icon_12x11.png) | Supprimer un élément | | Liaison de données | | | Connexion | Sélectionnez le type de connexion pour la liaison de données : | | **Connexion par nom** | | | Nom |

Liste des noms de connexion définis dans le fichier de la configuration Web WorkflowGen (\)

✏️ Note : Il est fortement recommandé d'utiliser un nom de connexion plutôt qu'une chaîne de connexion pour simplifier la gestion multi-environnements. Les noms de connexion sont gérés de manière centralisée dans le fichier web.config de WorkflowGen.

| | Requête SQL Select |

Requête SQL Select
📌 Exemple : select column\_id, column\_text from table\_name;

| | Champ de valeur de données |

Le champ de données qui fournit la valeur de l'élément
📌 Exemple : column\_id

| | Champ de texte de données |

Le champ de données qui fournit le texte de l'élément
📌 Exemple : column\_text

| | Ajout des données liées | Cochez pour ajouter les éléments de données liés à la liste. Sinon, les données liées vont remplacer tous les éléments existants dans la liste. | | **Paramètres** | | | Nom |

Indique le nom du paramètre si la commande « Select » utilise un filtre avec une valeur dynamique à partir d'un paramètre.
📌 Exemple : Nom=PARAM; Select command=select column\_id, column\_text from table\_name where column\_id > @PARAM

| | Type de données | Spécifie le type de données du paramètre : `Boolean`, `Byte`, `Char`, `DateTime`, `DBNull`, `Decimal`, `Double`, `Empty`, `Int16`, `Int32`, `Int64`, `Object`, `SByte`, `Single`, `String`, `UInt16`, `UInt32`, `UInt64` | | Filtrer par domaine | Spécifie un autre champ dans la forme actuelle où la valeur dynamique sera récupérée | | Valeur de filtre par défaut | Indique la valeur par défaut si le champ de paramètre a un vide valeur ou pas de valeur | | Si la valeur est vide | Sélectionnez l'une des opérations suivantes : | | **Connexion par chaîne** | | | Chaîne |

Spécifie la chaîne de connexion
📌 Exemple : Data Source=sqlserver\_name;Initial Catalog=wfgen;User ID=wfgen\_user;Password=abc123!;

| | Nom du fournisseur |

Liste des noms de fournisseurs définis dans le fichier de la configuration Web WorkflowGen (AdministrationFormDataProviderName). Il supporte également des fournisseurs personnalisés tiers .NET :

| | Requête SQL Select, Champ de valeur de données, Champ de texte de données, Ajout des données liées, Paramètre (Nom, Champ, Valeur par d/faut, Type de données) | Idem que la connexion par nom | | **Connexion par listes globales** | | | Nom de la liste | Spécifie le nom de la liste | | Colonne de valeur | Sélectionne la colonne utilisée pour la valeur de l’élément | | Colonne de texte | Sélectionne la colonne utilisée pour le libellé de l’élément | | Trier par la colonne | Sélectionne la colonne utilisée pour trier la liste | | Ajouter des données liées | Ajoute aux données saisies les données liées à la liste. Sinon, les données liées remplaceront tous les éléments existants dans la liste | | **Filtre** | | | Colonnes | Spécifie le nom de la colonne utilisée pour filtrer les données | | Opérateur de comparaison | Égal (`=`), non égal (`<>`), supérieur (`>`), supérieur ou égal (`>=`), inférieur (`<`), inférieur ou égal (`<=`), contient, commence par, finit par, est nul, n'est pas nul, est dans, n'est pas dans, entre | | Filtrer par le champ | Sélectionne le champ du formulaire qui contient la valeur du filtre | | Valeur par défaut du filtre | La valeur par défaut si le champ est vide | | Si la valeur est vide | Définit le comportement du filtre si la valeur est vide | | **Connexion par XML** | | | XML |

Indique le nom du fichier XML pour la liaison de données
📌 Exemples :

Le fichier XML doit être structuré de telle sorte que les propriétés de chaque élément sont exprimés sous forme d’attributs. Si vous avez un fichier XML dans lequel les valeurs de propriété sont exprimées dans un format autre que les attributs, vous devez :

| | XPath | Indique l’expression XPath applique aux données XML dans le fichier XML, ex. : `rss/channel/item` | | Fichier de transformation XSL |

Indique le nom du fichier de XSL (Extensible Stylesheet Language) qui définit une transformation XSLT pour être exécutée sur le fichier XML
📌 Exemple : c:\monfichier.xsl

| | Champ de valeur de données, Champ de texte de données, Ajout des données liées | Idem que la connexion par nom | | **Connexion par SharePoint (2007 et 2010)** | ✏️ **Note :** Les paramètres du fichier config doivent être réglés pour détecter SharePoint pour activer cette option. | | URL |

Adresse URL de la liste SharePoint
📌 Exemple :

| | Nom de la liste |

Nom de la liste SharePoint
📌 Exemple : Pays

| | Champ de valeur de données |

Nom de colonne représentant la valeur de l'élément
📌 Exemple : Id\_Pays

| | Champ de texte de données |

Nom de colonne représentant le texte de l'élément
📌 Exemple : Description

| | Validation | | | **Comportement du champ** | ✏️ **Note :** Pour aider à la saisie de la condition, une liste exhaustive des champs du formulaire et une liste d’opérateurs sont proposées dans les menus déroulants **Sélectionner un champ** et **Sélectionner un opérateur**. Vous pouvez également appuyer sur **`Ctrl+Espace`** pour afficher un menu déroulant qui contient les variables et mots-clés disponibles. | | Longueur maximale |

Le nombre maximum de caractères qui peuvent être saisis

✏️ Note : Non disponible pour le champ TextArea.

| | Requis | Définit le champ en lecture seule | | Condition |

Le champ obligatoire est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

| | Lecture seule | Définit le champ en lecture seule | | Condition |

Le champ en lecture seule est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

| | Caché | Définit le champ comme champ caché | | Condition |

Le champ caché est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur.
📌 Exemple : MonTextBox.Text == "Bonjour !"

| | **Attributs personnalisés** | | | `timezoneconversion` |

Applicable seulement aux champs de types Date et Date Heure

Cette propriété permet de désactiver le comportement de conversion du fuseau horaire de l’utilisateur quand le format du champ du formulaire est Date ou Date Heure.

Cette fonctionnalité est utile si vous voulez enregistrer et maintenir une valeur unique de date cohérente et des données du processus sans appliquer la conversion de fuseau horaire qui change parfois la valeur de la date dépendamment du fuseau horaire original et des fuseaux horaires des utilisateurs.

Valeurs booléennes acceptées : true ou false

| | Tout autre nom additionnel spécifique de l'attribut réservé à la liaison de données | `connectionname`, `connectionstring`, `providername`, `xmldatasource`, `xpath`, `transformfile`, `selectcommand`, `parametername`, `parametercontrolid`, `parameterdefaultvalue`, `parametertype`, `datavaluefield`, `datatextfield`, `appenddatabounditems`, `spsdatasource`, `spsdatalist`, `spsdatavaluefield`, `spsdatatextfield` | ### Paramètres de tableau
| **Nom / Icône** | **Description** | | ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/GqWTEc853Y0PbYEJRcGL/checkmark_icon_12x10.png) | Fermer et appliquer les modifications au champ | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/RA9cZ83sAYS5Q8EVHsUx/close_icon_12x11.png) | Fermer et annuler les modifications | | **Colonnes** | | | | Utilisez le glisser-déplacer avec la souris pour changer l'ordre des colonnes | | Texte d’en-tête | Texte d’affichage de l’en-tête des colonnes. | | Type de champ |

Liste des types de champ supportés dans le tableau :

✏️ Notes :

| | Texte de pied de page |

Texte d’affichage du pied de page de la colonne

Le texte de pied de page de la colonne peut être un texte ou une expression utilisée pour filtrer les lignes, calculer les valeurs d'une colonne, ou créer une colonne agrégat (ex. : calculer la somme de toutes les valeurs d’une rangée d'une colonne donnée : =SUM)

Pour plus renseignements, référez-vous à DataColumn.Expression au site Microsoft :

| | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/6J1uv78THs0Kh1Ygq1qw/add_icon_12x12.png) | Ajouter une nouvelle colonne | | ![](https://content.gitbook.com/content/PlViTOMacIaoUEvBZ6XM/blobs/guEWYT3xjBihO1dzUtA1/delete_icon_12x11.png) | Supprimer la colonne actuelle | | **Affichage** | | | Libellé du bouton d'édition | Le texte d'affichage pour le bouton d'édition | | Libellé du bouton de suppression | Le texte d'affichage pour le bouton de suppression | | Libellé du bouton de mise à jour | Le texte d'affichage pour le bouton de mise à jour | | Libellé du bouton annuler | Le texte d'affichage pour le bouton annuler | | Afficher le bouton d'édition | Cocher pour afficher le bouton d'édition | | Afficher le bouton de suppression | Cocher pour afficher le bouton de suppression | | Afficher l'en-tête | Cocher pour afficher l'en-tête | | Afficher le pied de page | Cocher pour afficher le pied de page | | **Validation** | | | **Comportement du champ** | ✏️ **Note :** Pour aider à la saisie de la condition, une liste exhaustive des champs du formulaire et une liste d’opérateurs sont proposées dans les menus déroulants **Sélectionner un champ** et **Sélectionner un opérateur**. Vous pouvez également appuyer sur **`Ctrl+Espace`** pour afficher un menu déroulant qui contient les variables et mots-clés disponibles. | | Requis | Définit le champ comme champ obligatoire | | Condition | Le champ obligatoire est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur (ex.  `MonTextBox.Text == "Bonjour !"`). | | Lecture seule | Définit le champ en lecture seule | | Condition | Le champ en lecture seule est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur (ex. : `MonTextBox.Text == "Bonjour !"`). | | Caché | Définit le champ comme champ caché | | Condition | Le champ caché est basé sur une condition personnalisée. Si la condition est vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté serveur (ex. : `MonTextBox.Text == "Bonjour !"`). | | | Tout autre nom additionnel spécifique de l'attribut réservé au tableau / affichage  : `edittext`, `deletetext`, `updatetext`, `showheader`, `showfooter` | ### Outil de contrôle d'utilisateur ASP.NET L’éditeur de formulaire supporte les outils de champ personnalisé. Ceci est un contrôle d’utilisateur ASP.NET. Vous pouvez créer cet outil et le déployer manuellement sur le serveur. Il doit avoir les structures des éléments, de dossiers et de fichiers suivants : * Le gabarit du contrôle d’utilisateur : \ \ `\wfgen\App_Data\Templates\Forms\[langue]\[nom du dossier]\fields\[nom du contrôle d’utilisateur].txt`
* Les fichiers sources du contrôle d'utilisateur :
* ASCX : `\wfgen\WfApps\WebForms\[nom du contrôle d’utilisateur].ascx` * Code-behind : `\wfgen\WfApps\WebForms\[nom du contrôle d’utilisateur].ascx.cs` Quand vous entrez une balise, le champ de contrôle d'utilisateur insère automatiquement sa balise fermante. Pour écrouler un bloc de code, cliquez la flèche vers le bas, qui ensuite insérera une icône double-flèche à la place du code. Pour élargir un bloc de code, cliquez sur la flèche droite. Appuyez sur **`Ctrl+Espace`** pour afficher une liste déroulante qui contient les variables et mot-clés disponibles. Le champ de contrôle utilisateur supporte les paramètres personnalisés des attributs (voir [Paramètres de la pièce jointe](https://docs.workflowgen.com/admin-fr/8.3/formulaire/..#parametres-de-la-piece-jointe)). ### Édition d’identifiant Le menu **Id** dans la barre d'outils vous permet de modifier l'identifiant des sections et des champs. Vous pouvez modifier l'identifiant du libellé de l'en-tête, des sections et des champs. Les identifiants sont normalement utilisés pour identifier un élément du formulaire comme une section ou un champ d'action dans les paramètres de WorkflowGen (par exemple `FORM_FIELDS_REQUIRED`) ou dans le formulaire ASP.NET code-behind. #### Règles * Chaque identifiant doit être unique
* Il doit commencer par une lettre
* Il ne peut contenir que des caractères alphanumériques et des caractères de soulignement
* Il est sensible à la casse
* Chaque champ dans une section sera automatiquement préfixé avec l’identifiant de la section suivi d’une barre de soulignement (ex. : `section id=ACTION1; field id=ACTION1_MYFIELD1`)
* Chaque champ dans un tableau sera automatiquement préfixé avec identifiant du tableau suivi d’une barre de soulignement (ex. : identifiants du champ et du tableau : `gridview id=ACTION1_MYGRIDVIEW1; field id=ACTION1_MYGRIDVIEW1_TITLE1`).
* Si le champ est déplacé d'une section à une autre section, l’identifiant du champ sera automatiquement préfixé avec l’identifiant de la nouvelle section.
* Si l'identifiant de la section est modifié tous les identifiants des champs de la section sera automatiquement préfixé avec le nouvel identifiant. {% hint style="info" %} Une infobulle avec l’identifiant complet/réel du champ sera affichée lorsque vous déplacez le pointeur de la souris sur l’entrée de l’identifiant. {% endhint %} ### Édition de l’infobulle Le menu **Infobulle** dans la barre d'outils vous permet de modifier les infobulles. Vous pouvez modifier seulement les info-bulles des champs du formulaire. Les infobulles sont normalement utilisés pour afficher plus d'informations sur le champ lorsque l'utilisateur déplace le pointeur de la souris sur le champ. ### Édition du format Le menu **Format** dans la barre d'outils vous permet de modifier le format des champs. Vous pouvez modifier le format des types de champs suivant : texte, monétaire, date, date heure, numérique, libellé, monétaire en lecture seule, date en lecture seule, date heure en lecture seule, numérique en lecture seule, texte en lecture seule. Les formats sont normalement utilisés pour spécifier la façon de saisir et d'afficher une valeur spécifique basée sur la langue de l'utilisateur et de la culture. | **Type de format** | **Description** | | ----------------------------------------- | ----------------------------------------------------------------- | | Numérique | La valeur est numérique | | Monétaire | La valeur est monétaire | | Date et heure (système) | Date et heure par défaut de WorkflowGen | | Date courte | 6/10/2019 1:45:30 PM ➞ `6/10/2019` (en-US) | | Date longue | 6/10/2019 1:45:30 PM ➞ `Monday, June 10, 2019` (en-US) | | Heure courte | 6/10/2019 1:45:30 PM ➞ `1:45 PM` (en-US) | | Heure longue | 6/10/2019 1:45:30 PM ➞ `1:45:30 PM` (en-US) | | Date/heure complète (heure courte) | 6/10/2019 1:45:30 PM ➞ `Monday, June 10, 2019 1:45 PM` (en-US) | | Date/heure complète (heure longue) | 6/10/2019 1:45:30 PM ➞ `Monday, June 10, 2019 1:45:30 PM` (en-US) | | Date/heure générale (heure courte) | 6/10/2019 1:45:30 PM ➞ `6/10/2019 1:45 PM` (en-US) | | Date/heure générale (heure longue) | 6/10/2019 1:45:30 PM ➞ `6/10/2019 1:45:30 PM` (en-US) | | Mois/jour | 6/10/2019 1:45:30 PM ➞ `June 10` (en-US) | | Date/heure aller-retour | 6/10/2019 1:45:30 PM ➞ `2019-06-10T13:45:30.0900000` | | RFC1123 | 6/10/2019 1:45:30 PM ➞ `Mon, 10 Jun 2019 20:45:30 GMT` | | Date/heure pouvant être triée | 6/10/2019 1:45:30 PM ➞ `2019-06-10T13:45:30` | | Date/heure universelle pouvant être triée | 6/10/2019 1:45:30 PM ➞ `2019-06-10 20:45:30Z` | | Date/heure complète universelle | 6/10/2019 1:45:30 PM ➞ `Monday, June 10, 2019 8:45:30 P`M (en-US) | | Année/mois | 6/10/2019 1:45:30 PM ➞ `June, 2019` (en-US) |