Application de workflow EFORMASPX

Aperçu

L’application WorkflowGen EFORMASPX vous permet d’afficher et de remplir les différents champs de votre formulaire électronique à travers un formulaire Web. Un formulaire Web est un équivalent ASP.NET à un formulaire Windows. Il possède des caractéristiques similaires à un formulaire Windows.

Paramètres obligatoires

L’application EFORMASPX utilise deux paramètres obligatoires : une donnée de type fichier FORM_DATA, et une donnée de type texte, FORM_URL, pour afficher le formulaire Web rempli avec les données saisies par les différents acteurs lors de l’exécution du processus, ou avec des valeurs par défaut définies lors de la création du processus.

• FORM_URL (direction de données IN) : Contient le chemin du formulaire Web et peut être un chemin absolu relatif.

• FORM_DATA (direction de données INOUT) : Contient les données du formulaire en format XML, qui provient du dataset .NET (voir l’exemple ci-dessous). WorkflowGen créera ce fichier à chaque soumission de formulaire. Vous n’avez pas besoin d’associer une valeur par défaut. WorkflowGen créera et mettra à jour ce fichier automatiquement.

Exemple de FORM_DATA :

Un fichier XML FormData.xml contenant :

<?xml version="1.0" encoding="UTF-8" ?>
    <NewDataSet>
        <Table1 />
    </NewDataSet>

Exemple de FORM_URL :

/wfgen/WfApps/WebForms/MyFirstWebForm/v1/Form.aspx

Utilisation des paramètres supplémentaires

Initialisation des champs

Vous pouvez définir des valeurs par défaut pour les différents champs du formulaire Web qui seront appliqués à l’exécution du processus. Vous devez ajouter autant de paramètres IN ou INOUT que nécessaires associés à une donnée du processus spécifiques, une valeur de texte libre ou une macro.

Exemple :

Règle : Afficher le nom du demandeur dans le champ REQ_NAME. Méthode : Associer le nom du champ du formulaire à la macro Demandeur.Nom.

Capture des valeurs des champs

Vous pouvez récupérer les valeurs des champs du formulaire Web dans une donnée du processus en utilisant des paramètres OUT ou INOUT.

Par exemple, vous devez définir un paramètre OUT pour récupérer la décision du validateur du formulaire. Ce paramètre associe un nom de champ du formulaire à une donnée du processus qui a déjà été définie.

Notes

• Des données peuvent seulement être employées pour stocker seulement une valeur de champ par action.

• Des données de type TEXTE peuvent seulement contenir un maximum de 4000 caractères.

Exemple :

Règle : Capturer la réponse du gestionnaire dans une donnée de processus MGR_DECISION. Méthode : Associer le nom du champ du formulaire avec des données de processus pré-définies.

Paramètres supplémentaires modifiant les propriétés des champs du formulaire

Aperçu

Vous pouvez contrôler les propriétés obligatoires, lecture seule et caché des champs HTML depuis les paramètres des actions EFORMASPX. Les données des paramètres doivent être définies dans une liste de champs afin d’inclure ou exclure séparées par une virgule (,) ou un point-virgule (;). Cette liste comprend les caractères génériques (*) ou d’exclusion (^). Il est aisé de définir les propriétés des champs en fonction de l’action actuelle si on applique une convention de nommage stricte.

Liste des paramètres disponibles

• Liste des champs en lecture seule (IN) : FORM_FIELDS_READONLY

• Liste des champs obligatoires (IN) : FORM_FIELDS_REQUIRED

• Liste des champs cachés (IN) : FORM_FIELDS_HIDDEN

Exemples d’utilisation

Règle : Les champs EMP_NAME et EMP_DATE sont obligatoires Méthode : FORM_FIELDS_REQUIRED = EMP_NAME, EMP_DATE

Règle : Tous les champs sont définis en lecture seule sauf les champs dont le nom commence par EMP_ Méthode : FORM_FIELDS_READONLY = *, ^EMP_*

Règle : Tous les champs sont définis comme visibles sauf le champ DATE et les champs dont le nom commence par SUP_ et finit par _APP Méthode : FORM_FIELDS_HIDDEN = ^*, DATE, SUP_*_APP

Le paramètre supplémentaire FORM_ARCHIVE

Aperçu

C’est une manière de récupérer une copie statique du formulaire afin de la visualiser, imprimer ou envoyer par email sans avoir besoin d’exécuter le code du formulaire Web.

Paramètre

Copie statique HTML du formulaire ASP.NET (OUT) : FORM_ARCHIVE

La valeur du nom du fichier doit être définie dans le fichier XML initial de cette manière :

<FORM_ARCHIVE>form_archive.htm</FORM_ARCHIVE>

Le dataset doit également posséder un champ nommé FORM_ARCHIVE.

WorkflowGen manipule cette copie statique et ainsi aucun travail supplémentaire ne doit être effectué par les développeurs du processus ou du formulaire.

Mode de fonctionnement

Quand le formulaire Web est soumis par l’utilisateur, l’application EFORMASPX crée une copie statique du formulaire dans le répertoire WorkflowGen. WorkflowGen associe ensuite cette copie statique au paramètre FORM_ARCHIVE.

Le concepteur de processus doit :

• Créer une donnée de processus pour stocker la copie statique du formulaire générée par WorkflowGen.

• Associer cette donnée au paramètre OUT nommé FORM_ARCHIVE.