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.

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.

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.

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 :

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

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).

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

Vide

Demande

Standard

Champs par défaut

Pièce jointe

Case à cocher

Case à cocher – liste

Case à cocher – liste verticale

Monétaire

Date

Date heure

Liste déroulante

Tableau

Libellé

Liste

Numérique

Mot de passe

Bouton radio

Bouton radio – liste

Bouton radio – liste verticale

Monétaire – lecture seule

Date – lecture seule

Date heure – lecture seule

Numérique – lecture seule

Texte – lecture seule

Texte multi-lignes

Texte

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é

Supprimer l'outil de champ personnalisé

Champs

Nom

Nom de l'outil de champ personnalisé

Supprimer l'outil de champ personnalisé

Paramètres de section

Nom / Icône

Description

Fermer et appliquer les modifications au champ

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

Fermer et appliquer les modifications au champ

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 :

  • Affichage : le champ est en lecture seule

  • Édition : le champ peut être modifié

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

Ajouter un nouvel attribut

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

Fermer et appliquer les modifications au champ

Fermer et annuler les modifications

Éléments

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

Ajouter une nouvelle case à cocher/bouton radio

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

Fermer et appliquer les modifications au champ

Fermer et annuler les modifications au champ

Élément

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

Ajouter un nouvel élément

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 (<connectionStrings>)

✏️ 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 :

  • c:\monfichier.xml

  • http://nom_serveur/monfichier.xml

  • http://nom_serveur/service.asmx/getmonfichierxml

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 :

  • Créer un fichier de transformation (.xslt) qui peut dynamiquement reformater le fichier .xml afin qu’il soit compatible avec le contrôle XmlDataSource.

  • Spécifier le chemin de votre fichier XSLT dans le paramètre « XSL transform file » (voir ci-dessus).

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 : http://www.monsitesps.com/meslistes

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

Fermer et appliquer les modifications au champ

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 :

  • Liste déroulante

  • Liste

  • Libellé

  • Texte multi-lignes

  • Texte

✏️ Notes :

  • Les types de champs Texte et Texte multi-lignes ne supportent pas les paramètres de validation dans un tableau.

  • Le type de champ libellé ne supporte pas la liaison de données.

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://msdn.microsoft.com/fr-fr/library/system.data.datacolumn.expression(v=vs.80).aspx

Ajouter une nouvelle colonne

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).

É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.

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.

É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 PM (en-US)

Année/mois

6/10/2019 1:45:30 PM ➞ June, 2019 (en-US)

Dernière mise à jour