1 sur 52

7.22 Guide d’administration de WorkflowGen

L’objectif de ce guide est la description de tous les écrans du module d’administration de WorkflowGen et fournit une liste complète des règles de fonctionnement associées à ces écrans. Ce guide décrit également les applications de workflow incorporées et la manière de les utiliser.

Le guide de référence est une source d’information importante afin de vous permettre de comprendre comment le logiciel se comporte dans différentes situations.

Vous trouverez également la liste des erreurs possibles ainsi que leur description et cause.

Module d'administration WorkflowGen

Aperçu

Le module d’administration WorkflowGen est une application Web dont les fonctions principales sont :

La gestion des annuaires, des groupes et des utilisateurs

Gestion des utilisateurs

Aperçu

Une personne voulant intervenir dans un processus ou gérer des processus doit être identifiée en tant qu’utilisateur dans un annuaire WorkflowGen et posséder un compte (nom d’utilisateur et mot de passe) dans l’annuaire de référence sur lequel WorkflowGen se repose pour l’authentification.

Les utilisateurs peuvent être membres de groupes. Néanmoins, un groupe ne peut pas appartenir à un autre groupe.

Un utilisateur possède un statut actif ou inactif. Lorsque son statut est inactif l’utilisateur ne peut pas accéder à l’application.

Un utilisateur ne peut être supprimé de la base de données WorkflowGen si cet utilisateur est associé à un élément dans WorkflowGen. Si ce n’est pas le cas il sera archivé. « Archivage » signifie que le nom d’utilisateur sera modifié avec un numéro de séquence unique et recevra le statut archivé. L’utilisateur ne pourra plus accéder à l’application.

Plusieurs annuaires peuvent être gérés dans WorkflowGen. Ceci est particulièrement utile lorsque le module de synchronisation est actif. Un annuaire peut être géré manuellement dans WorkflowGen tandis qu’un autre peut être synchronisé à un annuaire de référence (Active Directory, LDAP, etc.). Même si plusieurs annuaires sont utilisés, chaque nom d’utilisateur doit être unique à travers le système.

Seuls les utilisateurs avec le profil Administrateur peuvent gérer les utilisateurs.

WorkflowGen est fourni avec un annuaire par défaut WORKFLOWGEN ainsi qu’un utilisateur administratif qui ne peut pas être supprimé.

Annuaires

Écran annuaires

Pour accéder à un annuaire, cliquez sur l’icône Annuaire pour afficher la liste des annuaires, puis cliquez sur l’annuaire dont vous souhaitez afficher les propriétés.

Liens

Remarques

Liste des annuaires

Édition d’un annuaire

Pour modifier un annuaire, cliquez sur son nom dans la liste des annuaires.

Suppression d’un annuaire

L’annuaire WORKFLOWGEN ne peut pas être supprimé.
Un annuaire associé à des utilisateurs ou des groupes ne peut pas être supprimé.
Un répertoire ne peut être supprimé s’il est un répertoire vide.

Délégations

Écran liste des délégations

Informations globales

Aperçu

Les informations globales concernent les informations pouvant être utilisées par tous les processus :

Les Participants représentent l’organisation de la société dans la gestion et l’exécution des processus.
Les sont les applications de workflow appelées depuis WorkflowGen afin de lancer les actions.
Les sont les mots clés associés aux processus à des fins de recherche.

Le module permet aux utilisateurs autorisés de gérer les listes de données du module d'administration à utiliser avec les formulaires Web.

Les informations globales sont gérables uniquement par des utilisateurs ayant le profil administrateur.

Gestion

Cycle de vie du processus

L’éditeur de formulaire intégré crée un formulaire Web (ASPX et le code-behind) qui est principalement bâti sur le framework ASP.NET et les librairies WorkflowGen.My.

Cela signifie qu'il offre l'avantage d’avoir des possibilités infinies de personnalisation et d’intégration du formulaire Web selon vos besoins spécifiques dans un environnement de développement avancé et intégré tel que Visual Studio.

Exemple de cycle de vie du processus

Un processus peut être facilement et rapidement créé comme première version en utilisant l'éditeur de formulaire intégré. Ceci permet aux utilisateurs de tester la première version comme un pilote.
Si le processus répond aux besoins métiers il peut être déployé en production.
S’il y a des fonctionnalités personnalisées ou avancées requises dans une nouvelle version qui ne sont pas disponibles dans l’éditeur de formulaire intégré, le processus peut être migré vers le développement Web.

Migrer un processus

Pour migrer un processus créé avec l’éditeur de formulaire Web, suivez les étapes ci-dessous :

Sauvegardez une nouvelle version du processus ou dupliquez-le.
Décochez l'option Activer l’éditeur de formulaire sur l'onglet Infos.
Dans Visual Studio, ouvrez le site Web du formulaire avec le chemin du dossier (\wfgen\wfapps\WebForms\[nom du process]\V[numéro de version]) et commencez votre développement.

Pour plus de renseignements sur le développement des formulaires Web, référez-vous au .

Sécurité

Toutes les chaînes de connexion dans \wwwroot\wfgen\web.config sont disponibles pour une utilisation dans l’éditeur de formulaire et dans les listes globales sauf la chaîne de connexion de la base de données maître. Bien que l’application tente de vérifier que les requêtes SQL utilisées dans ce contexte soient sécurisées et contiennent uniquement des instructions SELECT, vous devrez également vous assurer que les chaînes de connexion exposées soient sécurisées au niveau de la base de données. Cela signifie que si vous ne voulez pas qu’un superviseur de processus ou un superviseur de listes globales puisse mettre à jour ou modifier une base de données spécifique, la chaîne de connexion devrait avoir un accès en lecture seule à la base de données.

Gardez à l’esprit que les créateurs de processus peuvent utiliser toute chaîne de connexion à laquelle ils peuvent accéder depuis l’éditeur code-behind de l’éditeur de formulaires. Si vous voulez limiter l’accès d’un superviseur de listes globales à une chaîne de connexion tout en permettant le créateur de processus d’y accéder, vous devez ajouter la chaîne de connexion au web.config de l’application WebForms (\wwwroot\wfgen\WfApps\WebForms\web.config).

Les chaînes de connexion dans le web.configde WebForms ne sont pas exposées dans l’interface utilisateur de WorkflowGen, donc pour que les créateurs de processus puissent les utiliser, ils doivent connaître le nom de la chaîne. Ceci est également un manière pratique de donner accès aux créateurs de processus distincts à différentes chaînes de connexions.

Application de workflow XMLTRANS

Aperçu

L’application de workflow XMLTRANS transforme n’importe quel document XML en n’importe quel autre format en utilisant une feuille XSLT.

Mode de fonctionnement

Application de workflow UPDATEPROCESSDATA

Aperçu

L'application de workflow UPDATEPROCESSDATA vous permet de modifier la valeur d’une donnée d’un processus pour une demande donnée. Elle fournit un moyen simple d’interagir entre différents processus, puisqu’une demande peut modifier une ou plusieurs données d’une autre demande.

Utilisation des paramètres par défaut

Numéro de la demande à modifier

Le paramètre REQUEST_ID de direction IN et de type numérique est obligatoire et doit contenir un numéro de demande valide.

Action

Les paramètres optionnels sont le ou les noms des données qui devront être modifiées.

Dans un processus, pour créer une action de type UPDATEPROCESSDATA, utilisez les paramètres suivantes :

REQUEST_ID envoie la valeur de la donnée :
- Donnée : REQUEST_ID_UPDATE
AMOUNT envoie la valeur de la donnée :

Vous devriez ajouter une gestion d’exception sur l’action de type UPDATEPROCESSDATA en cas d’erreur (par exemple, numéro de demande invalide).

📌 Exemple

Si vous souhaitez modifier la donnée AMOUNT (montant) avec la valeur de la donnée de processus AMOUNT_UPDATE, l’ID de demande à modifier est stocké dans une donnée de processus REQUEST_ID_UPDATE.

Application de workflow COMPLETEACTION

Aperçu

L'application de workflow COMPLETEACTION vous permet de compléter une action en cours avec les paramètres correspondant. Elle fournit une solution pour interagir et synchroniser des processus entre eux.

Paramètres

Demande

Action

Paramètres facultatifs

Les paramètres facultatifs sont les paramètres de l'action à compléter. Vous devrez définir ces paramètres dans les paramètres d'action correspondants. Vous pouvez ajouter autant de paramètres facultatifs qu'il y a de paramètres de l'action à compléter.

📌 Exemple

Si vous souhaitez compléter une action de type procédure Web asynchrone nommée MYASYNCACTION et qui possède le paramètre suivant :

AMOUNT reçoit la valeur de la donnée TOTAL (vous devez créer cette donnée dans votre processus)

Alors dans votre processus, ajoutez une action de type COMPLETEACTION avec les paramètres suivants :

Vous devriez ajouter une gestion d’exception sur l’action de type COMPLETEACTION en cas d’erreur (par exemple, numéro de demande invalide ou numéro d’action invalide, etc...).

Application de workflow GETPROCESSDATA

Aperçu

L'application de workflow GETPROCESSDATA vous permet de récupérer la valeur d’une ou de plusieurs données d’une demande. Elle fournit un moyen simple d’interagir entre différents processus.

Dans certains cas, cette application peut remplacer l’appel à un sous-processus et ainsi éviter la gestion parfois contraignante des versions entre les processus fils et parents.

Utilisation des paramètres par défaut

Numéro de demande

Le paramètre REQUEST_ID de direction IN et de type numérique est obligatoire et doit contenir un numéro de demande valide.

Action

Les autres paramètres sont définis dans l’action du workflow selon vos besoins.

Nom du paramètre : le nom de la donnée distante à récupérer
Récupérer la valeur dans : la donnée de processus à modifier

📌 Exemple

Pour récupérer la valeur de la donnée COMPANY d’un processus distant dans une donnée CUSTOMER_COMPANY d’un processus, ajouter une action de type GETPROCESSDATA avec comme paramètre optionnel :

Nom du paramètre : COMPANY
Récupérer la valeur dans : CUSTOMER_COMPANY

Les données COMPANY et CUSTOMER_COMPANY doivent être du même type.

Vous devriez ajouter une gestion d’exception sur l’action de type GETPROCESSDATA en cas d’erreur (par exemple, numéro de demande invalide, etc.).

Application de workflow GETFORMDATA

Aperçu

L'application de workflow GETFORMDATA vous permet de récupérer la valeur des champs d’une demande donnée. Cela peut être utile pour récupérer les données d’un formulaire qui ne sont pas mappées aux données du processus.

GETFORMDATA ne peut être utilisé qu'avec des champs et des données de type TEXT, NUMERIC et DATETIME.

Application de workflow CANCELREQUEST

Aperçu

L’application de workflow CANCELREQUEST vous permet d’annuler une demande en cours.

Paramètres

Application de workflow COPYDATA

Aperçu

L’application de workflow COPYDATA copie les données depuis un paramètre dans une autre donnée.

Mode de fonctionnement

Application de workflow SENDMESSAGE

Aperçu

L’application de workflow SENDMESSAGE permet aux utilisateurs d’envoyer des notifications par SMS via la plateforme Twilio; pour utiliser cette application, il faut créer un compte sur le site Web Twilio à l’adresse https://www.twilio.com/sms.

Mode de fonctionnement

L’application SENDMESSAGE requiert deux paramètres (BODY et TO) qui sont liés à leurs identifiants correspondants.

Les valeurs qui correspondent aux paramètres ACCOUNT_SID, AUTH_TOKEN et FROM sont requis pour se connecter à Twilio, mais celles-ci sont habituellement configurés dans la section Messagerie instantanée dans l’onglet Général du Panneau de configuration. Cependant, si ces paramètres ont été configurés dans l’action SENDMESSAGE dans un processus, ces valeurs outrepasseront les valeurs correspondantes configurées dans le Panneau de configuration.

Paramètres

Paramètres obligatoires

Paramètres facultatifs

* Ces paramètres doivent être associés à un compte Twilio.

URL WorkflowGen

Aperçu

Les modules de WorkflowGen peuvent être accédés directement depuis la barre d'adresse de votre navigateur en saisissant l'URL de chacun.

Portail

http://VOTRESITE/wfgen/default.aspx

Si le site Web est configuré pour utiliser un document par défaut, il n'est pas nécessaire de spécifier le nom du document.

Module d’administration

http://VOTRESITE/wfgen/admin/default.aspx

Si le site Web est configuré pour utiliser un document par défaut, il n'est pas nécessaire de spécifier le nom du document.

Panneau de configuration

http://VOTRESITE/wfgen/admin/Config.aspx

Intégrations par l’entremise d’URL

Pour des informations sur comment utiliser les URL WorkflowGen pour les intégrations, consultez la section dans le (disponible en anglais seulement).

Messages d'erreur

Licence

Utilisateurs

Écran liste des utilisateurs

Écran utilisateurs

Filtres

* Un filtre peut être appliqué à une partie d’un champ.

Liste des utilisateurs

Formulaire utilisateur

* Champs utilisés dans le cadre de synchronisation avec Active Directory. Ce champ n'est pas utilisé par l'application. Toutefois, il est possible de l'utiliser dans les macros du workflow.

Suppression et archivage

Un utilisateur sera archivé et non supprimé si :

L’utilisateur est associé à un participant en tant qu’utilisateur.
L’utilisateur est le créateur ou le modificateur d’un processus.
L’utilisateur est associé à une demande ou à une action.

Un utilisateur ne pourra pas passer à l’état inactif ou être supprimé ou archivé si :

L’utilisateur est le seul coordinateur d’un participant de type liste de personne avec un coordinateur.
L’utilisateur est la seule personne d’un groupe affecté à un participant de type liste de personnes.
L’utilisateur est la seule personne d’un participant de type liste de personnes.

Remplacement d'un utilisateur

Vous pouvez remplacer un utilisateur par un autre. L’utilisateur de remplacement doit appartenir au même annuaire et au même groupe. Toutes les responsabilités seront transfère à l’utilisateur de remplacement.

Toutes les demandes courantes seront transférées à l’utilisateur de remplacement, par contre les demandes clôturées garderont les informations de l’utilisateur archivé.

Cette fonction est utile quand une personne quitte leur position dans l’organisation et ses tâches et rôles doivent être réassignés.

Rapport d’activité

Le rapport d’activité peut être généré avec un seul clic sur le lien Rapport d’activité sur la page de profil d’utilisateurs pour l’individu en question.

Le rapport généré résume toutes les activités pour l’utilisateur sélectionné. Par exemple :

Utilisation des demandes

Type de demande
En cours
Clôturées
Total

Utilisation des actions

Type d’action
En cours
Clôturées
Total

Délégations de quelqu’un

Process
Participant
Global
Utilisateur délégué

Délégations à quelqu’un

Process
Participant
Global
Utilisateur

Participants auxquels l’utilisateur est associé

Processus
Participant
Global
Rôle

Gestionnaire de dossier/processus

Dossier
Participant
Annuaire
Groupes

Gestionnaire des listes globales

Participant
Annuaire
Groupe(s)
Utilisateur(s)

Participants

Écran liste des participants

Écran des participants

Filtres

* Un filtre peut être appliqué à une partie d’un champ.

Liste des participants

Formulaire participant

Accessible uniquement aux participants de type Liste de personnes et Liste de personnes avec coordinateur(s).
Accessible uniquement aux participants de type Liste de personnes avec coordinateur(s).

Associations avec un annuaire

* Visible uniquement si associé à un utilisateur ou un coordinateur et si le nombre d’utilisateurs dans la base de données est supérieur à la limite définie par l’administrateur du logiciel.

Un participant de type Personne est associé à un utilisateur unique.
Un participant de type Liste de personnes est associé à un ou plusieurs utilisateurs et/ou groupes et/ou annuaires.
Un participant de type Liste de personnes avec coordinateur(s) est associé à un ou plusieurs coordinateurs et un ou plusieurs utilisateurs et/ou groupes et/ou annuaires.

En ajoutant des utilisateurs, groupes et annuaires aux participants, notez que la liste est cumulative. C’est-à-dire qu’en ajoutant 3 utilisateurs, 2 groupes et 4 annuaires, le résultat sera une liste inclusive de ces utilisateurs, groupes et annuaires.

Un groupe ou un annuaire n’a pas besoin d’être spécifique pour ajouter des utilisateurs qui appartiennent à ces groupes ou ces annuaires. L’ajout de ces groupes ou annuaires se traduira par l’ajout de tous les utilisateurs qui font partie de ces groupes et annuaires.

Modification du type de participant

Les conditions suivantes s'appliquent lors de la modification du type de participant :

Personne à Liste de personnes ou Liste de personnes avec coordinateur(s) : Le participant ne doit pas être utilisé dans une action de processus.
Liste de personnes à Personne : Un seul utilisateur doit être associé au participant et le participant ne doit pas être utilisé dans une action de processus.
Liste de personnes à Liste de personnes avec coordinateur(s) : Ajoutez au moins un coordinateur.

Suppression d'un participant

Un participant ne peut pas être supprimé si la personne fait partie d’un processus ou est un gestionnaire de dossier.

Listes globales

Aperçu

Le module de gestion des listes globales permet à des utilisateurs autorisés de créer et de gérer facilement des listes de données depuis le module d'administration de WorkflowGen en vue de leur utilisation au sein des formulaires de différents processus.

La gestion des listes globales propose une solution pour gérer et centraliser les données qui alimenteront des listes déroulantes de vos formulaires utilisés dans le cadre de vos workflows.

Il n’y a pas de limite concernant le nombre d’éléments que peut contenir une liste globale, qui peut avoir jusqu’à 20 colonnes. La performance de l’interface utilisateur dépend du nombre de cellules (éléments × colonnes) et est optimisé pour proposer de bonnes performances jusqu’à 5000 cellules (ex. : 1000 éléments avec 5 colonnes ou 250 éléments avec 20 colonnes).

Les types de données supportées dans les colonnes sont : texte, numérique ou date.

Une liste globale statique est alimentée manuellement par les utilisateurs habilités dans l’interface prévue à cet effet du module d’administration.

Une liste globale dynamique contient des données provenant d’une base de données. Le contenu de la liste est mis à jour à chaque fois que le formulaire est exécuté.

Écran des listes globales

Filtres

Liste de listes globales

Formulaire de listes globales

Importer des données

Vous pouvez importer des données dans une liste globale depuis un fichier ou en copier de votre presse-papiers. Les formats supportés sont les listes globales WorkflowGen XML ou CSV.

Le format CSV doit être comme suit :

Exemples

Importation uniquement des colonnes texte

Par défaut, les colonnes sont considérées de type texte, donc si toutes les colonnes sont de type texte, il n’est pas nécessaire de spécifier le type de données.

Importation avec des données de type numérique ou date

Dans ce cas, la seconde ligne est utilisée pour définir le type de données de la colonne.

Importation avec des chaînes fermées

Pour protéger des données comme des guillemets, virgules, etc… vous pouvez fermer une chaîne avec des guillemets.

Exporter des données

Vous pouvez exporter les données d’une liste globale dans un fichier. Les formats supportés sont les listes globales WorkflowGen XML ou CSV.

Sécurité

Toutes les chaînes de connexion dans \wwwroot\wfgen\web.config sont disponibles pour une utilisation dans les listes globales et dans l’éditeur de formulaire sauf la chaîne de connexion de la base de données maître. Bien que l’application tente de vérifier que les requêtes SQL utilisées dans ce contexte soient sécurisées et contiennent uniquement des instructions SELECT, vous devrez également vous assurer que les chaînes de connexion exposées soient sécurisées au niveau de la base de données. Cela signifie que si vous ne voulez pas qu’un superviseur de processus ou un superviseur de listes globales puisse mettre à jour ou modifier une base de données spécifique, la chaîne de connexion devrait avoir un accès en lecture seule à la base de données.

Les chaînes de connexion dans le web.config de WebForms ne sont pas exposées dans l’interface utilisateur de WorkflowGen, donc pour que les créateurs de processus puissent les utiliser, ils doivent connaître le nom de la chaîne. Ceci est également un manière pratique de donner accès aux créateurs de processus distincts à différentes chaînes de connexions.

Application de workflow EFORMASPX

Aperçu

L’application de workflow 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

📌 Exemple de `FORM_DATA`

Un fichier XML FormData.xml contenant :

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

Des données peuvent seulement être employées pour stocker seulement une valeur de champ par action.
À partir de la version 7.15.0 de WorkflowGen, les données de processus de type TEXT n'ont plus de limite de 4 000 caractères pour la base de données MS SQL Server.

📌 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

Exemples d’utilisation

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

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.

EMP_

Application de workflow RAISEEXCEPTION

Aperçu

L'application de workflow RAISEEXCEPTION déclenche les exceptions d'annulation sur les actions spécifiées, contrôlées par l'exception de workflow d'annulation d'action dans le panneau de définition des conditions. Cette application de workflow peut ainsi être appelée par une action pour annuler une ou plusieurs autres actions dans une requête en cours. L'application est convertie en assembly de workflow pour simplifier la configuration et améliorer les performances.

Vous pouvez supprimer l’application dans la console IIS ainsi que le dossier physique sur le serveur (\wfgen\WfApps\WebServices\RaiseException). Par ailleurs, les paramètres d’authentification dans la déclaration de l’application de workflow ne sont pas nécessaires.

Ce dispositif est utile quand une ou plusieurs actions doivent être annulées après qu'un certain point dans le workflow ait été atteint, quoique ces actions aient été déjà activées. Comme exemple, si trois actions parallèles sont actives, mais une des actions parallèles est conclue avant les autres et vos règles de workflow déterminent que les deux autres actions ne sont plus exigées, vous pourriez activer le RAISEEXCEPTION pour annuler les deux autres actions et pour permettre le déroulement du workflow.

De plus, vous pouvez :

Utiliser les paramètres par défaut pour annuler toutes les actions d’une demande identifiée.
Utiliser les paramètres facultatifs pour annuler une liste d’actions instanciées dans une liste de demandes ou pour effectuer une annulation à la place d’un utilisateur défini.
Utiliser les paramètres supplémentaires pour définir plusieurs couples de références d’actions.

Paramètres par défaut

Les paramètres REQUEST_ID et ACTIVITY_NAME doivent être utilisés ensemble.

📌 Exemple

Dans cet exemple, l’application va annuler tous les instances de l’action PENDING_ACTION dans la demande 455 :

Paramètres facultatifs

Les paramètres REQUEST_ID_LIST et ACTIVITY_NAME_LIST doivent être utilisés ensemble.

📌 Exemples

Dans cet exemple l’application va annuler toutes les instances des actions PENDING_ACTION1 et PENDING_ACTION2 dans les demandes 445, 446 et 447 :

Dans cet exemple l’application va annuler toutes les instances des actions nommées PENDING_ACTION dans la demande 445 à la place de Jean Dupont (jdupont):

Paramètres supplémentaires

📌 Exemple

Dans cet exemple l’application va annuler toutes les instances de l’action PENDING_ACTION1 dans la demande 455 et toutes les instances de l’action PENDING_ACTION2 dans la demande 456. Si les actions 455 et 456 n’ont pas d’instance ouverte aucune erreur n’est remontée.

Erreurs d’exécution possibles

Les erreurs suivantes peuvent se produire lors de l’exécution de l’application :

Menus personnalisés

Module d’administration

Aperçu

Pour créer des menus personnalisés dans le module administration, vous devez créer et modifier un fichier XML nommé admin.xml dans le dossier CustomMenu situé dans\wwwroot\wfgen\App_Data\customMenus.

Ces menus personnalisés seront alors disponibles en tant qu'options de menu supplémentaires dans le module d'administration. WorkflowGen supporte deux niveaux d'éléments de menu personnalisés.

Les éléments du menu peuvent être sécurisés par le profil utilisateur.

Contenu XML

Images

Vous pouvez également utiliser des images dans un thème personnalisé. Pour ce faire, créez un nouveau thème WorkflowGen et dirigez le chemin URL de l'icône à son emplacement dans le répertoire \wfgen\App_Themes\MONTHEME\admin\images.

Le répertoire par défaut est \wfgen\App_Themes\Default\admin\images. Vous pouvez également ajouter vos images personnalisées à ce dossier et les utiliser à partir du dossier de thème Default (voir l'exemple ci-dessous).

Exemple de fichier `admin.xml`

Portail utilisateur

Aperçu

Pour créer des menus personnalisés dans le portail utilisateur, vous devez créer et modifier un fichier XML nommé portal.xml dans le dossier CustomMenu situé dans\wwwroot\wfgen\App_Data\customMenus.

Ces menus personnalisés seront alors disponibles en tant qu'options de menu supplémentaires dans le portail utilisateur. WorkflowGen supporte deux niveaux d'éléments de menu personnalisés.

Les éléments du menu peuvent être sécurisés par le profil utilisateur.

Contenu XML

Le répertoire par défaut est \wfgen\App_Themes\Default\portal\images. Vous pouvez également ajouter vos images personnalisées à ce dossier et les utiliser à partir du dossier de thème Default (voir l'exemple ci-dessous).

Exemple de fichier `portal.xml`

<?xml version="1.0" encoding="utf-8" ?>
<menu>
    <menuItem title="Mes liens..." profile="user">
        <menuItem title="Advantys" url="http://www.advantys.com/" target="_new" description="Advantys Web Site" profile="user" showInHomepage="true"  />
        <menuItem title="WorkflowGen" url="http://www.workflowgen.com/" target="" description="WorkflowGen Web Site" profile="admin" icon="myicon.gif" showInHomepage="false"  />
    </menuItem>
</menu>

<?xml version="1.0" encoding="utf-8" ?>
<menu>
    <menuItem title="WorkflowGen – BPM Resource Center" profile="user" url="http://community.workflowgen.com/" description="Open the WorklfowGen BPM Resource Center web site" target="_new" icon="" />  
    <menuItem title="WorkflowGen" profile="supervisor" url="http://www.workflowgen.com/" description="Open the WorkflowGen website" target="_blank" icon="" />  
    <menuItem title="Advantys" profile="manager" url="http://www.advantys.com/" description="Open the Advantys web site" target="_self" icon="" />  
    <menuItem title="Google Search" profile="admin" url="http://www.google.com/" description="Open Google Search" target="_parent" icon="search_l.gif" />  
    <menuItem title="Yahoo!" profile="user" url="http://www.yahoo.com/" description="Open the Yahoo! website" target="_top" icon="" />  
    <menuItem title="New Leave Application" profile="user" url="/wfgen/show.aspx?QUERY=START&amp;P=LEAVE_APPLICATION" description="Launch a new leave application" target="_new" icon="http://dev4/wfgen/App_Themes/Default/portal/images/request_followup_form_l.gif" />
</menu>

TIMEOUT

Décimal ({0:D})

<html>
<head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>My Title</title>
    <style type="text/css">
        body
        {
            font-family:Arial;
        }
    </style>
</head>
<body>
    <table width="90%">
    <tr>
        <td>
            <img src="C:\inetpub\wwwroot\wfgen\App_Themes\Default\portal\images\activity_s.gif">&nbsp;<WF_PROCESS_INST_NAME>
        </td>
    </tr>
    <tr>
        <td>
            Décision
        </td>
        <td>
            <WF_PROCESS_INST_RELDATA_VALUE.MGR_DEC>
        </td>
    </tr>
    <tr>
        <td>
            Date
        </td>
        <td>
            <WF_SYSTEM_DATE>
        </td>
    </tr>
    <tr>
        <td>
            Lancer l’action
        </td>
        <td>
            <a href="<WF_LINK_ACTIVITY_INST_LAUNCH>">lien 1</a>
        </td>
    </tr>
    <tr>
        <td>
            Faire le suivi de l’action
        </td>
        <td>
            <a href="<WF_LINK_ACTIVITY_INST_FORM>">lien 2</a>
        </td>
    </tr>
    <tr>
        <td>
            Faire le suivi de la demande
        </td>
        <td>
            <a href="<WF_LINK_PROCESS_INST_FORM>">lien 3</a>
        </td>
    </tr>
    <tr>
        <td>
            Faire le suivi de la demande
        </td>
        <td>
            <a href="http://YOURSITE/wfgen/show.aspx?QUERY=PROCESS_INSTANCE_FORM&ID_PROCESS_INST=<WF_PROCESS_INST_ID>">Lien</a>
        </td>
    </tr>
    </table>
</body>
</html>

SUBJECT : Mon sujet

Décision : <WF_PROCESS_INST_RELDATA_VALUE.MGR_DEC>

Date : <WF_SYSTEM_DATE>

Lancer l’action : <WF_LINK_ACTIVITY_INST_LAUNCH>

Faire le suivi de l’action : <WF_LINK_ACTIVITY_INST_FORM>

Faire le suivi de la demande : http://VOTRESITE/wfgen/Show.aspx?QUERY=PROCESS_INSTANCE_FORM&ID_PROCESS_INST=<WF_PROCESS_INST_ID>

<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0">
    <channel>
        <title>WorkflowGen</title>
        <description>WorkflowGen</description>
        <pubdate>Fri, 24 Oct 2011 15:19:42 GMT</pubdate>
        <language>en-US</language>
        <item>
            <title>Ongoing requests</title>
            <link>http://yoursite/wfgen/...</link>
            <description>15</description>
            <category>REQUEST_RUNNING_NB</category>
        </item>
        <item>
            <title>Actions to do</title>
            <link>http://yoursite/wfgen/...</link>
            <description>10</description>
            <category>ACTION_TODO_NB</category>
        </item>
    </channel>
</rss>

Application de workflow GETUSERSFROMDIR

Aperçu

L’application de workflow GETUSERSFROMDIR permet la récupération d’une liste de noms d’utilisateurs, d’une liste d’emails ou d’une liste des IDs utilisateur. Ces listes s’obtiennent via une action automatique WorkflowGen qui exécute des requêtes SQL sur la base de données WorkflowGen. Elle peut être utilisée pour les notifications automatiques ou pour définir (filtrer) les utilisateurs d’une action d’un processus WorkflowGen.

Définitions

Le caractère x : Le caractère x dans certains noms de paramètres signifie qu’il peut exister plus d’une instance du paramètre. Par exemple, QUERYx_CMD signifie qu’il peut-y avoir QUERY1_CMD, QUERY2_CMD, QUERY3_CMD etc...
Action : Vous devez créer une action WorkflowGen de type GETUSERSFROMDIR pour utiliser cette application.

Liste des champs et macros disponibles pour les requêtes

Voici les champs et macros disponibles pour les requêtes créées dans les paramètres QUERYx_CMD. Ils peuvent être utilisés dans les conditions de ces requêtes afin de filtrer leurs résultats.

📌 Exemples

Cet exemple retourne une liste des noms d’utilisateur des utilisateurs de la province du Québec :

Cet exemple retourne une liste des noms d’utilisateur des utilisateurs dont l’adresse email termine par advantys.com :

Cet exemple retourne une liste des noms d’utilisateur des utilisateurs appartenant au groupe de développement :

Utilisation des paramètres supplémentaires

`QUERY1_CMD` : Exécution d’une requête SQL

Description

Pour lancer une requête SQL vous devez ajouter le paramètre (IN) QUERY1_CMD à l’action. Si le paramètre est vide ou inexistant l’opération ne sera pas exécutée.

📌 Exemple

Cet exemple retourne la liste des utilisateurs de la ville de Montréal dans le paramètre RESULT_LIST :

`RESULT_LIST` / `QUERYx_RESULT_LIST` : Capture du résultat des requêtes

Description

Pour récupérer le résultat de toutes les requêtes (liste des utilisateurs au format chaîne de caractères) vous devez ajouter le paramètre (OUT) RESULT_LIST à l’action. Pour récupérer le résultat individuel par requête vous devez ajouter le paramètre (OUT) QUERYx_RESULT_LIST pour chaque requête.

📌 Exemple

Cet exemple retourne la liste des utilisateurs de Montréal, Toronto et New York dans le paramètre RESULT_LIST. QUERY1_RESULT_LIST contient la liste des utilisateurs de Montréal, QUERY2_RESULT_LIST contient la liste des utilisateurs de Toronto et QUERY3_RESULT_LIST contient la liste des utilisateurs de New York :

À partir de la version 7.15.0 de WorkflowGen, le résultat d'une requête renvoyée dans des données de processus de type TEXT n'a plus de limite de 4 000 caractères pour la base de données MS SQL Server.

`QUERY1_DIR` : Définition de l’annuaire

Description

Vous pouvez définir l’annuaire des utilisateurs sur lequel vous voulez que porte la requête. Vous devez ajouter un paramètre (IN) QUERY1_DIR dans l’action. Si ce paramètre est NULL ou n’existe pas l’annuaire par défaut est WORKFLOWGEN (ou l’annuaire défini comme défaut par l’administrateur).

📌 Exemple

Cet exemple retourne la liste des noms d'utilisateur des utilisateurs de l’annuaire VotreSociété dans le paramètre RESULT_LIST :

`QUERYx_CMD` : Utilisation de plusieurs requêtes

Description

Vous pouvez ajouter plusieurs requêtes dans la même action WorkflowGen et récupérer les résultats dans une liste complète ou dans une liste par requête. Vous devez ajouter le paramètre (IN) QUERYx_CMD dont x est le numéro de la requête. Vous devez ajouter les paramètres (OUT) QUERYx_RESULT_LIST pour récupérer les résultats de chaque requête.

📌 Exemple

Cet exemple retourne la liste des noms d'utilisateur des utilisateurs de Montréal de l’annuaire WORKFLOWGEN dans le paramètre (IN) QUERY1_RESULT_LIST, la liste des noms d'utilisateur des utilisateurs de Montréal de l’annuaire INTRANET dans le paramètre (IN) QUERY2_RESULT_LIST et la liste complète des noms d'utilisateur des deux requêtes dans le paramètre (IN) RESULT_LIST :

`QUERYx_TOP` : Définition du nombre maximum d’enregistrements du résultat

Description

Vous pouvez spécifier le nombre maximum d’enregistrements retournés par les requêtes en ajoutant le paramètre (IN) QUERYx_TOP à l’action. Cette requête ne sera pas capable de retourner plus de résultats que le nombre défini dans ce paramètre.

📌 Exemples

Cet exemple retourne seulement les deux premiers noms d'utilisateur de cette requête :

Cet exemple retourne tous les noms d'utilisateur de cette requête :

`QUERYx_DEFAULT_VALUE` : Définition d’une valeur par défaut

Description

Vous pouvez définir une valeur par défaut à retourner pour les valeurs qui ne retournent pas de valeur. Vous devez ajouter un paramètre (IN) QUERYx_DEFAULT_VALUE à l’action.

📌 Exemple

Dans cet exemple, la requête ne retourne aucune valeur car la société définie n’existe pas. Ainsi le paramètre RESULT_LIST contiendra la valeur défaut1 :

`RESULT_SEPARATOR` : Définition d’un séparateur

Description

Vous pouvez définir un caractère de séparation des résultats dans la liste retournée en ajoutant un paramètre (IN) RESULT_SEPARATOR à l’action. Le séparateur par défaut est , (virgule).

📌 Exemple

Pour cet exemple, la valeur retournée dans le paramètre RESULT_LIST est nom1***nom2***nom3 :

Cet exemple retourne la valeur nom1,nom2,nom3 :

`RESULT_COUNT` / `QUERYx_RESULT_COUNT` : Compteur du nombre d’enregistrements retournés

Description

Vous pouvez récupérer le nombre d’enregistrements retournés par chaque requête ou par toutes les requêtes. Pour le nombre total d’enregistrements retournés par toutes les requêtes vous devez ajouter le paramètre (OUT) RESULT_COUNT à l’action. Pour le nombre d’enregistrements retournés par requête vous devez ajouter le paramètre (OUT) QUERYx_RESULT_COUNT à l’action.

📌 Exemple

L’exemple suivant retourne le nombre total d’enregistrements dans le paramètre RESULT_COUNT et le nombre d’enregistrements par requête (QUERY1 et QUERY2) dans les paramètres QUERY1_RESULT_COUNT et QUERY2_RESULT_COUNT :

Utilisation des paramètres dans les conditions des requêtes SQL

Description

Vous pouvez utiliser des paramètres dans les conditions SQL contenues dans le paramètre QUERYx_CMD. Vous devez ajouter des paramètres IN avec des noms différents des noms réservés suivants :

QUERYx_CMD
QUERYx_DIR
QUERYx_TOP

Vous pouvez alors appeler ces paramètres dans la condition en les préfixant par le caractère @ (arobase).

📌 Exemple

Cet exemple retourne la liste des noms d'utilisateur des utilisateurs de Montréal de l’annuaire WORKFLOWGEN :

N’oubliez pas que le nom du paramètre utilisé dans la condition doit être le même que celui défini dans l’action WorkflowGen.

`QUERYx_CMD` : Utilisation des macros dans les conditions des requêtes SQL

Description

Vous pouvez utiliser des macros dans les conditions SQL contenues dans les paramètres QUERYx_CMD. Vous devez simplement ajouter une macro disponible dans la condition.

📌 Exemple

L’exemple suivant retourne la liste des noms d'utilisateur des utilisateurs membres du groupe Dev venant de Montréal et associés à l’annuaire WORKFLOWGEN :

Il est important de respecter la syntaxe dans la liste des macros disponibles.

`RESULT_LIST_EMAIL` / `QUERYx_RESULT_LIST_EMAIL` : Capture des résultats des requêtes sous forme de liste d’emails

Description

Pour récupérer la liste des emails résultant de toutes les requêtes vous devez ajouter un paramètre (OUT) RESULT_LIST_EMAIL à l’action. Si vous voulez retrouver les emails par requête vous devez ajouter un paramètre (OUT) QUERYx_RESULT_LIST_EMAIL pour chaque requête.

📌 Exemple

Cet exemple retourne la liste des emails des utilisateurs de Montréal et Toronto dans le paramètre RESULT_LIST_EMAIL. Les paramètres QUERY1_RESULT_LIST_EMAIL et QUERY2_RESULT_LIST_EMAIL contiennent respectivement la liste des emails des utilisateurs de Montréal et de Toronto :

Gestion des erreurs dans WorkflowGen

Vous devez ajouter une action corrective liée à l’action GETUSERSFROMDIR afin de gérer les erreurs d’exécution. Cette action corrective est de type manuel et est lancée sur erreur d’exécution. Ainsi vous devez ajouter cette exception sur la transition entre les deux actions. Vous trouverez ci-dessous la liste des erreurs les plus fréquentes retournées par l’application.

Nombre maximum d’enregistrements retournés

Il existe une constante GetUsersFromDirMaxResultNb dans le fichier web.config contenant le nombre maximum d’enregistrements pouvant être retourné par une requête. Cette limite réduit le risque d’une erreur d’expiration d’un temps limite qui peut se produire lorsque les résultats des requêtes sont trop nombreux. Si le nombre d’enregistrements retournés est supérieur à la valeur de cette constante un message d’erreur indiquant que les requêtes retournent trop d’enregistrements (« The queries returned too many records ») sera affiché.

QUERYx_RESULT_COUNT

Application de workflow XMLTODATABASE

Aperçu

L’application de workflow XMLTODATABASE vous permet d’exporter les données depuis un document XML vers une ou plusieurs bases de données. C’est une application asynchrone qui ne nécessite pas d’action d’un utilisateur. La configuration des transactions SQL est effectuée via un fichier XML qui active les requêtes SQL sur des sources de données ODBC ou OLEDB.

Mode de fonctionnement

Le moteur WorkflowGen appelle l’application XMLTODATABASE avec le contexte et les paramètres afin d’obtenir les éléments suivants :

Le document XML contentant les données à exporter
Le fichier de transaction contenant :
- Les informations de connexion à la base de données
- Les informations de localisation des données dans le document XML contenant les données (en utilisant des XPath)

Après que XMLTODATABASE ait rassemblé toutes ces informations, elle est prête à exporter, et retourne ensuite le contexte à WorkflowGen afin que le workflow puisse continuer.

Description du fichier XML

Aperçu

Le document de transactions XML spécifie les commandes SQL qui seront exécutées sur les bases de données. Il est utilisé pour deux fonctions principales: la connexion à la base de données et le mappage des champs de la requête aux champs du document de données XML. N'oubliez pas que le document de données XML (généralement nommé FORM_DATA) peut être construit de plusieurs façons. Pour cette raison, les XPath sont utilisés pour mapper les champs de base de données aux champs XML.

Structure

Toute activité XMLTODATABASE peut avoir un nombre illimité de bases de données et un nombre illimité de commandes par base de données. Cela signifie que l'exportation peut être effectuée vers plusieurs bases de données et que chaque base de données peut avoir plusieurs commandes.

📌 Exemple de fichier de transactions XML

Attributs

Nœud `transaction`

Nœud `database`

Vous pouvez utiliser l'attribut connectionstringname ou l'attribut connectionstring, mais pas les deux.
Il est fortement recommandé d'utiliser un nom de connexion plutôt qu'une chaîne de connexion pour simplifier la gestion multi-environnement.

Nœud `command`

Exemple de nom de chaîne de connexion

Fichier de transactions XMLTODATABASE :

Fichier `web.config` :

Emplacement du fichier XML de transactions

Il y a quatre possibilités différentes pour stocker la définition de la transaction d’une action de type XMLTODATABASE. Dans tous ces cas, la transaction doit être définie ainsi :

Pour trouver la définition de sa transaction une action de type XMLTODATABASE va effectuer une recherche dans l’ordre suivant :

Dans un paramètre nommé TRANSACTIONS_TEXT.
Dans un fichier dont le chemin est dans un paramètre nommé TRANSACTIONS_FILE.
Dans un fichier nommé MyTransaction.xml placé dans le dossier ..\App_Data\Files\XmlToDatabase.

L’ordre de priorité est donc :

Le paramètre TRANSACTIONS_TEXT.
Le paramètre TRANSACTIONS_FILE.
Le fichier MyTransaction.xml.

Définition d’une transaction dans le fichier commun

Le fichier de transaction commun nommé Transactions.xml se trouve dans le répertoire \wfgen\App_Data\Files\XmlToDatabase. L’application XMLTODATABASE effectue une recherche dans ce fichier pour trouver votre transaction.

L’action de type XMLTODATABASE contient les paramètres suivants :

TRANSACTION : Direction IN, type texte
XML : Direction IN, type fichier

Définition d’une transaction dans un fichier spécifique

Si la transaction ne se trouve pas dans le fichier Transactions.xml, l’application XMLTODATABASE effectue une recherche pour un fichier XML du même nom que votre transaction. La transaction devrait être créée dans le fichier MyTransaction.xml.

L’action de type XMLTODATABASE a les mêmes paramètres que pour un fichier commun.

Vous pouvez déplacer la définition de transaction d’un fichier commun à un fichier spécifique sans avoir à modifier la définition de processus en supprimant la transaction du fichier Transactions.xml et ensuite le copier dans un fichier du même nom que votre transaction.

Dans une donnée de type fichier

Si vous ne pouvez pas accéder au dossier ..\App_Data du serveur Web, ou si vous souhaitez inclure votre transaction dans la définition de votre processus (pour pouvoir l’exporter et le partager par fichier XPDL), vous pouvez écrire votre transaction dans une donnée de type fichier de votre processus. Pour ce faire :

Créez une donnée de type fichier contenant votre transaction.
Éditez votre action de type XMLTODATABASE puis ajoutez un nouveau paramètre nommé TRANSACTIONS_FILE et liez-le à la donnée précédemment créée.

Dans une donnée de type texte

À partir de la version 7.15.0 de WorkflowGen, la transaction XML contenue dans les données de processus de type TEXT n'a plus de limite de 4 000 caractères pour la base de données MS SQL Server.

Pour ce faire :

Créez une donnée de type texte contenant votre transaction.
Éditez votre action de type XMLTODATABASE puis ajoutez un nouveau paramètre nommé TRANSACTIONS_TEXT et liez-le à la donnée précédemment créée.

Format des champs dates et numériques

Vous pouvez indiquer à l’application la liste des champs qui doivent avoir un format date ou numérique.

Les paramètres supplémentaires suivants peuvent être utilisés dans les actions qui utilisent XMLTODATABASE:

Format date généré dans les requêtes SQL

Les champs de type date sont formatés comme ci-après : yyyy-mm-dd hh:MM:ss

Format numérique généré dans les requêtes SQL

Les champs de type numérique sont formatés comme ci-après : XXXX.XX

📌 Exemple

Règle : Tous les nœuds trouvés dans le document XML avec le nom REQUEST_DATE et le nœud spécifique situé à /MyData/MonExemple/Champ_Date seront formatés comme des dates.
- Méthode : XML_FIELDS_DATE = //*/REQUEST_DATE, /MyData/MyExample/Date_Field

Détails de l’exécution de la transaction

Les commandes SQL peuvent être exécutées dans des transactions. Si des erreurs interviennent, un « rollback » est exécuté et l’état initial de la base de données est restauré. La valeur de l’attribut transaction du nœud database doit être réglée sur yes.

Si la transaction agit sur plusieurs bases de données, l’exécution des commandes sera multi-transactionnelle : si une erreur intervient dans une commande d’une des bases de données, une restauration générale sera exécutée sur la transaction en question.

Mode test

Les transactions peuvent être testées avant d’être lancées sur les bases de données. La valeur de la constante XmlToDatabaseTestMode dans le fichier de configuration doit être réglée sur Y.

Si cette constante est réglée sur yes et que vous avez spécifié l’usage des transactions sur les nœuds de la base de données, les transitions ne seront pas confirmées (committed) à la fin de l’exécution.

Description du fichier log

Si le paramètre XmlToDatabaseEnableTrace dans le fichier web.config du service Web est réglé sur Y, un fichier de log sera généré dans le répertoire \wfgen\App_Data\LogFiles\XmlToDatabase.

Les entrées du log sont au format suivant :

Date; [Database name;] Transaction name; SQL query; Execution result

Les valeurs execution result sont :

Si la requête a été exécutée avec succès : OK
Si une erreur est intervenue : ERROR : code erreur – description

📌 Exemples

Erreurs d’exécution possibles

Les erreurs suivantes peuvent intervenir lors de l’exécution des transactions :

Exemples d’export

📌 Exemple 1

Structure du fichier XML :

Le nœud command pourrait ressembler à ceci :

La balise XPATH: dans la requête sera remplacée par /data/ qui est la valeur de l’attribut XPath.

La balise PARAM: est utilisée pour identifier un paramètre WorkflowGen à la place d’utiliser un champ XML.

Les XPath ne retournant pas de nœuds utiliseront les valeurs null.
Il n’est pas possible d’utiliser le XPath factorisé en utilisant XPATH:: à la place de XPATH:.

📌 Exemple 2

Voici un exemple plus complexe utilisant la propriété loop.

Structure du fichier XML :

Le nœud command pourrait ressembler à ceci :

Vous devez utiliser deux caractères : (deux points) lorsque vous ne voulez pas utiliser le XPath factorisé dans le nœud command (voir l’exemple ci-dessus).

<transactions>
    <transaction name="">
        <databases>
            <database name="" connectionstring="" provider="" transaction="">
                <command type="" loop="" xpath="">
                [REQUÊTE ICI]
                </command>
            </database>
        </databases>
    </transaction>
</transactions>

..
<connectionStrings>
    <add name="MYDBSOURCE" connectionString="Data Source=MYSQLSERVER;Initial Catalog=MYDB;User ID=user;password=pwd;" providerName="System.Data.SqlClient"/>
<connectionString>
...

<command type="INSERT" loop="no" xpath="/data/">
    INSERT INTO EXAMPLE (request_number, request_first_name, request_last_name, request_date)
    VALUES (
        {XPATH:request_number},
        {'XPATH:request_first_name'},   
        {'XPATH:request_last_name'},
        {'PARAM:REQUEST_DATE'})
</command>

<Library>
    <publishers>
        <publisher>Grasset</publisher>
    </publishers>
    <AUTHORS>
        <author id="100">
            <name>Stephen King</name>
            <description>Auteur de livres d’horreur</description>
            <birth_date>1947-09-21</birth_date>
        </author>
        <author id="200">
            <name>Jean Sologne</name>
            <description>Description de l’auteur</description>
            <birth_date>1972-06-06</birth_date>
        </author>
    </AUTHORS>
    <BOOKS>
        <book id="38">
            <title>Titre du livre no°38</title>
            <description>Description du livre n°38</description>
            <author id="100"/>
        </book>
        <book id="39">
            <title>Titre du livre n°39</title>
            <description>Description du livre n°39</description>
            <author id="200"/>
        </book>
        <book id="40">
            <title>Titre du livre n°40</title>
            <description />   // Insérera une valeur NULL automatiquement</span>
            <author id=""/>   // Insérera une valeur NULL automatiquement</span>
        </book>
    </BOOKS>
</Library>

<command loop="yes" type="INSERT" xpath="/Library/AUTHORS/">
    INSERT INTO AUTHORS
        ([AUTHOR_ID],[AUTHOR_NAME],[AUTHOR_DESC],[AUTHOR_PUBLISHER])
    VALUES ({XPATH:author/@id},
        '{XPATH:author/name}',
        '{XPATH:author/description}',
        '{XPATH::/Library/publishers/publisher}’ )
</command>
<command loop="yes" type="INSERT" xpath="/Library/BOOKS/">
    INSERT INTO BOOKS 
        ([BOOK_ID],[BOOK_TITLE],[BOOK_DESCRIPTION],[BOOK_AUTHOR_ID])
    VALUES ({XPATH:book/@id},
        '{XPATH:book/title}',
        '{XPATH:book/description}',
        '{XPATH:book/author/@id}')
</command>

FORM_ARCHIVE est requis pour les actions EFORMASPX uniquement.

Formulaire

Écran formulaire de processus

Mode éditeur

Éditeur ASP.NET

Cliquez sur ASP.NET dans la barre d'outils pour ouvrir l'éditeur de code ASP.NET, qui peut être utilisé pour définir des procédures côté serveur, des événements et des variables globales pour gérer des tâches personnalisées spécifiques. Cette fonctionnalité est principalement destinée au développement côté serveur ASP.NET.

À partir de la version 7.19.0 de WorkflowGen, tous les fichiers default.aspx sont enregistrés avec la propriété Page Async réglée sur true (p.ex. <%@ Page Async="true" ... %>). Cela permet le développement de formulaires Web ASP.NET asynchrones (voir l'article Microsoft pour plus d'informations).

Éditeur JavaScript

Cliquez sur JS dans la barre d'outils pour ouvrir l'éditeur de code JavaScript, qui peut être utilisé pour définir des procédures côté serveur, des événements et des variables globales pour gérer des tâches personnalisées spécifiques. Cette fonctionnalité est principalement destinée au développement côté client JavaScript.

Fonctionnalités avancées

Mode d'édition de code côté serveur

Cochez Activer le mode d'édition de code côté serveur dans l'onglet Général du panneau Configuration du formulaire pour activer ce mode, qui permet aux concepteurs de formulaires de modifier le contenu de la balise de serveur runat (p.ex. <script runat="server") et de la balise de script JavaScript (p.ex. <script jseditor="true">) avec Visual Studio Professional ou Visual Studio Code directement dans le fichier default.aspx généré sur le serveur (normalement situé dans le dossier \wfapps\webforms[PROCESSNAME]\V[VERSION]).

Les éditeurs de code ASP.NET et JavaScript sont désactivés lorsque le mode d'édition côté serveur est activé.

Vous devez enregistrer le formulaire sur l'écran Formulaire de WorkflowGen chaque fois que vous faites des modifications au code d'un script dans le fichier default.aspx afin de maintenir à jour les balises de script HTML du formulaire (FORM_HTML). Ceci est obligatoire avant de pouvoir exporter la définition de processus XPDL pour le déploiement sur un autre serveur.

Mode AJAX

Si vous utilisez l'éditeur de formulaire, vous pouvez activer le mode AJAX en cochant Activer le mode AJAX dans l'onglet Général du panneau Configuration du formulaire.

Lors de l'ajout d'un contrôle personnalisé (par exemple, un bouton pour gérer la soumission de formulaire), vous devez enregistrer l'ID de contrôle en tant que contrôle de publication (« postback ») dans l'objet ScriptManager de l'événement Page_Load. Par exemple :

Barre d’outils

Mode éditeur

Éditeur ASP.NET

Éditeur JavaScript

Configuration du formulaire

Onglet Général

Onglet Références Web

Onglet Traductions

Conditions et exceptions

Édition d’une condition

Cet écran permet l’édition de la condition qui sera évaluée lors de la transition vers l’action suivante. Le bandeau situé au-dessus de la zone de saisie permet l’édition rapide et fiable de la syntaxe de l’expression de la condition. N’importe quelle expression JavaScript ou VBScript avec une syntaxe correcte peut être insérée en tant que condition (choisissez JavaScript ou VBScript à côté de Langue). La syntaxe est vérifiée lors de l’enregistrement ou en cliquant le bouton Vérifier la syntaxe.

Cette implémentation de JavaScript est basée sur ECMAScript 3.5.
Dans JavaScript, les unités de temps sont exprimées en millisecondes :
- 1 minute = 60 000 millisecondes (1 * 60 * 1000 = 60000)

Fonctions

Vous pouvez appuyer sur Ctrl+Espace ou Alt+Espace directement dans l'éditeur pour afficher une liste déroulante depuis laquelle vous pouvez insérer des données de processus et des macros WorkflowGen, au lieu de les choisir depuis les listes déroulantes Données et Macros en haut de l'éditeur.

IIFE

En mode JavaScript, utilisez le bouton Fnc() pour encapsuler la condition dans une expression de fonction appelée immédiatement (IIFE). Par exemple :

Exemples

Donnée de processus égal à Lorem ipsum :
- JavaScript : <DATA> == "Lorem ipsum"
- VBScript : <DATA> = "Lorem ipsum"

Règles des conditions

Vous ne pouvez créer qu’une seule condition par transition. Pour créer des conditions additionnelles entre les mêmes actions, créez des transitions additionnelles entre les actions et placez-y les conditions additionnelles.
Vous ne pouvez pas créer plus d’une condition ou exception sur une transition.
Chaque condition est évaluée individuellement. Par exemple, s’il y a deux conditions sur des transitions séparées entre actions, et les deux sont TRUE, la prochaine action sera créée deux fois.

Édition d’exceptions

Règles d’exception

Vous ne pouvez créer qu’une seule exception par transition. Pour créer des exceptions additionnelles entre les mêmes actions, créez des transitions additionnelles entre les actions et placez-y les exceptions additionnelles.
Vous ne pouvez pas créer plus d’une exception ou condition sur une transition.
Chaque exception est évaluée individuellement. Par exemple, s’il y a deux exceptions sur des transitions séparées entre actions, et les deux exceptions interviennent, la prochaine action sera créée deux fois.

protected void Page_Load(object sender, EventArgs e)
{
    base.Page_Load(sender, e);    
    
    // Register the custom button to the script manager for postback management in AJAX mode
    if (ScriptManager.GetCurrent(this) != null) {
        ScriptManager.GetCurrent(this).RegisterPostBackControl(ACTION1_BUTTON1);
    }
}

Macros

Aperçu

Les macros suivantes peuvent être insérées dans les conditions de la transition ou dans les paramètres supplémentaires des applications de type action. Elles seront remplacées par leur valeur lors de l’exécution du processus.

Liste des macros

* champ : Voir le tableau suivant.

Suffixes des macros utilisateurs

Utilisation des macros

Vous pouvez utiliser les macros dans les transitions et les conditions des notifications supplémentaires ou dans les paramètres des actions. Pour envoyer la valeur de la macro dans la valeur du paramètre, sélectionnez une macro dans la liste ou concaténez des codes de macros dans une valeur texte.

📌 Exemple 1

Si vous voulez envoyer le nom d’utilisateur (username) du demandeur dans le champ REQUESTER_USERNAME de l’action, vous devez ajouter un paramètre supplémentaire avec les propriétés ci-dessous :

Nom du paramètre : REQUESTER_USERNAME
Envoyer la valeur d’une macro : Requester.Username

📌 Exemple 2

Si vous voulez envoyer le nom et le prénom du demandeur dans le champ REQUESTER_NAME de l’action avec une espace entre les deux, vous devez ajouter un paramètre supplémentaire avec les propriétés ci-dessous :

Nom du paramètre : REQUESTER_NAME
Envoyer la valeur d’un texte : <WF_REQUESTER_FIRSTNAME> <WF_REQUESTER_LASTNAME>

Macros des données de type fichier

Accès aux propriétés du fichier

Dans la transition ou les conditions de notification, vous pouvez utiliser les macros suivantes sur les données de processus de type fichier pour accéder aux propriétés du fichier.

Exemples de syntaxe

Considérant une donnée de type fichier appelée MON_FICHIER.

📌 Exemple 1

Règle : Vérifier si le nom du fichier contient le mot clé rapport
- Méthode : InStr(1,<MON_FICHIER.FILENAME>,"rapport",1) <> 0

📌 Example 2

Règle : Vérifier si la taille du fichier est inférieure à 1 Mo
- Méthode : <MON_FICHIER.SIZE> < 1024

📌 Exemple 3

Règle : Vérifier si le fichier est un document MS Word :
- Méthode : <MON_FICHIER.CONTENTTYPE> = "application/msword"

📌 Exemple 4

Règle : Vérifier si le fichier a été modifié aujourd’hui :
- Méthode : <MON_FICHIER.DATELASTMODIFIED> > [Date]

Vérification de l’existence d’un fichier

Vous pouvez également utiliser le nom de la donnée pour vérifier si le fichier existe dans le processus en utilisant la fonction IsNull().

📌 Exemple

Considérant que la donnée de type fichier appelée MON_FICHIER, vous pouvez utiliser la syntaxe ci-dessous dans une condition pour vérifier si le fichier existe :

IsNull(<MON_FICHIER>)

Exemples de macros

Le tableau suivant montre des exemples des macros énumérées ci-dessus.

Macros de paramètres d'application de configuration Web

Cette fonctionnalité permet de simplifier le déploiement des processus métiers dans un environnement WorkflowGen multi-instance en vous permettant de définir des données communes ou des données spécifiques à une instance en tant que paire clé-valeur pouvant être utilisée dans votre processus au moyen d'une macro dans les paramètres d'action, dans des conditions de transition pour contrôler le flux et dans des notifications d’action au lieu de coder en dur ces données dans la définition du processus.

Vous pouvez créer vos propres macros en définissant des paramètres d'application personnalisés dans le fichier de configuration Web de WorkflowGen.

Vous devez utiliser le paramètre de configuration EngineMacroAppSettings pour définir vos macros personnalisées. Vous pouvez spécifier le nom de clé exact ou utiliser un préfixe suivi de * (astérisque), comme indiqué dans l'exemple ci-dessous, qui ajoute les trois macros personnalisées (<WF_APP_SETTING_MySecretKey1>, <WF_APP_SETTING_MySecretKey2> et <WF_APP_SETTING_MySecretKey3>).

📌 Exemple

Les macros <WF_APP_SETTING_MySecretKey1>, <WF_APP_SETTING_MySecretKey2> et <WF_APP_SETTING_MySecretKey3> seront disponibles au moment du design et de l'exécution (runtime) avec le paramétrage de l'application ci-dessous dans le web.config :

Synchronisation des annuaires

Aperçu

Le module Synchronisation des annuaires fournit une manière efficace de synchroniser les utilisateurs et groupes de WorkflowGen avec un ou plusieurs annuaires d’entreprise.

Quelques points clé concernant la synchronisation :

La synchronisation peut être manuelle ou automatique.
L’annuaire prédéfini WORKFLOWGEN ne peut pas être synchronisé.
L’identifiant « Username » d’un utilisateur doit être unique dans l’ensemble des annuaires WorkflowGen.
Vous pouvez synchroniser plusieurs annuaires ou plusieurs portions d’un annuaire avec des connecteurs différents.
En cas de suppression d’un compte, l’utilisateur est archivé ou désactivé selon le paramètre spécifié. Si l’option d’archive est sélectionnée, le « Username » est renommé avec une nomenclature spécifique et le compte est désactivé.

Recommandation concernant le mode de licence par utilisateur

Il est suggéré de synchroniser les nouveaux comptes utilisateurs avec l’option Statut par défaut d’un nouvel utilisateur définie en Inactif. Les nouveaux comptes peuvent être ultérieurement activés par l’administrateur manuellement dans la liste utilisateur/groupe ou automatiquement en utilisant la fonctionnalité d’auto-activation.

Usage général

Accès au module de synchronisation

L’accès au module de synchronisation est seulement accordé aux utilisateurs avec des profils d'administrateur.

Description des paramètres de synchronisation

Dans l’interface du module d’administration de WorkflowGen, il est possible de lister et d’ajouter des synchronisations d’annuaires, et d’en modifier les paramètres.

À la création d’une nouvelle synchronisation basée sur Active Directory, le protocole LDAP, ou en mode texte, les champs suivants vont apparaître pour définir la méthode de synchronisation.

Une fois enregistré, il n'est plus possible de modifier le connecteur de répertoire.

Séparateur

Pour le connecteur texte, il est possible de spécifier le caractère de séparation de colonne dans le fichier texte. Par défaut, la valeur est ; (point-virgule), mais elle peut être également , (virgule) ou bien TAB (dans le cas du caractère de tabulation).

Chemin des fichiers

Ce champ permet de spécifier un chemin pour accéder aux fichiers pour le connecteur texte. Il prend pour valeur le chemin où se trouvent les fichiers, suivi du nom de la synchronisation.

Le nom de la synchronisation sert à nommer les fichiers.

Chemin LDAP

Dans le cas des connecteurs Active Directory et LDAP, un chemin LDAP est nécessaire pour accéder aux données.

Requête de synchronisation des utilisateurs

Pour un connecteur d’annuaire de type LDAP, il faut spécifier une commande LDAP afin d’interroger les comptes utilisateurs.

Requête de synchronisation des groupes

Pour un connecteur d’annuaire de type LDAP, il faut spécifier une commande LDAP afin d’interroger les groupes.

L’annuaire à importer peut nécessiter un login et un mot de passe lors de son accès par le connecteur.

Recherche en profondeur

Pour les connecteurs d’annuaires, préciser si la synchronisation devrait inclure seulement le conteneur des unités organisationnelles (OU) ciblés ou s’il devrait aussi inclure tous les enfants des OU ciblés.

Données à synchroniser

Dans WorkflowGen, il est possible de synchroniser les groupes et les utilisateurs. La synchronisation des utilisateurs est obligatoire, mais la synchronisation des groupes peut être activée ou non.

Avec la synchronisation LDAP, une requête de groupe doit être définie même si la synchronisation de ce groupe n’est pas activée.

Champ de synchronisation des utilisateurs

Pour effectuer la synchronisation le module se base sur un champ pour identifier les utilisateurs, et définir les ajouts, suppressions ou mises à jour. Il vous est possible de choisir parmi n’importe quel champ de WorkflowGen (ex. : Ads_Path ; EMPLOYEENUMBER) à condition que celui-ci soit traité par le connecteur.

Champ de synchronisation des groupes

De même que pour les utilisateurs, le champ de synchronisation des groupes est paramétrable.

Préfixer le nom d’utilisateur par

Pour faciliter les imports et éviter dans certains cas les doublons sur les noms d’utilisateurs, il est possible de préfixer le nom des utilisateurs par une chaîne de caractères. 📌 Exemple : Domaine\

Préfixer le nom d’un groupe par

Type de synchronisation des utilisateurs

Il existe trois modes de synchronisation : Ajout uniquement permet de ne faire que des ajouts des nouveaux utilisateurs. Ajout et modification permet de mettre à jour les données des utilisateurs déjà existants. Ajout, modification et suppression ajoute la possibilité d’archiver ou de supprimer les utilisateurs de WorkflowGen qui ne font pas partie de l’annuaire importé.

Ajout uniquement : Lors d’une synchronisation, tous les utilisateurs présent dans l’annuaire à importer, et qui n’existe pas dans l’annuaire de WorkflowGen, sont ajoutés à l’annuaire de WorkflowGen. Les données des utilisateurs existants ne seront pas modifiées. Afin d’être ajouté, un utilisateur doit au moins posséder un nom d’utilisateur (USERNAME), et un nom (LASTNAME). Si cette condition n’est pas respectée, une erreur se produit et l’ajout est annulé. Afin d’utiliser les utilisateurs de WorkflowGen, le prénom (FIRSTNAME) et l’adresse email (EMAIL) sont indispensables. Si une de ces valeurs est manquante, une alerte (WARNING) est créée. L’importation a bien lieu, mais il est recommandé d’agir afin que les utilisateurs concernés possèdent toutes leurs données.

Pour permettre un bon suivi des utilisateurs, dans WorkflowGen, en cas de demande de suppression, les utilisateurs ayant effectués des actions ne sont pas réellement supprimés mais sont au choix soit désactivés, soit archivés.

Type de synchronisation des groupes

Il existe trois modes de synchronisation. Le premier permet de ne faire que des ajouts des nouveaux groupes. Le deuxième permet de mettre à jour les données des groupes déjà existants. Et enfin, le troisième ajoute la possibilité d’archiver ou de supprimer les groupes de WorkflowGen qui ne font pas partie de l’annuaire importé.

Statut par défaut d’un nouvel utilisateur

Cette option définit le statut par défaut des nouveaux comptes utilisateurs qui ont été créés durant la synchronisation. Définissez le statut Actif si vous souhaitez que le nouveau compte utilisateur soit activé par défaut. Définissez le statut comme Inactif si vous souhaitez gérer manuellement l’activation des nouveaux comptes utilisateurs ou permettre la fonctionnalité d’auto-activation des utilisateurs (recommandé pour les clients qui utilisent le mode de licence par utilisateur).

Auto-activation

Cette option permet à un nouveau compte utilisateur qui est inactif de s’activer lui-même lors de sa première connexion à WorkflowGen. Le statut par défaut d’un nouvel utilisateur en Inactif doit être sélectionné en vue d’utiliser cette option.

Si un utilisateur est supprimé

En vue de proposer une gestion du suivi efficace dans WorkflowGen, quand une demande de suppression d’un utilisateur est réalisée, les utilisateurs qui ont réalisés des actions ne sont pas véritablement supprimés; vous avez le choix de les désactiver ou de les archiver. En cours d'archivage, l'utilisateur conserve son ID interne unique mais son nom d'utilisateur sera renommé avec le suffixe ARCHIVED_ suivi de son nom d’utilisateur.

Méthode de déclenchement

Le déclenchement peut se faire de façon manuelle (grâce au bouton Synchroniser) ou bien de façon automatique.

Manuelle : Permet d’effectuer la synchronisation que de façon manuelle. Pour cela, cliquez sur le bouton Synchroniser.
Test : Ce mode possède le même mode d’exécution que la synchronisation manuelle, mais le traitement n’est pas réellement effectué. Il s’agit d’une simulation qui permet d’anticiper si une synchronisation va se dérouler correctement ou non. Pour, cliquez sur le bouton Tester. Une synchronisation de test est enregistrée de la même façon qu’une synchronisation réelle.
Automatique : La synchronisation des données peut se faire de façon automatique. Une tâche planifiée analyse quotidiennement la configuration de toutes les synchronisations et effectue les traitements en fonction de la configuration de chacune des synchronisations.

Fréquence

Vous pouvez choisir la fréquence de la synchronisation pour les déclenchements automatiques : soit quotidien, hebdomadaire ou mensuel. Pour une synchronisation automatique, référez-vous à la section pour spécifier les dates et heures spécifiques d’opération.

Connecteur Active Directory

Aperçu

Le connecteur a pour but d'importer les utilisateurs et les groupes d'un annuaire Active Directory dans un annuaire WorkflowGen. Le connecteur fonctionne avec le protocole LDAP en utilisant ADSI (« Active Directory Service Interface »). L'accès à l'annuaire Active Directory se fait uniquement en lecture seule.

Prérequis

Un accès LDAP en lecture sur l'annuaire Active Directory doit être possible pour le compte anonyme ou pour un compte utilisable par le connecteur. Si le serveur Active Directory se trouve derrière un pare-feu, le protocole LDAP doit être ouvert.

Vous pouvez utiliser l'utilitaire ADSVIEW (disponible gratuitement de Microsoft) pour vérifier que le chemin LDAP que vous utilisez pointe bien vers les utilisateurs et les groupes à synchroniser.

Chemin LDAP

Le connecteur nécessite un chemin LDAP, afin de retrouver les données dans Active Directory. Le chemin LDAP est une chaîne de caractères composée de la séquence suivante :

Le protocole : dans notre cas LDAP://.
Le nom du serveur ou son adresse IP.
Facultativement, le port séparé du nom du serveur par :. Le port par défaut est 389.

Pour exécuter la requête nécessaire à la synchronisation des utilisateurs, il faut lui préciser l'Organisation (O) et les Unités organisationnelles (OU) en partant du bas vers le haut en les précédant de DC= et en les séparant par des , (virgules).

📌 Exemple

Si la structure LDAP est la suivante :

Domaine de premier niveau (DC) : monorganisation.com
Unité organisationnelle (OU) : groupe à l’intérieur du domaine : Unité2
Sous-groupe (OU) : sous-groupe avec le domaine :

Pour accéder aux utilisateurs et groupes de Département TI, le chemin LDAP devrait être :

Le chemin LDAP ne supporte pas l’opérateur . mais supporte les espaces dont le .com est identifié par l’opérateur DC=com.

La CN est également supporté comme type de récipient.
Seulement une branche de l'annuaire peut être associée à un annuaire. Si des OU multiples au même niveau doivent être utilisé, alors les parents des deux OU doivent être utilisés (sinon deux annuaires devront être créés séparément). Par exemple, si la structure /Organisation/Département1 et /Organisation/Département2

Pour plus d'informations, voir la section .

Données à importer

La synchronisation se fait pour les utilisateurs, mais il y a aussi la possibilité de synchroniser les groupes, et par conséquent les appartenances des utilisateurs aux groupes.

Les données concernées par l’import sont toutes les données qui font partie de l’OU ou du conteneur ciblé par le chemin. Il est possible d’importer également les utilisateurs des OU ou des conteneurs enfants, en activant la recherche en profondeur dans le panneau de configuration des synchronisations.

Le connecteur Active Directory ne prend pas en compte la propriété Désactivé des comptes utilisateurs AD; ces comptes seront donc synchronisés en tant qu'utilisateurs actifs. Si vous ne souhaitez pas que la synchronisation inclue les comptes AD inactifs, vous devrez utiliser le à la place, avec le filtre (!(userAccountControl:1.2.840.113556.1.4.803:=2))ajouté à la requête de synchronisation des utilisateurs. Assurez-vous également de définir le comportement souhaité pour l'option Si un utilisateur est archivé sur Archiver (par défaut) ou Désactiver chaque fois qu'un compte existant devient inactif dans AD.

Champs de synchronisation

Les champs de synchronisation par défaut sont :

Utilisateurs : Identificateur du système
Groupes : nom (sn)

Récupération des données d’Active Directory

Les informations sont récupérées dans l'annuaire Active Directory grâce au chemin LDAP. Il permet donc un accès en profondeur aux données, en ciblant l'OU dont on veut récupérer les utilisateurs et les groupes.

Voici ci-dessous un tableau de correspondance entre les champs de saisie d'un utilisateur et le nom des champs sous Active Directory. Ces correspondances ne peuvent pas être modifiées. Si vous souhaitez les modifier vous devez utiliser le connecteur d'annuaire LDAP (voir la section ).

Utilisateurs

Groupes

Connecteur LDAP

Aperçu

Le connecteur a pour but d'importer les utilisateurs et les groupes d'un annuaire générique (ex. : LDAP, AD, Sun ONE, ADAM, etc...) dans un annuaire WorkflowGen. Le connecteur fonctionne avec le protocole LDAP en utilisant ADSI (Active Directory Service Interface). L'accès à l'annuaire LDAP se fait uniquement en lecture seule.

Prérequis

Un accès LDAP en lecture sur l'annuaire LDAP doit être possible pour le compte anonyme ou pour un compte utilisable par le connecteur.

Si le serveur LDAP se trouve derrière un pare-feu, le protocole LDAP doit être ouvert.

Requêtes de synchronisation d’utilisateur et de groupes

Le connecteur nécessite un chemin LDAP, afin de retrouver les données dans Active Directory. Le chemin LDAP est une chaîne de caractères composée de la séquence suivante :

Le protocole : dans notre cas LDAP://.
Le nom du serveur ou son adresse IP.
Facultativement, le port séparé du nom du serveur par :. Le port par défaut est 389.

📌 Exemples

Si la structure LDAP est la suivante :

Domaine de premier niveau (DC) : monorganisation.com
Unité organisationnelle (OU) : groupe à l’intérieur du domaine : Unité2

Pour accéder aux utilisateurs et groupes de Département TI, il faut les chemins LDAP suivants :

Utilisateurs

Groupes

Pour utiliser un CN qui réfère deux groupes, le filtre suivant peut être utilisé :

Utilisateurs

Groupes

Seulement une requête d’utilisateurs et une requête de groupe peuvent être associées à un annuaire. Si des OU multiples au même niveau doivent être utilisés, le parent des deux OU devrait être spécifié, sinon on devra utiliser deux annuaires.
Par exemple, si la structure /Societe/Departement1 et /Societe/Departement2 /Societe/Departement3 existe, et seuls départements 1 et 2 doivent être interrogés, alors soit l’ensemble de l’UO /Societe

Références

Pour des exemples supplémentaires sur les requêtes génériques LDAP, référez-vous aux sites suivants :

Données à importer

La synchronisation se fait pour les utilisateurs. Mais il y a aussi la possibilité de synchroniser les groupes, et par conséquent les appartenances des utilisateurs aux groupes.

Pour synchroniser les utilisateurs, leurs attributs sn et sAMAccountName doivent être configurés en Active Directory. Ces attributs correspondent à Nom et Username, respectivement.

Champs de synchronisation

Les champs de synchronisation par défaut sont les suivants :

Utilisateurs : Identificateur du système

Groupes : Nom (sn)

Extraction des données LDAP

Voici ci-dessous un tableau de correspondances entre les champs de saisie d’un utilisateur et le nom des champs sous Active Directory, qui est supporté par ce mode de synchronisation. (Les autres genres de LDAP pourraient avoir une correspondance différente).

Si vous utilisez un connecteur LDAP, ces correspondances peuvent être modifiées en cliquant sur le bouton Correspondances dans la page de modification de l’annuaire.

Assurez-vous d'enregistrer les correspondances des champs chaque fois que vous ajoutez ou modifiez une requête LDAP.

Utilisateurs

Groupes

Connecteur texte

Aperçu

Le connecteur a pour but d'importer les utilisateurs et les groupes à partir de fichiers texte dans un annuaire WorkflowGen.

Prérequis

Le connecteur a besoin de trois fichiers textes :

User : Ce fichier doit contenir les données relatives aux utilisateurs devant être synchronisés.
Group : Ce fichier doit contenir les données relatives aux groupes devant être synchronisés.
Usergroup : Ce fichier doit contenir les relations d’appartenances entre les utilisateurs et les groupes synchronisés.

Données à importer

La synchronisation se fait pour les utilisateurs, mais elle peut aussi être activée pour les groupes. Pour cela il suffit de cocher la case correspondante dans la fiche de configuration de la synchronisation.

Sélection des fichiers

Les fichiers à importer ayant un suffixe standardisé, il vous suffit de saisir, dans « Chemin des fichiers », le chemin suivi de la partie commune au nom des trois fichiers.

📌 Exemple

Si vous décidez de nommer votre import importWfGen et que vous l’avez placez dans le répertoire DISQUE:\Extract\ vous devez avoir dans ce répertoire le fichier importWfGen_USER.txt, et si en plus vous décidez de synchroniser les groupes vous devez également avoir les fichiers importWfGen_GROUP.txt et importWfGen_USERGROUP.txt. Ainsi dans le paramétrage de la synchronisation, après avoir choisi le connecteur Text, saisissez DISQUE:\Extract\importWfGen dans « Chemin des fichiers » .

Noms des fichiers texte

Les fichiers d’import de données doivent être suffixés de la façon suivante :

Le fichier des utilisateurs doit se terminer par _USER.txt .
Le fichier des groupes doit se terminer par _GROUP.txt.
Le fichier d’appartenance des utilisateurs à un groupe doit se terminer par _USERGROUP.txt.

Le reste du nom de fichier doit être commun aux trois fichiers.

Structure des fichiers

Les fichiers textes commencent par la liste du nom des propriétés, séparées par un caractère définit dans les paramètres de la synchronisation.

Ensuite chaque ligne correspond à un enregistrement, c’est à dire à un utilisateur, avec les valeurs également séparées par le caractère de délimitation. Si une propriété est vide, celle-ci doit quand même être délimitée par le caractère de séparation.

Par défaut le délimiteur est ; (point-virgule).

Le séparateur , (virgule) ne peut être utilisé sur un serveur qui utilise ce caractère comme séparateur décimal (ex. : serveur français).

En ce qui concerne le fichier de l’appartenance des utilisateurs à un groupe, celui ne possède que deux champs. Il s’agit des champs de synchronisation des groupes et des utilisateurs. Le choix de ces champs s’effectue dans le module de synchronisation.

De plus il est possible de préfixé le nom de ces champs pour éviter les cas où le nom du champ de synchronisation des utilisateurs est le même que celui des groupes. Ce paramétrage ce fait dans le fichier de « config.inc » de la partie administrative du module de synchronisation.

Par exemple, si le champ de synchronisation des utilisateurs est Username et celui des groupes est Nom, le fichier doit contenir les champs GROUP_sAMAccountName et USER_sAMAccountName.

Chemin ADS

Si les informations textes sont exportées à partir d’un service AD, le connecteur a besoin du chemin LDAP afin de lui permettre de reconstruire la propriété ADSPATH pour les utilisateurs.

Liste des propriétés

Voici ci-dessous un tableau de correspondance entre les champs de saisie d’un utilisateur et le nom des champs tel qu’on doit les trouver dans le fichier texte. Ces correspondances peuvent être modifiées en cliquant sur le bouton Correspondances dans la page de modification de l’annuaire.

Utilisateurs

Groupes

Groupes d’utilisateurs

Ci-dessous sont les champs exigés pour le dossier de membre d'utilisateur de groupe :

Nom de champ de synchronisation pour les groupes (ex. : GROUP_SAMAccountName)
Nom de champ de synchronisation pour les utilisateurs (ex. : USER_SAMAccountName)

Exportation des fichiers textes avec Active Directory

Il est possible de produire un fichier d'exportation pour des données d'utilisateur en employant la commande suivante :

Avec MONSERVEUR étant le nom du serveur accueillant l'annuaire, file.CSV le nom du fichier résultant, OU=myOu,DC=monorganisation,DC=com le chemin du contenant en lequel vous voulez la liste d'utilisateurs.

Pour exécuter cette synchronisation automatiquement, ce process d'exportation de données doit être ajouté aux tâches planifiées du serveur avant que le script de synchronisation soit couru. Pour ajouter une tâche, voir la documentation d'administrateur pour le module de synchronisation. Cette méthode ne permet pas à des groupes d'être synchronisés.

Exemples de fichiers d’exportation

Fichier d’utilisateurs

Fichier de groupes

Fichiers d’association utilisateurs par groupes

Connecteur SCIM

Le connecteur SCIM vous permet de définir un nouveau répertoire qui sera utilisé par Azure Active Directory pour synchroniser les utilisateurs et les groupes. Pour des informations sur comment le configurer, voir la section dans le guide .

Fichiers log de la synchronisation

Aperçu

Les fichiers log de la synchronisation des annuaires sont paramétrés dans l’onglet du .

Chaque synchronisation manuelle ou automatique est enregistrée dans les fichiers log et est disponible pour visualisation aux administrateurs en sélectionnant dans le menu d’annuaires.

Par défaut, 31 jours de fichiers log sont entretenus. Ce paramètre peut être changé par l’administrateur dans le panneau de configuration.

Chaque fichier log contient les détails de chaque action de synchronisation effectuée incluant une liste de tous les utilisateurs et groupes ajoutés, modifiés, ou supprimés (archivés). Même les avertissements (ex. : adresses courriels manquantes) et les erreurs sont inclus. Les fichiers log peuvent être visualisés ou supprimés.

Emplacement des fichiers log

Les fichiers logs se retrouvent dans le serveur WorkflowGen sous le répertoire d’application \wfgen dans l’endroit suivant : \wfgen\App_Data\LogFiles\Dir\Synchro.

<configuration>
  <appSettings>
    <add key="MySecretKey1" value="4n(#N$HT0$Bohv!" />
    <add key="MySecretKey2" value="9et9tzV{Hnn]EsDE" />
    <add key="MySecretKey3" value="e#8BHvXa8N*LvFaY" />
    <add key="EngineMacroAppSettings" value="MySecretKey1, MySecret*" />
  </appSettings>
</configuration>

636

Département TI

/Organisation/Département3

/Organisation

Sub-unit (OU) : sous-groupe avec le domaine : Département TI

LDAP://monserveur:port/DC=monorganisation,DC=com;(&(objectCategory=person)(objectClass=user)(sn=*)(sAMAccountName=*)(memberOf=CN=TheSpecificCN,OU=LowestOU,OU=HigherOU,DC=the company,DC=com)(!(userAccountControl:1.2.840.113556.1.4.803:=2)));adsPath,objectSid,sAMAccountName,sn,GivenName,mail,telephoneNumber,mobile,pager,facSimileTelephoneNumber,department,company,EmployeeType,EmployeeId,title,initials,postalAddress,postalCode,physicalDeliveryOfficeName,st,L,co,manager;subtree

LDAP://monserveur:port/DC=monorganisation,DC=com;(&(objectCategory=person)(objectClass=user)(sn=*)(sAMAccountName=*) (memberOf=CN=TheSpecificCN,OU=LowestOU,OU=HigherOU,DC=the company,DC=com)(!(userAccountControl:1.2.840.113556.1.4.803:=2)));adsPath,objectSid,sAMAccountName,sn,GivenName,mail,telephoneNumber,mobile,pager,facSimileTelephoneNumber,department,company,EmployeeType,EmployeeId,title,initials,postalAddress,postalCode,physicalDeliveryOfficeName,st,L,co,manager;subtree

csvde -f file.csv -s MONSERVEUR -d "OU=myOu,DC=monorganisation,DC=com" -p subtree –r "(objectClass=OrganizationalPerson)" -l "ADsPath,cn,displayName,givenName,sn,sAMAccountName,mail, telephoneNumber,mobile, pager,facSimileTelephoneNumber,physicalDeliveryOfficeName,department,company, initials,title,employeeID,employeeType,postalAddress,postalCode,l,st,co,personalTitle"

sn;givenName;sAMAccountName;mail;  
"UTILISATEUR-01";"Patricia Stone";"pstone";"[email protected]";
"UTILISATEUR-02";"John Doe";"jdoe";"[email protected]";
"UTILISATEUR-03";"Jack Ryan";"jryan";"[email protected]";
"UTILISATEUR-04";"Abed Nadir";"anadir";"[email protected]";

Application de workflow EXECSQL

Aperçu

L'application de workflow EXECSQL vous permet d'exécuter une ou plusieurs requêtes SQL dans un processus.

Elle vous permet de récupérer des informations au travers de requêtes SELECT par exemple, afin de pouvoir utiliser le résultat dans des conditions du processus.

Mode de fonctionnement

L'application EXECSQL requiert les paramètres CONNECTION_NAME (qui correspond au nom de la connexion) et QUERY (qui correspond à la requête à exécuter).
Il est possible de spécifier une ou plusieurs commandes par action EXECSQL. Pour ceci, les paramètres doivent être préfixés par CMDx_, où x correspond au numéro de la commande (p.ex. : CMD1_).

Paramètres obligatoires

Paramètres facultatifs

Général

Si vous souhaitez alimenter un tableau à l'aide du paramètre FORM_DATA_GRIDVIEW, il est nécessaire que le contenu du FORM_DATA contiennent au moins le schéma XML.
Si la première action du processus est une action EXECSQL, vous devez mettre une valeur par défaut dans le FORM_DATA

Paramètres de requête

Il est possible de définir pour chaque requête des paramètres à utiliser lors de l'exécution. Les paramètres peuvent être définis de deux façons, soit en utilisant le préfixe QUERY_PARAM, soit en utilisant un arobase (@).

📌 Exemple

Vous pouvez utiliser QUERY_PARAM_MyParam ou @MyParam, où MyParam correspond au nom du paramètre défini dans la requête.

Paramètres de retour

Général

Requête `SELECT`

Requête `SCALAR`

Exemples

Requête `SELECT`

Stockage du retour dans des données

Alimentation d'un tableau

Dans le cas où EXECSQL est la première action du processus, vous devez définir une valeur par défaut pour la donnée FORM_DATA contenant le schéma du tableau comme dans l'exemple ci-dessous :

Requête `INSERT`

Voici une autre possibilité pour les paramètres de requête :

Requête `UPDATE`

Requête `DELETE`

Procédure stockée

Le type de requête PROCEDURE ne permet pas de retourner de valeur. Si vous souhaitez retourner une valeur, il faut utiliser le type SELECT.

Requête `SCALAR`

Lancement de plusieurs requêtes

Requêtes avec transactions et gestion des erreurs

<?xml version="1.0" standalone="yes"?>
<NewDataSet>
    <xs:schema id="NewDataSet" xmlns="" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
        <xs:element name="NewDataSet" msdata:IsDataSet="true" msdata:UseCurrentLocale="true">
            <xs:complexType>
                <xs:choice minOccurs="0" maxOccurs="unbounded">
                    <xs:element name="Table1">
                        <xs:complexType>
                            <xs:sequence>
                            </xs:sequence>
                        </xs:complexType>
                    </xs:element>
                    <xs:element name="REQUEST_GRID">
                        <xs:complexType>
                            <xs:sequence>
                                <xs:element name="REQUEST_GRID_LASTNAME" type="xs:string" minOccurs="0"/>
                                <xs:element name="REQUEST_GRID_FIRSTNAME" type="xs:string" minOccurs="0"/>
                                <xs:element name="REQUEST_GRID_USERNAME" type="xs:string" minOccurs="0"/>
                            </xs:sequence>
                        </xs:complexType>
                    </xs:element>
                </xs:choice>
            </xs:complexType>
        </xs:element>
    </xs:schema>
    <Table1></Table1>
</NewDataSet>

Application de workflow RESTAPICLIENT

Aperçu

L'application de workflow RESTAPICLIENT vous permet d'appeler des points de terminaison de l'API REST pour échanger des informations avec d'autres applications via des requêtes HTTP. Elle peut également être utilisée pour créer des intégrations avec des applications extensibles (telles que les services Azure et Slack).

RESTAPICLIENT vous permet également d'appeler un point de terminaison de l'API REST à l'aide de charges utiles application/json ou application/x-www-form-urlencoded. RESTAPICLIENT recevra et traitera ensuite la réponse de l'API externe en mappant le contenu de la réponse avec les paramètres OUT définis.

Mode de fonctionnement

L'application RESTAPICLIENT requiert le paramètre APP_URL, qui correspond au point de terminaison de l'API REST.
Le type de contenu du charge utile de demande par défaut (APP_REQUEST_CONTENT_TYPE) est application/json. Le type de contenu application/x-www-form-urlencoded est également supporté.

Paramètre obligatoire

Paramètres facultatifs

Général

Paramètres `APP_URL` facultatifs

📌 Exemple

Les paramètres définis ci-dessus généreront l'URL suivante dans APP_URL :

Paramètres d'en-tête

📌 Exemple

Les paramètres définis ci-dessus généreront deux en-têtes dans la charge utile de la demande :

Paramètres d'autorisation

L'application supporte également certains paramètres d'en-tête d'autorisation prédéfinis afin d'éviter d'ajouter ces paramètres d'en-tête HTTP avec le nom de paramètre APP_HEADER_xxx.

Un seul en-tête d'autorisation peut être défini, sinon une exception est levée.
APP_AUTH_BEARER_TOKEN équivaut à définir le paramètre d'en-tête APP_HEADER_Authorization.

Charge utile de demande

Il existe deux manières différentes de préparer la charge utile de demande. La première consiste à accéder à la totalité de la charge de demande (voir Définir la charge utile de la demande entière via un paramètre ci-dessous); la seconde consiste à créer le JSON ou l'URL codée via les paramètres IN (voir les sections Charge utile de demande encodée en URL et la Charge utile de demande JSON ci-dessous.

Définir la charge utile de demande entière via un paramètre

Les paramètres suivants peuvent être utilisés lorsque vous avez accès à l'ensemble de la charge utile de demande ou que le type de contenu de la demande n'est pas application/json ni application/x-www-form-urlencoded. Vous pouvez définir la charge de cette demande dans une donnée de type File ou Text ou directement dans la valeur de texte.

APP_REQUEST_CONTENT_FILEa la priorité sur APP_REQUEST_CONTENT.
APP_REQUEST_CONTENT a la priorité sur les paramètres IN utilisés pour créer une charge utile JSON ou encodée en URL.

Charge utile de demande encodée en URL

Les exemples suivants montrent comment créer une charge utile de demande avec application/x-www-form-urlencoded comme type de contenu.

Charge utile de demande en URL standard

Les paramètres suivants sont utilisés pour créer une charge utile de demande encodée en URL standard :

Les paramètres définis ci-dessus généreront la charge utile de demande suivante :

Charge utile de demande JSON encodée dans un nom de clé

Les paramètres suivants permettent de générer une charge JSON encodée dans un nom de clé :

Les paramètres définis ci-dessus généreront la charge utile de demande suivante :

Le paramètre APP_REQUEST_CONTENT_PAYLOAD_NAME est seulement supporté avec le type de contenu de demande application/x-www-form-urlencoded.

Charge utile de demande JSON

Les exemples suivants montrent comment créer une charge utile de demande avec application/json comme type de contenu.

Charge utile de demande JSON standard

Les paramètres suivants sont utilisés pour créer une charge utile de demande JSON simple :

Les paramètres définis ci-dessus généreront la charge utile de demande suivante :

Si vous souhaitez convertir ce JSON en tableau, vous devez définir la valeur du paramètre APP_REQUEST_CONTENT_IS_ARRAY sur Y.

Le paramètre APP_REQUEST_CONTENT_IS_ARRAY défini sur Y générera la charge utile de demande suivante :

Pour savoir comment créer un JSON plus complexe, voir les sections Définition d'un tableau JSON dans une propriété JSON et Définition d'un objet ou d'un tableau JSON dans une propriété JSON avec le paramètre de suffixe __JSON ci-dessous.

Définition d'un tableau JSON dans une propriété JSON

Pour définir un tableau dans une propriété JSON, vous devez définir le chemin de la propriété (par exemple, person.spokenlanguages) suivi du suffixe __X, où X est le numéro d'index du tableau.

Les paramètres suivants permettent de définir un tableau JSON dans une propriété JSON :

Les paramètres définis ci-dessus généreront la charge utile de demande suivante :

Si vous souhaitez définir un tableau JSON d'objets JSON (p.ex. "spokenlanguages": [{"spokenlanguage":"french"}, {"spokenlanguage":"english"}]) dans une propriété JSON, voir la section suivante.

Les paramètres du tableau seront ordonnés en fonction de leur numéro d'index.
Les numéros index n'ont pas de limite (p.ex. person.spokenlanguages__9999).

Définition d'un objet ou d'un tableau JSON dans une propriété JSON avec le paramètre de suffixe __JSON

Pour définir un objet / un tableau JSON dans une propriété JSON, vous devez définir le chemin de la propriété (p.ex. person.children) suivi du suffixe __JSON avec l'objet ou le tableau JSON comme valeur de paramètre.

Les paramètres suivants permettent de définir un objet ou un tableau JSON dans une propriété JSON:

Les paramètres définis ci-dessus généreront la charge utile de demande suivante :

Une exception sera levée si plusieurs propriétés JSON sont spécifiées dans les paramètres IN (p.ex. person.childrenetperson.children__JSON).
Le suffixe __JSON utilise

Charge utile de réponse

L'application supporte le mappage des paramètres OUT avec la réponse HTTP :

Mappage d'une charge utile de réponse JSON avec des paramètres OUT

L'application supporte également des paramètres OUT personnalisés supplémentaires pour mapper la charge utile d'une réponse JSON simple.

📌 Exemple

Charge utile de réponse JSON :

Les paramètres suivants permettront de mapper la charge utile de la réponse dans différentes données de processus :

Pour mapper des JSON complexes, voir la section suivante.

Mappage d'une charge utile de réponse JSON avec des paramètres OUT à l'aide du langage de requête JSONPath

L'application supporte le langage de requête JSONPath (similaire aux expressions XPath en XML). Ce langage vous permet d'extraire des données spécifiques d'un fichier JSON. Pour plus de détails sur la syntaxe JSONPath, voir .

📌 Exemple

Charge utile de réponse JSON :

Par exemple, nous voulons ici obtenir les noms des petits-fils de Charles âgés de plus de sept ans, et nous voulons également que ces noms soient séparés par un | (en utilisant le paramètre IN APP_JSONPATH_DELIMITER). Pour obtenir cette information, les paramètres suivants doivent être définis :

Dans le nom du paramètre PARAM1__JSONPATH, le nom de PARAM1 n'est pas pertinent, mais il doit être suivi du suffixe __JSONPATH (deux traits de soulignement sont utilisés dans le suffixe).

Exemple d'utilisation avec l'API Azure REST pour obtenir un jeton d'accès OAuth 2.0 et créer une rubrique Event Grid

Cet exemple montre comment obtenir un jeton d'accès et l'utiliser pour créer une rubrique Event Grid. Cela peut être fait en créant un processus avec deux actions ayant RESTAPICLIENT comme application. Le workflow ci-dessous illustre cet exemple :

Les sections suivantes décrivent les paramètres à déclarer pour chaque action.

Action `GET_TOKEN` : Obtention d'un jeton d'accès OAuth 2.0

Les paramètres suivants sont nécessaires pour obtenir un jeton d'accès afin d'utiliser l'API de gestion Azure Resource. Ce jeton sera stocké dans le paramètre OUT access_token et sera utilisé lors de la création d'une rubrique Event Grid dans la section suivante.

Les paramètres définis ci-dessus généreront la charge utile de demande suivante :

Voici la réponse de l'API Azure :

Le paramètre OUT access_token est mappé avec la propriété JSON access_token.

Pour plus d'informations sur l'obtention d'un jeton d'accès pour utiliser l'API de ressource Azure, voir .

Action `CREATE_TOPIC` : création d'une rubrique Event Grid

Les paramètres suivants sont nécessaires pour créer une rubrique Event Grid à l'aide de l'API de gestion des ressources Azure.

Les paramètres définis ci-dessus généreront la charge utile de demande suivante :

Voici la réponse de l'API Azure:

Pour plus d'informations sur la création d'une rubrique Event Grid et sur l'API Azure REST, voir .

Activation de SSL / TLS

En cas d'erreur Impossible de créer le canal sécurisé SSL / TLS, le chiffrement renforcé doit être activé en exécutant le code suivant dans PowerShell :

Redémarrez votre serveur IIS après avoir exécuté les commandes.

La méthode de requête HTTP de demande par défaut (APP_METHOD) est GET. D'autres méthodes de requête (POST, PUT, DELETE, etc...) sont également supportées.

La valeur par défaut de APP_JSONPATH_DELIMITER est une virgule (,) lorsque ce paramètre n'est pas défini.

{
    "person": {
      "name": "Elizabeth",
      "children": [
        {
          "name": "Charles",
          "age": 30,
          "children": [
            {
              "name": "Nathalie",
              "children": [
                {
                  "name": "George",
                  "age": 8
                },
                {
                  "name": "Charlotte",
                  "age": 10
                },
                {
                  "name": "Jefferson",
                  "age": 7
                }
              ]
            },
            {
              "name": "Harry"
            }
          ]
        },
        {
          "name": "Bob",
          "age": 20,
          "children": [
            {
              "name": "John"
            },
            {
              "name": "Mark"
            }
          ]
        }
      ]
    }
}

POST https://login.microsoftonline.com/a6e70c61-fabd-4885-89f7-97121e92db7f/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&client_id=b7e29e2f-6e2b-4375-9684-8151431d4ca6&client_secret=lxy/IwKyTedHUWMeeUtyCtu7/YUy0rNGoY3NNWXXotI=&resource=https://management.core.windows.net/

{  
   "token_type":"Bearer",
   "expires_in":"3600",
   "ext_expires_in":"3600",
   "expires_on":"1555951493",
   "not_before":"1555947593",
   "resource":"https://management.core.windows.net/",
   "access_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1d..."
}

PUT https://management.azure.com/subscriptions/235765d9-5d62-43f4-a730-2ed71a3f8adb/resourceGroups/dev-group-advantys/providers/Microsoft.EventGrid/topics/new-topic-example?api-version=2018-09-15-preview
Host: management.azure.com
Content-Type: application/json
Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsIng1d...
location: canadaeast

{  
   "properties":{  
      "provisioningState":"Creating",
      "endpoint":null
   },
   "location":"canadaeast",
   "tags":null,
   "id":"/subscriptions/994e2fc0-937d-4110-b355-e7473acef822/resourceGroups/dev-evt-grid/providers/Microsoft.EventGrid/topics/test-from-wfg",
   "name":"test-from-wfg",
   "type":"Microsoft.EventGrid/topics"
}

Set-ItemProperty -Path 'HKLM:\SOFTWARE\Wow6432Node\Microsoft\.NetFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Value '1' -Type DWord

Set-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\.NetFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Value '1' -Type DWord

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 .

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.

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.

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

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

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 :

Cet exemple remplace les éléments suivants :

La feuille de style par la feuille de style nommée metal.css

Vous pouvez avoir besoin de modifier la largeur et la hauteur dans le code .NET si vous changez d’image.

📌 Exemple :

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

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.

Gestion des outils personnalisés

Sélectionnez Gérer les outils personnalisés depuis la liste déroulante Outils.

Paramètres de section

Paramètres de la pièce jointe

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.

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.

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.

Paramètres de tableau

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

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

É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

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.

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+ "')";
}

updatetext

allowedextensions

displaymode

downloadlink

filesizelimit

showfilesize

controltocompare

operator

compareerrormessage

Single

String

UInt16

UInt32

UInt64

appenddatabounditems

spsdatasource

spsdatalist

spsdatavaluefield

spsdatatextfield

7.22

Guide d’administration de WorkflowGen

Module d'administration WorkflowGen

Aperçu

Gestion des utilisateurs

Aperçu

Annuaires

Écran annuaires

Liste des annuaires

Édition d’un annuaire

Suppression d’un annuaire

Délégations

Écran liste des délégations

Barre de menu

Informations globales

Aperçu

Catégories

Liste des catégories

Écran catégorie

Gestion

Cycle de vie du processus

Exemple de cycle de vie du processus

Migrer un processus

Sécurité

Application de workflow XMLTRANS

Aperçu

Mode de fonctionnement

Application de workflow UPDATEPROCESSDATA

Aperçu

Utilisation des paramètres par défaut

Numéro de la demande à modifier

Action

📌 Exemple

Application de workflow COMPLETEACTION

Aperçu

Paramètres

Demande

Action

Paramètres facultatifs

📌 Exemple

Application de workflow GETPROCESSDATA

Aperçu

Utilisation des paramètres par défaut

Numéro de demande

Action

📌 Exemple

Application de workflow GETFORMDATA

Aperçu

Application de workflow CANCELREQUEST

Aperçu

Paramètres

Application de workflow COPYDATA

Aperçu

Mode de fonctionnement

Application de workflow SENDMESSAGE

Aperçu

Mode de fonctionnement

Paramètres

Paramètres obligatoires

Paramètres facultatifs

URL WorkflowGen

Aperçu

Portail

Module d’administration

Panneau de configuration

Intégrations par l’entremise d’URL

Messages d'erreur

Licence

Gestion des utilisateurs

Aperçu

Guide d’administration de WorkflowGen

Informations globales

Aperçu

Annuaires

Écran annuaires

Liste des annuaires

Édition d’un annuaire

Suppression d’un annuaire

Module d'administration WorkflowGen

Aperçu