My Document - Documentation

Transcription

WorkflowGen 6.0
Module d’administration
Guide de référence
Date de mise à jour : le 15 juillet 2016
Copyright © Advantys 2016
www.workflowgen.com
Table des matières
Présentation
11
Aperçu du module d’administration
12
Accès au module d’administration
Authentification
Sélection de la langue
Structure du module d’administration
Bandeau
Workflow de processus
Gestion des processus
Gestion des utilisateurs
Panneau de configuration
Centre de ressources
Nomenclature
Securité
Suppression et archivage
Aperçu
Général
Base de données
Adresse
SMTP
Authentification
Sécurité
Horaires et jours de travail
Portail
Affichage
Demandes
Notifications utilisateurs
Délégation
Application hôte
Statistiques
Commentaires
Administration
Affichage
Utilisateur
Services Windows
Autres
Synchronisation annuaire
Logs
Synchronisation automatique
Autres
Diagnostique
Informations produit
License information
Assembly versions
12
12
12
13
14
18
20
20
21
21
21
22
22
23
23
24
24
25
25
25
26
26
27
27
29
30
30
30
30
31
32
32
32
32
32
33
33
33
33
34
34
34
34
Aperçu
Annuaires
Écran annuaires
Liste des annuaires
Édition d’un annuaire
Suppression d’un annuaire
Utilisateurs
Écran liste des utilisateurs
Écran utilisateurs
Barre de menu
Filtres
Liste des utilisateurs
Formulaire utilisateur
Remplacement
Rapport d’activité
Groupes
Écran liste des groupes
Barre de menu
Filtres
Liste des groupes
Écran groupes
Formulaire groupe
Suppression
Délégations
Écran liste des délégations
Barre de menu
Filtres
Liste des délégations
Écran d’édition d’une délégation
Édition d’une délégation
Ajout
Suppression
Versions de processus
Synchronisation des annuaires
Aperçu
Usage général
Accès au module de synchronisation
Description des paramètres de synchronisation
Connecteur Active Directory
Aperçu
Prérequis
Chemin LDAP
Données à importer
Champs de synchronisation
Récupération des données d’Active Directory
Connecteur LDAP
Aperçu
Prérequis
35
35
35
35
36
36
37
37
37
38
38
38
40
40
41
41
42
44
44
45
45
45
46
46
47
47
47
48
48
48
49
49
50
50
50
51
51
51
51
51
54
54
54
54
55
55
56
57
57
57
Requêtes de synchronisation d’utilisateur et de groupes
Extraction des données LDAP
Texte
Aperçu
Prérequis
Sélection des fichiers
Noms des fichiers texte
Structure des fichiers
Chemin ADS
Liste des propriétés
Exportation des fichiers textes avec Active Directory
Exemples de fichiers d’exportation
Fichiers log de la synchronisation
Aperçu
Emplacement des fichiers log
Informations générales
Aperçu
Participants
Écran liste des participants
Écran des participants
Barre de menu
Filtres
Liste des participants
Formulaire participant
Associations avec un annuaire
Modification du type de participant
Suppression
Applications
Écran des applications
Barre de menu
Filtres
Formulaire application
Écran liste des applications
Liste des applications
Écran liste des paramètres d’une application
Édition des paramètres d’une application
Suppression d’une application
Suppression d’un paramètre
Application de type assembly
Application de type service Web WCF
Services Web WSDL
Exemple d’un service Web privé
Action de service Web de WSDL : paramètres supplémentaires
Catégories
Liste des catégories
Écran catégorie
Barre de menu
Filtres
57
59
59
59
61
61
61
61
61
61
62
62
62
64
64
64
64
65
66
66
66
66
67
67
67
67
68
68
69
69
70
70
70
70
71
72
72
73
74
74
75
75
75
76
77
78
78
78
79
79
79
Formulaire catégorie
Suppression
Listes globales
Aperçu
Écran des listes globales
Barre de menu
Filtres
Liste de listes globales
Formulaire de listes globales
Importer des données
Exporter des données
Définition de processus
Aperçu
Dossier
Écran liste des dossiers
Barre de menu
Filtres
Liste des dossiers
Écran dossier
Formulaire dossier
Gestionnaire de processus
Suppression d’un dossier
Liste des processus
Écran liste de processus
Barre de menu
Filtres
Liste des processus
Édition d’un processus
Écran informations d’un processus
Barre de menu
Liens supplémentaires
Formulaire processus
Actions d’un processus
Suppression des demandes
Suppression d’un processus
Suppression des demandes d’un processus
Restrictions opérationnelles sur les processus avec un statut actif ou archivé
Modification d’un dossier
Catégories d’un processus
Exportation et importation de la définition XPDL d’un processus
Participants d’un processus
Écran liste des participants d’un processus
Association avec un annuaire
Suppression
Ajout d’un participant global
Demandeur d’un processus
Superviseur d’un processus
Modification du type d’un participant
79
79
80
80
80
80
81
81
81
81
82
83
84
84
85
85
86
86
86
86
86
87
87
87
87
87
87
88
88
88
89
89
90
91
92
92
92
93
93
94
94
98
98
98
99
100
101
101
101
101
101
Portée limitée des superviseurs
Aperçu
Définitions
Aide
Validation syntaxe des requêtes
Liste des champs et macros disponibles pour l’usage dans la requête
Informations supplémentaires
Opérateurs de comparaison
Opérateurs logiques et parenthèses
Valeurs texte
Données de processus
Macros
Impacts d’exécution
Données du processus
Écran liste des données
Liste des données
Formulaire d’édition de donnée
Édition de données
Modification du type de donnée
Suppression
Workflow
Écran du workflow d’un processus (vue liste)
Écran du workflow d’un processus (vue graphique)
Vue liste des actions
Vue graphique des actions
Ajout d’une action
Actions
Écran d’édition d’une action
Barre de menu
Édition d’une action
Suppression d’une action
Méthodes d’affectation
Écran liste des paramètres
Liste des paramètres obligatoires
Liste des paramètres supplémentaires
Écran d’édition d’un paramètre
Édition d’un paramètre
Écran des actions suivantes
Action suivante
Ajout d’une boucle sur la première action
Écran d’édition d’une condition
Édition des conditions d’une transition
Actions des conditions d’une transition
Ajout d’une condition
Écran des exceptions
Types d’exception
Règles d’exception
Écran de notification
Notifications automatiques
Notifications supplémentaires
Hiérarchie des notifications des actions en retard
Hiérarchie des notifications de pré-retard
102
102
102
102
103
104
106
106
106
106
106
107
107
108
108
108
109
110
114
114
115
115
115
115
116
117
119
119
119
120
122
122
126
127
127
128
128
130
130
131
131
131
132
132
133
133
133
134
134
135
136
136
Rapport
Écran rapport d’un processus
Erreurs et avertissements
Utilisation
Participants
Données
Actions
Formulaire
Écran formulaire de processus
Structure, apparence et gestion de formulaire
Barre d’outils
Configuration du formulaire
Styles
Outils
Paramètres de section
Paramètres de la pièce jointe
Paramètres des cases à cocher et boutons de radio
Paramètres des textes
Paramètres des listes et des listes déroulantes
Paramètres de tableau
Outil de contrôle d'utilisateur ASP.NET
Édition d’identifiant
Édition de l'info-bulle
Édition du format
Éditeur d’apparence
Définition du comportement
Gestion des correspondances
Enregistrement d’une section ou d’un champ comme outil
Gérer les outils personnalisés
Cycle de vie du processus
Application de workflow eFormASPX
Aperçu
Paramètres obligatoires
Utilisation des paramètres supplémentaires
Initialisation des champs
Capture des valeurs des champs
Paramètres supplémentaires modifiant les propriétés des champs du formulaire
Aperçu
Liste des paramètres disponibles
Exemples d’utilisation
Le paramètre supplémentaire FORM_ARCHIVE
Aperçu
Paramètre
Mode de fonctionnement
Application de workflow XmlToDatabase
Aperçu
Description du fichier XML
138
138
139
140
140
141
141
142
143
143
144
147
149
154
156
158
159
161
164
167
174
177
177
178
178
179
181
183
186
187
188
190
190
190
191
191
191
192
192
192
192
192
192
192
193
194
194
194
195
Aperçu
Structure
Emplacement du fichier XML de transactions
Définition d’une transaction dans le fichier commun
Définition d’une transaction dans un fichier spécifique
Dans une donnée de type fichier
Dans une donnée de type texte
Attributs
Format des champs dates et numériques
Détails de l’exécution de la transaction
Mode test
Description du fichier log
Erreurs d’exécution possibles
Exemples d’export
Application de workflow GetUsersFromDir
Aperçu
Définitions
Liste des champs et macros disponibles pour les requêtes
QUERY1_CMD : Exécution d’une requête SQL
RESULT_LIST / QUERYx_RESULT_LIST : Capture du résultat des requêtes
QUERY1_DIR: Définition de l’annuaire
QUERYx_CMD : Utilisation de plusieurs requêtes
QUERYx_TOP : Définition du nombre maximum d’enregistrements du résultat
QUERYx_DEFAULT_VALUE : Définition d’une valeur par défaut
QUERYRESULT_SEPARATOR : Définition d’un séparateur
RESULT_COUNT / QUERYx_RESULT_COUNT : Compteur du nombre d’enregistrements
retournés
Utilisation des paramètres dans les conditions des requêtes SQL
QUERYx_CMD : Utilisation des macros dans les conditions des requêtes SQL
RESULT_LIST_EMAIL / QUERYx_RESULT_LIST_EMAIL : Capture des résultats des
requêtes sous forme de liste d’emails
Gestion des erreurs dans WorkflowGen
Nombre maximum d’enregistrements retournés
Application de workflow XmlTrans
Aperçu
195
195
195
196
196
197
198
200
201
202
202
202
203
205
207
207
207
208
209
209
209
210
210
210
211
211
212
212
213
213
213
214
215
215
215
216
Application de workflow RaiseException
217
Aperçu
Utilisation des paramètres par défaut
Identifiant de la demande
Nom de l’action
Utilisation des paramètres optionnels
Liste des identifiants de demande
Liste des noms des actions
Nom d’utilisateur
217
217
217
217
218
218
218
218
Mot de passe
EXCEPTION_NAME
EXCEPTION_MESSAGE
Nom de l’action
Non prise en compte de l’erreur NOTHINGTODO
Application de workflow UpdateProcessData
218
219
219
219
219
219
220
220
222
Aperçu
Numéro de la demande à modifier
Action
222
222
222
222
Application de workflow CompleteAction
223
Aperçu
Numéro de demande
Action
223
223
223
223
Application de workflow GetProcessData
225
Aperçu
Numéro de demande
Action
225
225
225
225
Application de workflow GetFormData
226
Aperçu
Numéro de demande
Action
226
226
226
226
Application de workflow CancelRequest
227
Aperçu
Paramètres
Numéro de demande à annuler
Macros
Suffixes des macros utilisateurs
Utilisation des macros
Macros des données de type fichier
Accès aux propriétés du fichier
Exemples de syntaxe
Vérification de l’existence d’un fichier
Notifications personnalisées
Aperçu
227
227
227
228
229
230
230
230
231
231
232
232
Processus
Notifications des actions
Gabarits
Macros
URLs WorkflowGen
Aperçu
Portail
Intégrations par l’entremise d’URLs
Aperçu
Lancement d’un processus depuis une URL
Lancement de la première action d’un processus depuis un site Web différent
Lancement d’une action sans le portail WorkflowGen
Lancement d’une action depuis le portail WorkflowGen
Lancement d’une fiche de suivi de la demande sans le portail WorkflowGen
Lancement d’une fiche de suivi de l’action sans le portail WorkflowGen
Lancement d’un suivi graphique sans le portail WorkflowGen
Erreurs possibles
Menu personnalisés
Aperçu
Contenu XML
Exemple de fichier admin.xml
Portail d’utilisateur
Aperçu
Contenu XML
Exemple de fichier portal.xml
Portlet
Aperçu
URL et paramètres HTTP
URL
Paramètres
Sécurité
Format de spécifications RSS
Spécifications officielles
Exemple de contenu
Description des nœuds XML RSS
Liste des catégories disponibles
Erreurs possibles
Messages d’erreur
Licence
Sécurité
232
232
233
234
237
238
238
238
238
238
239
239
239
240
240
241
242
242
243
243
245
245
245
245
246
246
246
246
247
248
248
248
248
248
249
249
249
249
250
250
251
252
252
252
WorkflowGen 6.0 Module d’administration – Guide de référence
11
Présentation
L’objectif de ce guide est la description de tous les écrans du module d’administration de WorkflowGen. Vous
trouverez également la 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.
12
Aperçu du module d’administration
Le module d’administration de WorkflowGen est une application web dont les fonctions principales sont :
l
La gestion des annuaires, des groupes et des utilisateurs
l
La définition des processus et des informations globales
l
La définition des règles de sécurité en rapport avec les processus et les utilisateurs.
L’accès au module d’administration ainsi que son utilisation doivent être gérés avec prudence car les
fonctions disponibles sont très sensibles.
Accès au module d’administration
L’accès au module d’administration se fait à travers l’URL suivante : http://[votresite]
/wfgen/admin/default.aspx.
Notes
l
l
« default.aspx » est optionnel s’il est configuré comme document par défaut sur le site web.
« votresite » peut être un DNS ou une adresse IP (la recommandation est d’utiliser un DNS, car ceci peut
faciliter la transition à un nouveau serveur ou si vous migrez le site à une configuration « web farm »).
Authentification
Selon la méthode d'authentification choisie par les administrateurs de WorkflowGen, vous devrez indiquer un
nom d’utilisateur et un mot de passe quand vous ouvrez une session WorkflowGen. Ces données
correspondent à celles que vous utilisez quand vous ouvrez une session Windows.
Sélection de la langue
Vous pouvez choisir une langue dans la page d’accueil de l’écran de l’application. Si la liste n’est pas affichée
cela signifie que l’application a été configurée afin de n’utiliser qu’une seule langue. Le pays à côté de la
langue permet au système d’utiliser les paramètres régionaux appropriés dans l’application et plus
spécialement pour l’affichage des dates et des valeurs numériques.
Par exemple, English (United Kingdom) correspond à l’interface utilisateur en anglais avec des paramètres
régionaux du Royaume-Uni (format jj/mm/aaaa) tandis que English (United States) correspond à l’interface
utilisateur en anglais avec des paramètres régionaux des États-Unis (format m/j/aaaa).
Actuellement, vous pouvez choisir parmi la liste suivante des langues :
l
English (Australia)
l
English (Canada)
l
English (United Kingdom)
l
English (United States)
l
Français (Canada)
l
Français (France)
l
Français (Suisse)
l
Deutsch (Deutschland)
l
Deutsch (Schweiz)
l
Italiano (Italia)
l
Português (Portugal)
l
Español (España)
Structure du module d’administration
13
Bandeau
Cliquez sur Annuaires sur le bandeau pour accéder à l'écran Annuaires.
Cliquez sur Annuaires dans l'écran des annuaires pour ouvrir la liste des annuaires.
Cliquez sur Processus sur le bandeau pour ouvrir la liste des dossiers de processus.
14
Cliquez sur Participants sur le bandeau pour ouvrir la liste des participants.
Cliquez sur Applications sur le bandeau pour ouvrir la liste des applications.
15
Cliquez sur Catégories sur le bandeau pour ouvrir la liste des catégories.
16
Cliquez sur Listes globales sur le bandeau pour ouvrir la liste des listes globales.
Cliquez sur Portail sur le bandeau pour accéder au portail de workflow.
17
18
Workflow de processus
Dans le module d’administration, cliquez sur le nom d’un des processus listés pour accéder aux onglets
suivants relatifs au processus sélectionné :
l
Information
l
Participants
l
Données
l
Formulaire
l
Workflow (vue Graphique ou Liste)
Double-cliquez une action dans la vue Graphique, ou cliquez une action dans la liste des actions pour ouvrir
le formulaire d’édition d’une action, qui comprend les onglets suivants :
l
Infos
l
Paramètres
l
Actions suivantes
l
Notifications
L'écran de workflow de processus comprend également les liens suivants :
l
Plein écran
l
Rapport
l
Tester
19
20
Gestion des processus
Dans la section de gestion des processus du module d'administration, cliquez sur :
l
Process, pour accéder à la liste des dossiers et par la suite, la liste des processus d’un dossier ainsi qu’à
leur formulaire d’édition.
l
Participants, pour accéder à la liste des participants et par la suite éditer un participant.
l
Applications, pour accéder à la liste des applications et par la suite éditer une application.
l
Catégories, pour accéder à la liste des catégories et par la suite éditer une catégorie.
l
Listes Globales pour accéder à la liste des listes globales (voir Listes globales on page 80).
Dans la section de gestion des utilisateurs du module d'administration, cliquez sur :
l
l
Annuaires, pour accéder à la liste des annuaires, puis éditer un annuaire (voir Annuaires on page 35).
Utilisateurs, pour accéder à la liste des utilisateurs, puis éditer un utilisateur (voir Utilisateurs on page
37).
l
Groupes, pour accéder à la liste des groupes, puis éditer un groupe (voir Groupes on page 44).
l
Délégations, pour accéder à la liste des délégations (voir Délégations on page 47).
l
Logs de syncronisations, pour accéder à la liste des logs de syncronisation des annuaires syncronisés (voir Synchronisation des annuaires on page 51).
Le panneau de configuration comprend les onglets suivants :
l
Général
l
Portail
l
Administration
l
l
Diagnostique
l
Voir Panneau de configuration on page 23 pour de plus amples renseignements.
Centre de ressources
Cliquez sur Centre de ressources pour accéder au site communauté de WorkflowGen.
Nomenclature
La plupart du temps, les informations dans la base de données sont identifiées par un nom (en plus d’un
numéro interne dédié).
Pour des raisons techniques et de lisibilité, ces noms ne doivent contenir que des caractères, des
combinaisons alphanumériques, ou « - » et « _ » (sans espaces, sans accents).
L’administrateur peut limiter l’étendue des caractères à la table ANSI ou autoriser l’utilisation de tous les
caractères alphanumériques inclus dans la table étendue (Unicode).
Dans la section Administration du panneau de configuration, sélectionnez Restriction d’encodage des
données dans la section Affichage. Dans la plupart des cas, le nom ne doit pas dépasser 30 caractères.
21
22
Securité
L’accès au module d’administration est limité aux utilisateurs ayant un profil administrateur et aux utilisateurs
appartenant aux participants définis comme gestionnaire de dossier. Cependant, durant l’installation du
logiciel, le contrôle d’accès peut être désactivé temporairement.
Une fois que l’authentification est active les restrictions suivantes s’appliquent :
l
l
l
Les administrateurs n’ont aucune restriction d’accès à l’exception du module de gestion des paramètres
de configuration de l’application qui nécessite un droit d’accès spécifique (voir la documentation
technique).
Les gestionnaires de dossier ont accès à la définition et aux statistiques des processus de leur(s) dossier
(s). Ils n’ont pas d’accès aux annuaires, groupes, la gestion d’utilisateurs, délégations, participants
globales et la gestion des applications.
Les superviseurs de processus n’auront pas accès au module d’administration, mais peuvent avoir
accès au module statistiques de leur processus via le portail.
Afin de garantir l’archivage des demandes, les informations ne peuvent pas être supprimées si elles sont liées
à une définition de processus ou à une donnée globale. De même manière, les informations utilisées dans les
demandes « réelles » faites par les utilisateurs ne peuvent pas être supprimées.
23
Aperçu
Le panneau de configuration est utilisé pour régler les paramètres principaux pour l'application WorkflowGen.
Le panneau de configuration est accessible à partir de la page d'accueil du module d'administration ou de
l’URL « http://nomserveur/wfgen/admin/Config.aspx ».
L'accès au panneau de configuration peut être réglé dans la configuration de WorkflowGen « web.config » qui
se trouvse dans le répertoire « wfgen » de votre site. Pour ajouter des administrateurs, ajouter leur nom
d’utilisateur (délimitée par des virgules) au paramètre « ApplicationConfigAllowedUsersLogin ». (Les
utilisateurs doivent déjà avoir des profils d’administrateur.)
Le panneau de configuration contient les sections suivantes :
l
Général : Les paramètres généraux de WorkflowGen (ex. : connexion à la base de données).
l
Portail : Les paramètres généraux pour les utilisateurs (ex. : bannière).
l
l
24
Administration : Les paramètres généraux pour le module d’administration (ex. : langues).
Synchronisation annuaire : Les paramètres généraux pour les synchronisations d’annuaires (ex. :
fichier log).
l
Diagnostique : Taille des fichiers utilisés et erreurs relatives aux demandes.
l
Informations produit : La page d'information à propos de l’installation du produit.
Général
Base de données
Type du SGBD
Le type de base de données qui héberge la base de données de WorkflowGen, soit Microsoft SQL Server ou
Oracle.
Chaîne de connexion à la base de données « maître »
La fonctionnalité de montée en charge de la base de données permet l’ajout de serveurs afin d’améliorer la
considérablement la performance du serveur et les temps de réponse. Le serveur « esclave » additionel peut
être utilisé comme serveur en lecture seule dédié (requêtes SELECT SQL). Le serveur en lecture seule est
répliqué à partir du serveur « maître » existant.
Pour tester la connexion à cette base de donées, cliquez sur le lien Tester.
Exemple avec SQL Server :
"Data Source=DB_SERVER_1;Initial Catalog=WFGEN;User ID=WFGEN_
USER;Password=admin123!;"
Chaîne de connexion de la base de données en lecture seule
Chaîne de connexion de la base de données en lecture seule ou « esclave ». Pour tester la connexion à cette
base de donées, cliquez sur le lien Tester.
Exemple avec SQL Server :
"Data Source=DB_SERVER_2;Initial Catalog=WFGEN;User ID=WFGEN_
USER;Password=admin123!;"
Multi-base de données
Cochez la case Activer pour activer la fonctionnalité de support de l’architecture « maître-esclave » pour la
base de données.
Portail
Si l’option de multi-base de données est activée, les différentes cases à cocher des composants du portail
seront actives. Sinon, elles resteront décochées et la base de données « maître » sera utilisée.
25
Modules
Si l’option de multi-base de données est activée, les différentes cases à cocher des modules du portail seront
actives. Sinon, elles resteront décochées et la base de données « maître » sera utilisée.
Adresse
URL de l’application (obligatoire)
URL de l’application Web. Elle se compose du protocole à utiliser (HTTP ou HTTPS), de l’adresse IP ou nom
DNS du serveur Web et finalement du port TCP du site Web. Vous pouvez tester la valeur saisie en cliquant
sur le lien Tester.
Exemple : http://www.monorganisation.com/
SMTP
SMTP serveur (obligatoire)
Adresse IP ou nom DNS du serveur SMTP. Cette valeur est utilisée par l’application web pour envoyer des
emails de notification. Vous pouvez tester la valeur saisie en utilisant le lien Tester; un email de test sera
envoyé en utilisant l’adresse du serveur SMTP.
Exemple : smtp.monorganisation.com
Authentification
Méthode
Sélectionnez la méthode d’authentification pour se connecter à WorkflowGen :
l
IIS : Les utilisateurs sont authentifiés par IIS.
l
Applicatif : Les utilisateurs sont authentifiés par un script de login personnalisé :
l
l
l
Sélectionnez WorkflowGen pour gérer l’authentification et le mot de passe des utilisateurs dans
WorkflowGen.
Sélectonnez Personnalisé pour utiliser votre propre module d’authentification .NET.
Sélectionnez Session pour authentifier les utilisateurs en utilisant une variable de session
existante.
Retirer le préfix du domaine (obligatoire)
Vous pouvez spécifier un domaine à supprimer pour le username de l’utilisateur courant. Si cette valeur est
réglé à Tous, tous les noms de domaine seront supprimés.
26
Sécurité
Applications Web en mode sécurisé :Permet le cryptage des données lors de la communication entre
WorkflowGen et le formulaire. Cette fonctionnalité est disponible depuis la version 5.6.1 avec l’éditeur de
formulaire intégré ainsi que pour les formulaires Web qui utilisent les composants WorkflowGen.My et
WorkflowFileUpload en version 2.3.3 et plus.
Pour utiliser cette fonction de sécurité, il est nécessaire de mettre à jour tous vos formulaires développés
sous Visual Studio pour qu’ils utilisent les composants WorkflowGen.My et WorkflowFileUpload en
version 2.3.3 minimum avant d’activer cette option.
Horaires et jours de travail
Fuseau horaire par défaut des nouveaux utilisateurs : Le fuseau horaire qui sera indiqué par défaut pour
les nouveaux utilisateurs du portail (pour les utilisateurs créés manuellement ou par synchronisation
d'annuaire). Ce paramètre par défaut ne sera utilisé que pour la création de compte d’utilisateur.
Jours fériés de la semaine (facultatif) : Jours de la semaine fériés, utilisés par l’application pour calculer les
dates limites de réalisation des demandes et des actions. Exemple : samedi, dimance.
Heure de travail début (obligatoire) : L’heure de début d’une journée (basé sur le fuseau horaire du serveur).
Cette valeur est utilisée par le système pour calculer les dates d’échéances des processus et des actions.
Elle sera convertie en heure GMT pour des calculs. Exemple : « 8:00 » spécifie que la journée débute tous les
jours à 8h00.
Heure de travail fin (obligatoire) : L’heure de fin d’une journée de travail. Cette valeur est utilisée par le
système pour calculer les dates d’échéances des processus et des actions. Elle sera convertie en heure GMT
pour les calculs. Exemple : « 17:00 » spécifie que la journée se termine tous les jours à 17h00.
Fuseau horaire des heures de travail : Le fuseau horaire qui sera utilisé pour le calcul des heures de travail.
Par défaut : fuseau horaire du serveur.
Jours fériés du pays (obligatoire) : Le pays utilisé pour calculer les jours fériés légaux. Cette valeur est
utilisée par le système pour calculer les dates limites de réalisation des demandes et des actions. Cette
option est basée sur les fichiers « DaysOff.en-US.resx » et « DaysOff.fr-FR.resx » dans le répertoire
\wfgen\App_GlobalResources. Ces fichiers peuvent être mis à jour et des nouveaux fichiers peuvent être
créés basés sur leur code de pays et de langue standard. Exemple : « France (Français) ».
Jours fériés spéciaux (j/m séparés par des virgules (,)) (facultatif) : Cette valeur vous permet de
spécifier vos jours fériés personnalisés. Exemple : « 2/1, 11/1 » indique les 2 janvier et 11 janvier comme jours
fériés.
Thème : L éléments graphiques, de couleur de l’interface à utiliser. L’administrateur peut créer ses propres
styles et images pour changer l’apparence de l’interface.
27
Portail
Affichage
Nom de l’application (obligatoire) : Vous pouvez adapter le mot « WorkflowGen » qui est affiché dans le
portail. Exemple : « Acme Flow ».
Langue de l’application : Permet de définir la langue du portail par défaut. La sélection de la Préférence de
l’utilisateur permet à l'utilisateur de choisir sa propre langue, mais vous pouvez en imposer une en la
choisissant de la liste.
Affiche les noms de code : Affiche les descriptions des processus et des actions à la place du nom code.
Nombre de lignes par page dans les listes (obligatoire) : Le nombre de lignes par pages affichées dans
différentes listes du module d'utilisateur. Par défaut : 10
Nombre de pages dans les listes (obligatoire) : Nombre de pages affichées dans différentes listes du
portail. Par défaut : 10
Nombre maximum d’enregistrements affichés dans les listes (obligatoire) : Le nombre de rangées
affichées par pages arrivant d’une recherche or de résultats de statistiques. Par défaut : 1000
Nombre maximum d'utilisateurs affichés dans les fenêtres de sélection (obligatoire) : La limite avant
qu'un filtre apparaisse dans les listes d’utilisateurs. Par défaut : 100
Affichage des nouvelles demandes dans la page d’accueil : Mode d'affichage du lien Nouvelle
demande sur la page d'accueil du portail. Vous pouvez choisir entre :
l
Afficher les demandes
l
Afficher les demandes groupées par catégorie
l
Afficher les catégories et cacher les process
Au lancement d’une demande : Quand une nouvelle demande est lancée, vous pouvez choisir comment
WorkflowGen se comporte. Vous pouvez choisir entre :
l
Afficher la fiche de suivi de la demande
l
Lancer la première action
l
Afficher la fiche de suivi de la première action
Lancement d’une demande : Si coché, l’utilisateur doit confirmer le lancement de la nouvelle demande.
Lors d’un clic sur une action à faire :
l
Afficher la fiche de suivi de l’action
l
Lancer l’action
28
Après la réalisation d’une action :
l
Afficher la fiche de suivi de la demande
l
Afficher la fiche de suivi de la demande ou la prochaine action
l
Afficher la fiche de suivi de la demande (sauf si action à affecter)
l
Afficher la fiche de suivi de la demande (sauf si action à faire)
l
Afficher la liste des actions à faire
l
Afficher la liste des actions à faire ou la prochaine action
l
Afficher la liste des actions à faire (sauf si action à affecter)
l
Afficher la liste des actions à faire (sauf si action à faire)
l
Afficher la page d’acceuil
l
Afficher la page d’accueil ou la prochaine action
l
Afficher la page d’accueil (sauf si action à affecter)
l
Afficher la page d’accueil (sauf si action à faire)
l
Afficher la page d’accueil avec « Mes actions à faire » développées
l
Afficher la page d’accueil avec « Mes actions à faire » développées ou la prochaine action
l
Afficher la page d’accueil avec « Mes actions à faire » développées (sauf si action à affecter)
l
Afficher la page d’accueil avec « Mes actions à faire » développées (sauf si action à faire)
Mode de clôture d’une action : Si coché, l’action sera complétée en arrière plan. Cette option peut parfois
améliorer le temps de réponse à l’utilisateur final ou prévenir les problèmes de délai d’attente, surtout s’il y a
de grandes quantités de traitement après la soumission d’un formulaire Web.
Nombre maximum d’enregistrements dans les listes de la page d’accueil (obligatoire) : Le nombre
maximum d’enregistrements dans les listes avant l’affichage de numéro de page.
URL de bandeau personnalisé : L’URL du bandeau affiché à la section supérieure du portail. Exemple :
http://www.macomapgnie.com/welcome.htm
Redirection de la recherche : Permet de rediriger le résultat de la recherche directement vers la fiche de
suivi de la demande lorsqu’il n’y a qu’une seule demande trouvée.
Vue avancée : Permet d’activer ou de désactiver la fonctionnalité de colonnes et graphiques personnalisés
pour les gestionnaires de dossier et les superviseurs.
l
l
l
Afficher le résultat sous forme de rapport personnalisé
Activer l’approbation rapide par défaut : Coche l’option d’afficher les boutons d’approbation rapide
dans le formulaire de recherche par défaut.
Activer les colonnes calculées pour les gestionnaires de dossier et les superviseurs
l
Activer l'édition des colonnes calculées pour les utilisateurs standard
l
Activer les graphiques personnalisés pour les gestionnaires de dossier et les superviseurs
l
29
Activer les graphiques personnalisés pour les utilisateurs standard Les utilisateurs standards
auront la permission de créer et de modifier les graphiques personnalisées.
Formatage des liens et des adresses courriels : Affiche les URL et adresses courriels comme liens
cliquables.
Groupement des process : Spécifie si les processus sont regroupés par catégories dans une liste
déroulante utilisée pour sélectionner la vue « mono-processus ».
Taille par défaut des colonnes correspondantes aux données des process (en pixels) (obligatoire) :
Spécifie la largeur (en pixels) par défaut pour les colonnes qui affichent les données associées en vue « monoprocessus ». Par défaut : 150
Quick View : Activer le Quick View : Permet d’activer ou de désactiver la fonctionnalité Quick View dans
le portail.
Nom de la donnée affichée par le Quick View : Spécifie la valeur de donnée du processus à afficher dans
la boîte de dialogue.
Afficher le Quick View sur l’événement de la souris : Vous pouvez choisir entre deux événements
différents pour ouvrir la boîte de dialogue Quick View : Clic (défaut) ou Survol.
Liste des noms de données communs aux process : Ce paramètre vous permet de lister les données
communes à plusieurs processus et qui peuvent ensuite être utilisées dans des vues « multi-processus ». Le
séparateur entre chaque nom de données est le point virgule « ; ».
Par exemple, si vous avez plusieurs processus qui utilisent chacun une données nommée CLIENT (TEXTE),
vous pouvez déclarer cette donnée comme une donnée commune. Elle sera alors affichée dans les écrans en
mode « multi-processus ».
Mode d’affichage graphique du workflow : Permet d’activer l’affichage du suivi graphique en HTML5 au
lieu de Flash. Cette fonctionnalité est disponible dans Internet Explorer (version 9 et supérieure), Firefox,
Chrome et Safari.
Demandes
Suppression des demandes fantôme supérieure à (jours) (obligatoire) : Spécifie le nombre maximum
de jours avant que les demandes lancées, mais non acheminées à la prochaine action, soient effacées. Par
défaut : 3
Nombre maximum d’instances d’une même action (obligatoire) : Nombre maximum d’instances
simultanées de la même action d’un processus. Ce paramètre vous permet d’éviter des boucles infinies
pendant l’exécution de processus. Exemple : 100
Suppression des demandes : Si sélectionné, les gestionnaires de dossiers et les superviseurs de
processus peuvent supprimer des demandes même si le statut de ces processus est actif.
Durée du verrou des données partagées (minutes) (obligatoire) : Les données seront verrouillées
pendant la période précisée afin d’éviter une « compétition » pour l’accès aux mêmes données. Exemple : 5
30
Notifications utilisateurs
Notification par email :
l
l
Activer la notification par email : Ce paramètre vous permet d’activer ou désactiver les notifications
par email pour tous les processus du système indépendamment de leur statut.
Notifier l'utilisateur quand il est à la fois l'émetteur et le destinataire de la notification : Si ce
paramètre est sélectionné, les notifications seront envoyées même si l’adresse de l’envoyeur et celle de
la destinataire sont les mêmes.
Email émetteur par défaut (obligatoire) : Adresse courriel par défaut de l’envoyeur des notifications des
courriels (seulement utilisé en cas où la notification est envoyée par le système). Exemple :
[email protected]
Nombre maximum d'emails envoyés à la fois (obligatoire) : Nombre maximum de notifications
simultanées par courriel permis par WorkflowGen. Exemple : 100
Langue par défaut des emails : Si l’utilisateur n’a aucune langue sélectionnée par défaut ou par préférence,
ce paramètre précise la langue à utiliser pour le contenu des notifications.
cliquables.
Délégation
Délégation : Activer la délégation d’utilisateurs : Si ce paramètre est sélectionné, les utilisateurs peuvent
déléguer leurs actions à d’autres utilisateurs de WorkflowGen depuis le portail.
Application hôte
Précise l’URL de l’appliction hôte (ex. : http://monserveurweb/wfgen). Dans Microsoft SharePoint, vous
pouvez créer un ‘web part’ qui vous permettrait d’utiliser WorkflowGen (portail ou administration) à l’intérieur
de SharePoint, sans avoir à travailler au sein de différentes fenêtres.
Dans ce cas, vous devriez préciser l’URL de l’application hôte.
Statistiques
Nombre d'utilisateurs affichés dans les rapports (obligatoire) : Nombre d’utilisateurs affichés dans les
rapports statistiques. Exemple : 10
Nombre d'intervenants affichés dans les rapports (obligatoire) : Nombre d’intervenants affichés dans
les rapports statistiques. Exemple : 10
Nombre de demandeurs affichés dans les rapports (obligatoire) : Nombre de demandeurs affichés dans
les rapports statistiques. Exemple : 10
Format d’export
Vous pouvez choisir parmi 2 formats pour l’exportation des résultats générés par un rapport statistiques. Les
formats disponibles sont :
l
l
31
CSV (valeurs séparées par virgule : Ce format ne supporte pas les caractères Unicode.
Texte Unicode (séparateur tabulation) : Les valeurs sont seulement séparées pas un caractère de
tabulation néanmoins les caractères Unicode sont supportés.
cliquables.
Commentaires
Commentaires : Activer ou désactiver les commentaires du portail.
Nombre maximum de commentaires affichés dans la page d’accueil : Définit le nombre maximum
d’items de la liste des commentaires pour la page d’accueil.
Fréquence de rafraîchissement automatique (obligatoire) : Définit le taux de rafraîchissement
automatique en millisecondes de la liste des commentaires de la fiche de suivi. Entrez la valeur 0 pour
désactiver cette fonctionnalité. Par défaut : 60000 (1 minute)
Largeur de la fenêtre pop-up des commentaires (obligatoire) : Définit la largeur en pixels de la fenêtre
pop-up des commentaires qui peut être affichée. Par défaut : 380
Note : La largeur des styles suivants doit être mis à jour séparément dans le fichier CSS du portail (« \App_
Themes\Default\portal\css\Default.css ») lorsque la largeur du pop-up est modifiée :
l
div.CommentsViewOpenedRightAlign
l
div.CommentsViewSubOpenedRightAlign
l
div.CommentsViewOpenedPopUpRightAlign
l
div.CommentsViewSubOpenedPopUpRightAlign
l
.CommentsListHeader .ListRow .CellOpenedRightAlign
l
.CommentsList .ListRow .ListCell .Comment .Row .CellHeader
l
.CommentsListInput .ListRow .ListCell .NewComment .Row .Cell .TextArea
Hauteur de la fenêtre pop-up des commentaires (obligatoire) : Définit la hauteur en pixels de la fenêtre
pop-up des commentaires qui peut être affichée. Par défaut : 550
Note : La largeur des styles suivants doit être mis à jour séparément dans le fichier CSS du portail (« \App_
Themes\Default\portal\css\Default.css ») lorsque la largeur du pop-up est modifiée :
l
div.CommentsListBodyPopUp
l
div.CommentsListBodyPopUpHidden
l
div.CommentsListBodyPopUpReadOnly
l
div.CommentsListBodyPopUpReadOnlyHidden
Champ de tri par défaut : Définit le champ de tri par défaut de la liste des commentaires. Par défaut : date
Ordre de tri par défaut : Définit l’ordre de tri par défaut de la liste des commentaires. Par défaut : ascendant
32
Mode d’affichage par défaut : Afficher ou dissimuler la liste des commentaires lors du premier affichage de
la fiche de suivi. Par défaut : décoché (la liste n’est par visible)
Administration
Affichage
Langue de l’application : Ce paramètre vous permet de définir la langue de l’application pour le module
d’administration. En sélectionnant Préférence de l’utilisateur, les utilisateurs pourront choisir leur propre
langue mais vous pouvez toujours en imposer une en sélectionnant une langue de la liste.
Nombre de lignes par page dans les listes (obligatoire) : Nombre de lignes affichées dans les listes à
l’intérieur du module d’administration. Par défaut : 100
Nombre de pages dans les listes (obligatoire) : Nombre de pages affichés dans les listes à l’intérieur du
module d’administration. Par défaut : 10
Nombre maximum d’utilisateurs affichés dans les fenêtres de sélection (obligatoire) : Vous pouvez
préciser une limite d’utilisateurs qui s’afficheront dans les listes d’utilisateurs. Au-delà de cette limite,
WorkflowGen affiche un filtre pour simplifier votre sélection. Par défaut : 100
Restriction d’encodage des données (obligatoire) : Si ce paramètre est sélectionné, seulement les
caractères ANSI sont permis dans les champs “NOM”. Par contre, si ce paramètre n’est pas sélectionné,
seulement les caractères spéciaux (', ", tab, espace, %, /, \, *) seront refusés.
Utilisateur
Langue par défaut des nouveaux utilisateurs : Au moment qu’un nouvel utilisateur est créé, la langue
sélectionnée sera appliquée au profil d’utilisateur comme la langue par défaut.
Services Windows
Username de l'administrateur de l'application (obligatoire) : L’identité de service Windows utilisé pour
les services WorkflowGen.
Autres
Ces paramètres sont uniquement gérés dans le fichier de configuration de WorkflowGen
(« \wfgen\web.config »).
Activer la vérification des règles de suppression : Lors de l’affichage des listes d’annuaires, de groupes
et d’utilisateurs, WorkflowGen peut vérifier pour chacun d’eux si la suppression est possible en fonction des
règles de suppression (appartenance à des participants, etc.). Vous pouvez désactiver ces vérifications pour
améliorer les performances d’affichage de ces listes.
Nom : AdministrationEnableDeletionRulesCheck
Valeur par défaut : Y
33
Interdire aux gestionnaires de processus la modification des participants globaux : Ce paramètre
permet d’empêcher les gestionnaires de processus de modifier les informations des participants globaux (ex. :
nom, description et associations avec les utilisateurs/groupes/annuaires).
Nom : AdministrationRestrictManagerToModifyGlobalParticipant
Valeur par défaut : N (les gestionnaires de processus peuvent modifier les participants globaux)
Logs
ression des fichiers temporaires : Si sélectionnée, les fichiers temporaires XML créés par WorkflowGen
sont supprimés à la suite des synchronisations.
Rapport détaillé : Si sélectionnée, la synchronisation conserve un suivi des actions effectuées.
Historiser les fichiers logs pendant (jours) (obligatoire) : Nombre de jours avant de supprimer les fichiers
log des actions effectuées. Exemple : 31
Afficher les avertissements dans les logs : Si sélectionnée, les avertissements seront affichés dans les
fichiers log.
Synchronisation automatique
Jour de la semaine pour les synchronisations hebdomadaires : Day of the week to perform the
automatic weekly synchronization.
Jour du mois pour les synchronisations mensuelles : Jour du mois pour exécuter la synchronisation
automatique.
Démarrer la synchronisation à : L’heure de la journée pour exécuter la synchronisation automatique.
Autres
Ces paramètres sont uniquement gérés dans le fichier de configuration de WorkflowGen
(« \wfgen\web.config »).
Nombre maximum d’utilisateurs supprimés : Définit le nombre maximum d’utilisateurs supprimés lors de
la synchronisation des annuaires. Cette option permet d’améliorer les temps d’exécution des
synchronisations dans les cas où beaucoup d’utilisateurs sont à supprimés.
Noim : DirectorySynchronizationMaxUserDeletionCount
Valeur par défaut : 0 (pas de limite du nombre de suppression)
Synchroniser uniquement les membres des groupes utilisés dans des participants : Permet de
synchroniser uniquement les groupes utilisés dans des processus (appartenance à des participants, etc.).
Cette option permet d’améliorer les performances de la synchronisation des annuaires, les groupes non
utilisés dans les processus n’étant pas synchronisés.
Nom : DirectorySynchronizationSyncGroupMembersUsedInParticipantOnly
Valeur par défaut : N (synchronise tous les groupes)
34
Diagnostique
Taille des fichiers : Affiche la taille totale occupée par tous les fichiers, la taille moyenne et la taille du plus
gros fichier.
Demandes bloquées : Liste des demandes en cours mais dont plus aucune action n’est à faire. Ces
demandes ne peuvent pas se clôturée normalement.
Actions automatiques expirées : Liste des actions qui n’ont pas pu être réalisées suite au dépassement du
temps autorisé par le serveur IIS pour s’exécuter.
Erreurs inattendues : Liste des actions qui ont levées une erreur autre que le dépassement du temps
autorisé par le serveur IIS pour s’exécuter.
License information
Version : Spécifie la version de WorkflowGen installée.
Serial number : Spécifie le numéro de série de l’installation de WorkflowGen.
Assembly versions
Spécifie les diverses versions des composantes utilisées par WorkflowGen.
35
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 membre 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 username (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és.
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
Nouvel annuaire
Affiche l’écran d’édition des annuaires en mode ajout
Rafraîchir
Rafraîchit la liste des annuaires
Supprimer
Supprimer un annuaire
36
Liste des annuaires
Colonnes
Remarques
Ordre
Utilisez les flèches pour changer l’ordre de la liste
Nom
Nom de l’annuaire
Un lien affiche l’écran d’édition de l’annuaire en mode ajout.
Description
Description de l’annuaire
Groupe(s)
Nombre de groupes associés à l’annuaire
Un lien affiche les groupes correspondants.
Utilisateur(s)
Nombre d’utilisateurs associés à l’annuaire
Un lien affiche les utilisateurs correspondants.
Édition d’un annuaire
Pour modifier un annuaire, cliquer son nom dans la liste des annuaires.
Champs
Remarques
Nom
Champs obligatoire
Identifiant unique de l’annuaire devant respecter la nomenclature et être
limité à 50 caractères.
Description
Champs obligatoire
Description de l’annuaire limitée à 255 caractères.
Annuaire par défaut
Si sélectionné, l’annuaire est affiché en premier dans la liste des annuaires
sélectonnés dans le module d’administration.
Mot de passe des utilisateurs
Si sélectionné, les mots de passe sont gérés par WorkflowGen.
Connecteur d’annuaire
Différentes sources pouvant être utilisées pour la gestion de
l’authentification.
Suppression d’un annuaire
l
L’annuaire WORKFLOWGEN ne peut pas être supprimé.
l
Un annuaire associé à des utilisateurs ou des groupes ne peut pas être supprimé.
l
Un répertoire ne peut être supprimé s’il est un répertoire vide.
Utilisateurs
Écran liste des utilisateurs
37
Écran utilisateurs
Barre de menu
Liens
Remarques
Nouveau
Affiche l’écran d’édition des utilisateurs en mode ajout
Rafraîchir
Rafraîchit la liste des utilisateurs
Filtres
Filtres externes
Remarques
Annuaire
Affiche les utilisateurs de l’annuaire sélectonné
38
Profil
Affiche les utilisateurs avec le profil sélectonné
Actifs uniquement
Affiche seulement les utliisateurs avec le statut actif
Archivé
Affiche les utilisateurs avec le statu archivé
Filtrer sur
Filtrer sur le champ choisi (nom, nom d’utilisateur, email, etc.)
Recherche
Rechercher des utilisateurs par nom, nom d’utilisateur, email, etc.
Filtrer sur *
Remarques
Nom
Filtre par nom
Nom d’utilisateur
Filtre par nom d’utilisateur
Email
Filtre par adresse email d’utilisateur
Département
Filtre par département d’utilisateur
Société
Filtre par nom de société d’utilisateur
Numéro d’employé
Filtre par numéro d’employé d’utilisateur
Téléphone
Filtre par numéro de téléphone d’utilisateur
Mobile
Filtre par numéro de téléphone mobile d’utilisateur
Fax
Filtre par numéro de fax d’utilisateur
Pager
Filtre par numéro de pager d’utilisateur
Bureau
Filtre par bureau d’utilisateur
Titre du poste
Filtre par le titre de travail de l’utilisateur
Type d’employé
Filtre par type d’employé d’utilisateur
Initiales
Filtre par initiales d’utilisateur
Titre
Filtre par titre d’utilisateur
Adresse postale
Filtre par l’adresse postale de l’utilisateur
Code postal
Filtre par code postal
Ville
Filtre par ville
Département / Région
Filtre par département ou région
Pays
Filtre par pays
Chemin LDAP
Filtre par chemin LDAP
Attribut étendu 1
Filtre par attribut étendu n°1 d’utilisateur
Attribut étendu 2
Attribut étendu 3
Attribut étendu 4
Attribut étendu 5
Nom distinctif
Filtre par nom distinctif
Nom affiché
Filtre par nom affiché
Identifiant système
Filtre par identifiant système d’utilisateur (SID)
* Un filtre peut être appliqué à une partie d’un champ.
39
40
Liste des utilisateurs
Colonnes
Remarques
Cases à cocher à choix
multiples
Actions:
l
Activer les utilisateurs sélectonnés
l
Désactiver les utilisateurs sélectonnés
l
Supprimer les utilisateurs sélectonnés
Prénom Nom
Prénom et nom d’utilisateur
Un lien affiche l’écran d’édition de l’utilisateur en mode ajout.
Nom d’utilisateur
Nom d’utilisateur
Profil
Profil de l’utilisateur
État
Statut du compte de l’utilisateur : Actif ou Inactif
Annuaire
Annuaire de l’utilisateur
Note : Cette colonne est affichée quand Tous est sélectonné dans la liste
déroulante Annuaire.
Formulaire utilisateur
Champs
Remarques
Annuaire
Annuaire de l’utilisateur
Nom d’utilisateur
Champ obligatoire
Identifiant unique de l’utilisateur dans tous les annuaires. Limité à 255
caractères.
Nom
Champ obligatoire
Nom de l’utilisateur
Prénom
Prénom de l’utilisateur
Email
Adresse email de l’utilisateur
Profil
Profil de l’utilisateur définissant ses droits d’accès à l’application :
Administrateur ou Utilisateur
Groupe(s)
Nom du groupe annuaire auquel l’utilisateur est associé
Un lien affiche le groupe correspondant.
État *
Statut du compte de l’utilisateur : Actif ou Inactif
Synchronisé
Sélectonné si l’utilisateur est synchronisé
Langue par défaut
Langue appliquée à la création du compte de l’utilisateur
Language sélectonnée
Langue sélectonnée par l’utilisateur
Fuseau horaire par défaut
Fuseau horaire appliqué lorsque le compte de l’utilisateur a été activé
Fuseau horaire sélectonné
Fuseau horaire sélectonné par l’utilisateur
Responsable
Utilisateur sélectonné en tant que responsable
Collaborateurs
Liste des utilisateurs qui cet utilisateur en tant que responsable
Permet l’accès à la liste de ces utilisateurs sur un clic simple.
Téléphone *
Numéro de téléphone de l’utilisateur
Portable *
Numéro de téléphone mobile de l’utilisateur
Fax *
Numéro de fax de l’utilisateur
Pager *
Numéro de pager de l’utilisateur
Bureau *
Numéro de bureau de l’utilisateur
Département *
Numéro du département de l’utilisateur
Entreprise *
Nom de la société de l’utilisateur
Fonction *
Fonction de l’utilisateur
Type d’employé
Type d’employé de l’utilisateur
Initiales *
Initiales de l’utilisateur
Titre *
Titre de l’utilisateur
Matricule *
Matricule de l’utilisateur
Adresse postale *
Adresse postale de l’utilisateur
Code postal *
Code postal de l’utilisateur
Ville *
Ville de l’utilisateur
Département / Région *
Départment / région de l’utilisateur
Pays *
Pays de l’utilisateur
Chemin LDAP *
Chemin LDAP de l’utilisateur
Nom affiché *
Nom affiché de l’utilisateur
Nom distinctif *
Nom distinctif de l’utilisateur
Champ personnalisé 1 à 5
Champs personnalisé de l’utilisateur
SID de l’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.
Un utilisateur sera archivé et non supprimé si :
l
L’utilisateur est associé à un participant en tant qu’utilisateur.
l
L’utilisateur est le créateur ou le modificateur d’un processus.
l
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
L’utilisateur est le seul coordinateur d’un participant de type liste de personne avec un coordinateur.
l
L’utilisateur est la seule personne d’un groupe affecté à un participant de type liste de personnes.
l
L’utilisateur est la seule personne d’un participant de type liste de personnes.
Remplacement
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.
41
42
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
l
Type de demande
l
En cours
l
Clôturées
l
Total
Utilisation des actions
l
Type d’action
l
En cours
l
Clôturées
l
Total
Délégations de quelqu’un
l
Process
l
Participant
l
Global
l
Utilisateur délégué
l
Début
l
Fin
Délégations à quelqu’un
l
Process
l
Participant
l
Global
l
Utilisateur
l
Début
l
Fin
Participants auxquels l’utilisateur est associé
l
Processus
l
Participant
l
Global
43
l
Rôle
l
Annuaire
l
Groupes
l
Utilisateur(s)
l
Coordonnateur(s)
Gestionnaire de dossier/processus
l
Dossier
l
Participant
l
Annuaire
l
Groupes
l
Utilisateur(s)
Gestionnaire des listes globales
l
Participant
l
Annuaire
l
Groupe(s)
l
Utilisateur(s)
Groupes
Écran liste des groupes
44
45
signifie un groupe d’utilisateurs d’un même annuaire (synchronisés ou définis dans WorkflowGen)
signifie un groupe d’utilisateurs « virtuel » d’un même annuaire filtré par une requête SQL (vue sur un
annuaire)
Association des utilisateurs
Les utilisateurs sont associés à un groupe lorsque celui-ci est enregistré (à la création ou à la modification). Si
un groupe est synchronisé, sa liste d’utilisateurs est mise à jour lors de la synchronisation. Si aucune
synchronisation a été défini pour ce répertoire, les utilisateurs des groupes virtuels de ce répertoire ne seront
pas mises à jour automatiquement.
Barre de menu
Liens
Remarques
Nouveau
Affiche l’écran d’édition des groupes en mode ajour
Rafraîchir
Rafraîchit la liste des groupes
Filtres
Filtres externes
Remarques
Annuaire
Affiche les groupes de l’annuaire spécifié
Type
Tous / Annuaire / Requête
Filtrer sur *
Remarques
Nom
Filtre sur le nom du groupe
Description
Filtre sur la description du groupe
Question
Filtre de la requête de groupe
Email
Filtre sur l’adresse email du groupe
Group code
Filtre sur le code du groupe
Nom complet
Filtre sur le nom affiché du groupe
Nom distinctif
Filtre sur le nom distinctif du groupe
Filtre sur l’identifiant système du groupe
Liste des groupes
Colonnes
Remarques
Cases à cocher à choix
multiples
Actions :
l
Activer les utilisateurs sélectionnés
l
Désactiver les utilisateurs sélectionnés
l
Supprimer les utilisateurs sélectonnés
Nom
Nom du groupe
Un lien permet d’afficher la fiche d’édition du groupe en mode ajout.
Description
Description du groupe
Utilisateurs
Nombre d’utilisateurs associés au groupe
Un lien permet d’afficher les utilisateurs correspondants
Annuaire
Annuaire du groupe
Note : Cette colonne s’affiche uniquement quand Tous est sélectionné
dans la liste déroulante Annuaire.
Écran groupes
Formulaire groupe
Champs
Remarques
Annuaire
Annuaire du groupe
Nom
Champ obligatoire
Identifiant unique du groupe dans l’annuaire
Description
Champ obligatoire
Description du groupe
46
Requête
47
Instructions permettant la définition d’un groupe basée sur une requête
paramétrée (filtre sur un annuaire)
Exemples :
l
Utilisateurs membres d’un groupe : {ISMEMBER(FINANCE)}
l
Utilisateurs d’une ville définiée : CITY = 'PARIS'
l
Des combinations, telles que : Country='FRANCE' and {ISMEMBER
(FINANCE)}
(Aide)
Aide de la syntaxe de la requête (liste des champs disponibles)
Teste
Teste de la syntaxe de la requête et du nombre d’utilisateurs
Email
Adresse email du groupe
Code groupe
Code du groupe
Nom affiché
Nom affiché du groupe
Nom distinctif
Nom distinctif du groupe
SID du groupe
Utilisateur(s)
Nombre d’utilisateurs assocés au groupe
Un lien permet d’afficher les utilisateurs correspondants.
Synchronisé
Détermine si le groupe est synchronisé
Suppression
La suppression d’un groupe n’entraîne pas la suppression des utilisateurs associés.
Délégations
Écran liste des délégations
Barre de menu
Liens
Remarques
Nouveau
Affiche l’écran de délégation en mode ajout
Rafraîchir
Rafraîchit la liste des délégations
Filtres
Filtres externes
Remarques
Processus
Affiche les délégations des processus sélectonnés (seuls les processus
actifs ou archivés sont listés)
Filtrer sur
Remarques
Participant
Filtre par participant
Utilisateur
Filtre par utilisateur (délégataire)
Filtre par utilisateur délégué
Liste des délégations
Colonne
Remarques
Processus
Nom du processus
Participant
Nom du participant
Utilisateur
Nom d’utilisateur (délégataire)
Nom d’utilisateur délégué
Du ...
Date de début de la délégation (incluse)
La délégation est illimitée si non définie
Au ...
Date de fin de la déléfation (incluse)
La délégation est illimitée si non définie
48
49
Écran d’édition d’une délégation
Édition d’une délégation
Champs
Remarques
Processus
Nom d’un processus actif (par défaut)
Les processus archivés sont listés si la case à cocher Afficher toutes les
versions des processus est sélectionnée. Ceci permet l’ajout et la
modification des délégations définies sur des demandes en cours basées
sur des processus archivés (versions précédentes). Si non défini, le
champ participant est désactivé.
Vous pouvez sélectionner tous les processus. Dans ce cas, la délégation
sera basée sur toutes les fonctions des processus associées à l’utilisateur
sélectionné.
Participant
Participant des processus sélectonnés (sauf si Tous)
Utilisateur
Utilisateur associé avec le participant sélectionné (délégataire) dont on
veut déléguer une fonction de processus.
Utilisateur devant agir à la place du délégataire dans les fonctions de
processus sélectionnées
L’utilisateur délégué doit être différent de l’utilisateur.
Du ...
Date de début de la délégation (incluse)
Si définie, la date de fin est requise (période de délégation). La délégation
est illimitée si non définie.
Au ...
Date de fin de la délégation (incluse)
Si définie, la date de début est requise (période de délégation). La
délégation est illimitée si non définie.
Ajout
Lors de la création d’une nouvelle délégation vous pouvez choisir d’envoyer ou non un message afin
d’informer le délégué via la boîte de dialogue affichée.
Une délégation est unique pour un processus, un participant, un utilisateur et un utilisateur délégué. Ceci
signifie que vous pouvez créer qu’une délégation en avance pour une période spécifique.
Vous ne pouvez pas définir de délégations croisées sur des périodes superposées entre les mêmes
utilisateurs sur le même participant.
Vous ne pouvez pas définir de délégations « multi-niveau » (ex. : utilisateur A délègue à l’utilisateur B, mais
utilisateur B ne peut pas déléguer les actions de l’utilisateur A à l’utilisateur C).
Suppression
La suppression d’une délégation ne supprime pas les utilisateurs associés.
Versions de processus
Les délégations sont spécifiques aux versions des processus :
l
l
l
l
l
Les nouvelle versions d’un processus copieront les délégations existantes de la version active
précédente.
Comme les délégations peuvent être créées pour des processus
Un utilisateur délégué verra les actions/demandes du délégateur d’un processus versionné au moment
de la création de la délégation et dans tous les nouvelles versions s’il n’y a pas de changement de
délégations entre versions.
Quand une délégation est modifiée dans la version courante, les délégations précédentes ne sont pas
affectées.
Les administrateurs ont accès aux délégations dans le module administratif pour faire des ajouts,
modifications, ou suppressions de délégations.
50
51
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 :
l
La synchronisation peut être manual ou automatique.
l
L’annuaire prédéfini « WORKFLOWGEN »ne peut pas être synchronisé
l
L’identifiant « Username » d’un utilisateur doit être unique dans l’ensemble des annuaires WorkflowGen.
l
l
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 desactivé 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 de profil 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.
Note : Une fois sauvegardée, il n’est plus possible de changer le type de connecteur utilisé pour un annuaire.
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).
52
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.
Note : 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.
Login et mot de passe annuaire : 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.
Note : 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 : 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\
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
53
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.
Ajout et modification : Ce type de synchronisation fonctionne d’une manière identique à la précédente en ce
qui concerne l’ajout. De plus, elle permet de mettre à jours les données correspondantes aux utilisateurs déjà
présents dans l’annuaire WorkflowGen.
Ajout, modification et suppression : Il est possible de supprimer des utilisateurs d’un annuaire de
WorkflowGen par synchronisation. Avec ce mode lorsqu’un utilisateur est présent dans l’annuaire
WorkflowGen, mais pas dans l’annuaire à importer, celui-ci est supprimé. Cette suppression n’est pas réelle
dans certains cas. Pour un meilleur suivi des actions et des utilisateurs, les utilisateurs à supprimer ayant
effectués des actions sont soit désactivés soit archivés. Ainsi même après la « suppression » d’un utilisateur,
il est possible d’avoir un suivi des traitements qui l’ont concerné.
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.
54
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 au chapitre
Panneau de configuration 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 :
l
Le protocole : dans notre cas « LDAP:// ».
l
Le nom du serveur ou son adresse IP.
l
Facultativement, le port séparé du nom du serveur par « : ». Le port par défaut est 389.
l
Le chemin dans l’arborescence LDAP du serveur.
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 :
l
Domaine de premier niveau (DC) : monorganisation.com
l
Unité organisationnelle (OU) : groupe à l’intérieur du domaine : Unité2
l
Sous-groupe (OU) : sous-groupe avec le domaine : Département TI
55
Pour accéder aux utilisateurs et groupes de « Département TI », le chemin LDAP devrait être :
« LDAP://nomduserveur:port/OU=Département TI, OU=Unité2, DC=monorganisation,DC=com »
Le chemin LDAP ne supporte pas l’operateur « . » mais supporte les espaces dont le « .com » est identifié par
l’opérateur « DC=com ».
Notes
l
l
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 et /Organisation/Département3 existe, et nous voulons synchroniser que
les départements 1 et 2, soit que l'OU entier de /Organisation soit spécifié (les 3 OU seront
synchronisés), ou deux synchronisations d’annuaires séparés doivent être créés, chacun avec un OU
spécifique.
l
Les filtres de requêtes LDAP ne sont pas supportés.
l
La requête de groupe est fondamentalement le même que la requête de l’utilisateur.
l
Les groupes et les utilisateurs liés à ceux-ci doivent exister dans le même chemin LDAP, sinon les
combinaisons de groupe/utilisateur hors du chemin seront exclues de la synchronisation et apparaîtront
comme des erreurs dans le fichier log. Ceci se produit habituellement quand les groupes d’AD sont
définis comme des CN dans un OU qui pointe aux utilisateurs qui font partis à d'autres OU en dehors du
chemin LDAP fourni.
Par exemple, si le chemin de LDAP est défini comme suit : /Organisation/Département1, et dans cet OU
le groupe de /Organisation/Département1/Équipe1 pointe à des utilisateurs dans l’OU
/Organisation/Département2, cette situation se manifestera. Dans ce cas-ci, on suggère d’utiliser un
chemin de LDAP qui inclut l'OU parent qui sont inclus tous les groupes requis, ou d’utiliser le type de
connecteur de « LDAP » pour créer des requêtes raffinées qui pointe spécifiquement aux
utilisateurs/groupes nécessaires.
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
Les champs de synchronisation par défaut sont :
l
Utilisateurs : Identificateur du système
l
Groupes : nom (sn)
56
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 peuvent être modifiées en sélectionnant le bouton
Correspondances dans la page de modification de l’annuaire.
Utilisateurs
WorkflowGen
Active Directory
Username
sAMAccountName
Mots de passe
userPassword
Nom
sn
Prénom
givenName
Email
mail
Fuseaux horaires par défaut
(none)
Responsable
manager
Téléphone
telephoneNumber
Portable
mobile
Fax
facSimileNumber
Pager
pager
Bureau
physicalDeliveryOfficeName
Département
department
Entreprise
company
Fonction
title
Type d’employé
employeeType
Initiales
initials
Titre
personalTitle
employeeID
Adresse postale
postalAddress
Code postal
postalCode
Ville
l
État / Région
st
Pays
co
Chemin LDAP
ADsPath
Nom affiché
cn
Nom distinctif
distinguishedName
Champ personnalisé 1
extensionAttribute1
extensionAttribute2
extensionAttribute3
extensionAttribute4
extensionAttribute5
objectSid
57
Groupes
WorkflowGen
Active Directory
Nom
sAMAccountName
Description
Description
Email
mail
Code groupe
groupCode
Chemin LDAP
AdsPath
Nom affiché
cn
Nom distinctif
DistinguishedName
objectSid
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 :
l
Le protocole : dans notre cas « LDAP:// ».
l
Le nom du serveur ou son adresse IP.
l
Facultativement, le port séparé du nom du serveur par « : ». Le port par défaut est 389.
l
Le domaine de premier niveau.
l
Le chemin dans l’arborescence LDAP du serveur, et/ou filtres.
58
Exemples :
Si la structure LDAP est la suivante :
l
Domaine de premier niveau (DC) : monorganisation.com
l
Unité organisationnelle (OU) : groupe à l’intérieur du domaine : Unité2
l
Sub-unit (OU): sous-groupe avec le domaine : Département TI
Pour accéder aux utilisateurs et groupes de « Département TI », il faut les chemins LDAP suivants :
Utilisateurs
LDAP://monserveur:port/DC=monorganisation,DC=com;(&(objectCategory=person)
(objectClass=user)(|(memberOf=CN=Département TI,OU=Unité2, DC=monorganisation,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
Groupes
LDAP://monserveur:port/DC=monorganisation,DC=com;(&(objectClass=group));adsPath,
objectSid,sAMAccountName,Description;subtree
Pour utiliser un CN qui réfère deux groupes, le filtre suivant peut être utlisé :
Utilisateurs
LDAP://monserveur:port/DC=monorganisation,DC=com;(&(objectCategory=person)
(objectClass=user) (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
Groupes
LDAP://intellera/dc=intellera,dc=com;(&(objectClass=group)(|(sAMaccountName=Group1)
(sAMaccountName=Group2)));adsPath,objectSid,sAMAccountName,Description;subtree
Notes :
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 intérrogés, alors soit l’ensemble de l’UO /Societe doit être précisé
(tous les UO des départements seront synchronisés), ou un filtre spécifique doit être créé qui interroge
seulement ces deux UO.
59
Les groupes et les utilisateurs qui leur sont liés doivent exister dans le même chemin LDAP, sinon des
combinaisons de groupes et utilisateurs incompatibles seront exclus de la synchronisation et apparaîtront
comme des erreurs dans le journal de synchronisation. Cela se produit généralement lorsque des groupes AD
sont définis comme des CN dans une UO qui pointent vers des utilisateurs qui sont définis hors de la portée
du LDAP spécifié.
Par exemple, cela se produira si le chemin LDAP est défini à lier uniquement à l’UO /Societe/Departement1,
et dans cette UO le groupe /Societe/Departement1/Equipe1 pointe vers des utilisateurs dans
/Societe/Departement2. Dans ce cas, il est suggéré de choisir une requête utilisateur qui inclut toutes les UO
qui sont impliquées dans les groupes.
Références
Pour des exemples supplémentaires sur les requêtes génériques LDAP, référez-vous aux sites suivants :
http:/www.petri.co.il/ldap_search_samples_for_windows_2003_and_exchange.htm
http://msdn2.microsoft.com/en-us/library/aa746475.aspx
http://technet.microsoft.com/en-us/library/aa996205.aspx
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 formulaire de configuration des synchronisations.
Les champs de synchronisation par défaut sont les suivants :
Utilisateurs : Identificateur du système
Groupes : Nom (sn)
Extraction des données LDAP
champs sous Active Directory, qui est supporté par ce mode de synchronisation. (Les autres genres de LDAP
pourraient avoir une correspondance différente).
Ces correspondances peuvent être modifiées en sélectionnant le bouton Correspondances dans la page de
modification de l’annuaire.
Utilisateurs
WorkflowGen
LDAP
Username
sAMAccountName
Mots de passe
(aucun)
Nom
sn
Prénom
givenName
Email
mail
(aucun)
Responsable (doit être un username
valide)
manager
Téléphone
telephoneNumber
Portable
mobile
Fax
facSimileNumber
Pager
pager
Bureau
Département
department
Entreprise
company
Fonction
title
Type d’employé
employee Type
Initiales
initials
Titre
personalTitle
employeeID
Adresse postale
postalAddress
Code postal
postalCode
Ville
l
État/Région
st
Pays
co
Chemin LDAP
ADsPath
Nom affiché
cn
Nom distinctif
distinguishedName
extensionAttribute1
extensionAttribute2
extensionAttribute3
extensionAttribute4
extensionAttribute5
objectSid
Groupes
WorkflowGen
LDAP
Nom
sAMAccountName
Description
Description
Email
mail
Code groupe
groupCode
60
Chemin LDAP
AdsPath
Nom affiché
cn
Nom distinctif
DistinguishedName
objectSid
61
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 :
l
User : Ce fichier doit contenir les données relatives aux utilisateurs devant être synchronisés.
l
Group : Ce fichier doit contenir les données relatives aux groupes devant être synchronisés.
l
Usergroup : Ce fichier doit contenir les relations d’appartenances entre les utilisateurs et les groupes
synchronisés.
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
C:\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 « C:\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 :
l
Le fichier des utilisateurs doit se terminer par « _USER.txt ».
l
Le fichier des groupes doit se terminer par « _GROUP.txt ».
l
62
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).
Note : 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é d'ADSPATH pour les utilisateurs.
Liste des propriétés
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
WorkflowGen
Fichier texte
Username
sAMAccountName
Mots de passe
(none)
Nom
sn
Prénom
givenName
Email
mail
(none)
Responsable (doit être un username
valide)
manager
Téléphone
telephoneNumber
Portable
mobile
Fax
facSimileNumber
Pager
pager
Bureau
Département
department
Entreprise
company
Fonction
title
Type d’employé
employee Type
Initiales
initials
Titre
personalTitle
employeeID
Adresse postale
postalAddress
Code postal
postalCode
Ville
l
État/Région
st
Pays
co
Chemin LDAP
(none)
Nom affiché
(none)
Nom distinctif
(none)
(none)
(none)
(none)
(none)
(none)
(none)
Groupes
WorkflowGen
Fichier texte
Nom
sAMAccountName
Description
Description
Groupes d’utilisateurs
Ci-dessous sont les champs exigés pour le dossier de membre d'utilisateur de groupe :
l
Nom de champ de synchronisation pour les groupes (ex. : GROUP_SAMAccountName)
l
Nom de champ de synchronisation pour les utilisateurs (ex. : USER_SAMAccountName)
63
64
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 :
csvde -f file.csv -s MONSERVEUR -d "OU=myOu,DC=TEST,DC=FR" -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"
Avec « SERVERNAME » é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
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]";
Fichier de groupes
sAMAccountName;Description
"HR";"GRP1-01"
"IT";"GRP1-02"
Fichiers d’association utlisateurs par groupes
GROUP_sAMAccountName;USER_sAMAccountName
"HR";"pstone"
"HR";"jdoe"
"IT";"jryan"
"IT";"anadir"
Fichiers log de la synchronisation
Aperçu
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.
65
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
Aperçu
Gestion des processus s’adresse aux informations qui s’appliquent à tous les processus :
l
l
l
Participants représente l’organisation de la société dans la gestion et l’exécution des processus.
Applications sont les applications de workflow appelées depuis WorkflowGen afin de lancer les
actions.
Catégories sont les mots clés associés aux processus à des fins de recherche.
Les informations générales sont gérables uniquement par des utilisateurs ayant le profil administrateur.
Participants
Écran liste des participants
66
Écran des participants
Barre de menu
Liens
Remarques
Nouveau
Affiche l’écran des participants en mode ajout
Rafraîchir
Rafraîchit la liste des participants
Filtres
Filtrer sur *
Remarques
Nom
Filtre par nom de participant
Description
Filtre par description de participant
Colonnes
Remarques
Nom
Nom du participant
Un lien permet d’afficher la ficher d’édition du participant.
Description
Description du participant
Utilisation
Nombre de processus auxel appartient le participant ajouté au nombre de
dossier dont le participant est gestionnaire
Utilisateurs
Nombre d’utilisateurs potentiels du participant
67
68
Champs
Remarques
Nom
Champ obligatoire
Identifiant unique pour le participant; doit être conforme à la nomenclature
et limité à 30 caractères
Description
Champ obligatoire
Description du participant limitée à 255 caractères
Type de participant
Champ obligatoire
Type de participant définissant les associations possibles à l’annuaire :
l
Personne
l
Liste de personnes
l
Liste de personnes avec coordinateur(s)
Utilisateur(s)
Liste des utilisateurs associés au participant
Un lien permet l’affichage d’un écran d’ajout ou suppression des
utilisateurs associés.
Groupe(s)1
Liste des groupes associés au participant
Un lien permet l’affichage d’un écran d’ajout ou suppression des groupes
associés.
Annuaire(s)1
Liste des annuaires associés au participant
Un lien permet l’affichage d’un écran d’ajout ou suppression des groupes
associés.
Coordinateur(s)2
Liste des coordinateurs associés au participant
Un lien permet l’affichage d’un écran d’ajout ou suppression des annuaires
associés.
1. Accessible uniquement aux participants de type Liste de personnes et Liste de personnes avec coordinateur
(s).
2. Accessible uniquement aux participants de type Liste de personnes avec coordinateur(s).
Associations avec un annuaire
Champs
Remarques
Nom *
Filtre par nom de personne
Disponible
Liste des associations possibles avec l’annuaire
Sélectonné
Liste des associations existantes avec l’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.
69
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
La matrice ci-dessous met en évidence les conditions permettant la modification du type d’un participant.
Suppression
Un participant ne peut pas être supprimé si la personne fait partie d’un processus ou est un gestionnaire de
dossier.
Applications
Écran des applications
Barre de menu
Liens
Remarques
Nouveau
Affiche l’écran d’édition des applications en mode ajout
Rafraîchir
Rafraîchit la liste des applications
Filtres
Filtrer sur *
Remarques
Nom
Filtre par nom d’application
Description
Filtre par description d’application
* Un filtre peut s’appliquer à une partie d’un champ.
Filtres externes
Remarques
Active uniquement
Affiche seulement les applications actives
70
71
Formulaire application
Champs
Remarques
Nom
Champ obligatoire
Identifiant unique pour l’application; doit être conforme à la nomenclature et
limité à 30 caractères
Description
Champ obligatoire
Description de l’application limitée à 255 caractères
Type
Types d’application possible
l
Application Web
l
Assembly
l
Procédure Web
l
Procédure Web Asynchrone
l
Service WCF
l
Service Web
URL
Champ obligatoire
URL relative ou absolue de l’application
WSDL
L’URL de WSDL pour définir un service Web (si nécessaire); voir la
section Services Web WSDL pour plus de renseignements sur les
services Web avec WSDL.
Nom d’utilisateur *
Nom d’utilisateur utilisé si une authentification est demandée pour accéder
à l’URL de l’application
Mot de passe *
Mot de passe utilisé si une authentification est demandée pour accéder à
l’URL de l’application
Encodage
Type d’encodage des données utilisé lors du retour de l’application vers
WorkflowGen
l
Par défaut (application/x-www-form-urlencoded)
l
Upload (multipart/form-data)
l
application/xml; charset=UTF-8
Paramètres
Paramètres de l’application
Un lien permet d’afficher la fiche d’édition des paramètres
Application par défaut
L’application est celle par défaut si l’option est sélectonnée
Actif
L’application active si l’option est sélectionnée
Schéma XML
Choissisez le type de Schéma XML entre ADO recordset ou WorkflowGen
Schéma embarqué
Le Schéma sera incorporé au XML si l’option est sélectonnée
* Requis seulement pour les procédures Web et les services Web.
Écran liste des applications
Liste des applications
Colonnes
Remarques
Ordre
Ordre d’affichage de l’application dans la liste
Nom
Nom de l’application
Un lien permet d’afficher la fiche d’édition de l’application
Description
Description de l’application
Actif
L’application est active
Utilisation
Nombre d’actions dans lesquelles l’application est utilisée
72
Écran liste des paramètres d’une application
Colonnes
Remarques
Nom
Nom du paramètre de l’application
Type de donnée
Type de donnée du paramètre de l’application
Direction
Direction du paramètre de l’application
Obligatoire
Paramètre obligatoire
Par défaut
Paramètre optionnel affiché dans la liste des paramètres des actions en
fonction de l’action actuelle
Suppresison *
Lien permettant la suppression du paramètre de l’application
* Le lien de suppression est identifié par un x visible seulement si l’application n’est pas utilisée par une action
d’un processus.
Pour ajouter un paramètre, cliquez sur le lien Ajouter en haut de la liste des paramètres.
73
Édition des paramètres d’une application
Champs
Remarques
Nom
Champ obligatoire
Nom du paramètre de l’application
Description
Champ obligatoire
Description du paramètre de l’application
Type de donnée
Type de donnée du paramètre de l’application
l
Texte
l
Numérique
l
Date/Heure
l
Fichier
Direction
Direction du paramètre de l’application
l
IN : Entrée (Input)
l
OUT : Sortie (Output)
l
INOUT : Entrée/Sortie (Input/Output)
Obligatoire
Le paramètre est-il obligatoire ?
l
Oui (désactive la propriété par défaut)
l
Non (autorise la propriété par défaut)
Défaut
La paramètre est affiché dans la liste des paramètres de l’action de
l’application actuelle si cette option est sélectionnée
Suppression d’une application
Une application ne peut pas être supprimée si elle est utilisée dans un processus.
74
75
Suppression d’un paramètre
Un paramètre ne peut pas être supprimé si son application est utilisée dans un processus.
Application de type assembly
Ce type d’application vous permet de déclarer une méthode .NET d’une classe comme une application de
workflow. C'est la solution la plus rapide pour développer une application de workflow personnalisée (par
rapport à des services Web). La performance d'exécution est exceptionnelle car WorkflowGen instancie
directement l’assembly sans communication réseau ou d'authentification du service Web.
Exemple :
1. Copiez un assembly .DLL dans le répertoire \wfgen\bin de WorkflowGen.
2. Dans le module d’administration, cliquez sur Applications, puis Nouvelle application.
3. Saissez les informations suivantes :
i. Nom : SAMPLE_GET_STRING
ii. Description : Retourne une chaîne de caractères avec « ! » (point d’exclamation)
iii. Type : Assembly
iv. Nom ou chemin de l’assembly : WorkflowAppSample
4. Cliquez sur Enregistrer.
Nom de la classe : Sélectonnez la class désirée « WorkflowApp.Test »
Méthode : Sélectionnez la méthode désirée « GetString »
Les paramètres suivants sont automatiquement générés :
IN message (Text)
OUT RETURN_VALUE (Text)
Vous pouvez maintenant utiliser votre application de workflow dans vos processus.
Application de type service Web WCF
Ce type d’application vous permet de déclarer un proxy client d’un service Web WCF comme application de
workflow.
Exemple :
1. Dans le module d’administration, cliquez sur Applications, puis Nouvelle application.
2. Saissisez les informations suivantes :
i. Nom : WCFSERVICE_SAMPLE_GET_STRING
ii. Description : Retourne une chaîne de caractères avec « ! » (point d’exclamation)
76
iii. Type : Service WCF
iv. Nom ou chemin de l’assembly : WorkflowAppWCFSampleTest
4. Cliquez sur Enregistrer.
Nom de la classe : Sélectonnez la class désirée « workflowAppWCFSampleTest.ServiceClient »
Méthode : Sélectionnez la méthode désirée « GetString »
Les paramètres suivants sont automatiquement générés :
IN message (Text)
OUT RETURN_VALUE (Text)
Vous pouvez maintenant utiliser votre application de workflow dans vos processus.
Name: WCFSERVICE_SAMPLE_GET_STRING
Services Web WSDL
Aperçu
WorkflowGen supporte les Web Services basés sur le standard SOAP. Les Web Services peuvent s’intégrer
avec WorkflowGen sans programmation et être utilisés par des actions de processus. Vous pouvez prédéfinir
des services web et les références en utilisant leurs fichiers WSDL (Web Services Description Language).
Il est nécessaire d’avoir un URL qui pointe au fichier de définition WSDL pour que les méthodes web se
rendent disponibles à WorkflowGen. Suite à l’ajout du WSDL (dans le répertoire d’application WorkflowGen),
la sélection d’un service web sera disponible, et les paramètres de l’application WorkflowGen sont générés
automatiquement.
Les types de données des paramètres sont associés aux types des données WorkflowGen correspondants
(numérique, texte, datetime, fichier). Tous les types XML complexes sont associés à une donnée de type
fichier.
Services Web publics
Les services de Web publics sont disponibles pour consomption publique. Pour voir un exemple
WorkflowGen, suivez l'exemple ci-dessous.
Créer un service Web WSDL
1. Dans le module d’administration, créez une nouvelle application et définissez ce qui suit :
i. Nom
ii. Description
iii. Type : service Web
iv. Nom d’utilisateur : [un administrateur valide de WorkflowGen]
v. Mot de passe : [le mot de passe valide pour le nom d’utilisateur]
2. Définissez un URL service Web valide et son WSDL associé, et sauvez l’application.
77
Exemple d’URL :
http://quickstarts.asp.net/QuickStartv20/webservices/Samples/MathService/vb/Server/MathServi
ce.asmx
l
Exemple WSDL :
http://quickstarts.asp.net/QuickStartv20/webservices/Samples/MathService/vb/Server/MathServi
ce.asmx?WSDL
l
3. Choissisez la méthode à employer. Le WSDL définit quelles méthodes sont disponibles. Suite à la
sélection d’une méthode Web, les paramètres associés seront automatiquement associés et
l'application pourra être employée par les actions de processus.
Exemple d’un service Web privé
Aperçu
Les services de Web privés sont des services de Web qui ne sont pas disponibles pour être réutilisés au
public. Ils emploient généralement un URL qui exige de l'authentification interne à votre organisation. Pour
voir un exemple WorkflowGen, suivez l'exemple ci-dessous.
Créer un service Web WSDL
1. Dans le module d’administration, créez une nouvelle application et définir ce qui suit :
i. Nom
ii. Description
iii. Type: Service Web
iv. Nom d’utilisateur : [un administrateur valide de WorkflowGen]
v. Mot de passe : [le mot de passe valide pour le nom d’utilisateur]
2. Définissez un URL Web Service valide et son WSDL associé et sauvez l'application.
L'exemple ci-dessous décrit l'utilisation d'un service Web situé sur un site Web 2007 de SharePoint.
Dans cet exemple, le Web Service s'appelle le « lists.asmx ». Pour plus d'information, référez-vous à
https://msdn.microsoft.com/fr-fr/library/ms445760.aspx.
l
Exemple d’URL : http://monserveursps/_vti_bin/lists.asmx
l
Exemple de WSDL : http://monserveursps/_vti_bin/lists.asmx?WSDL
3. Choissisez la méthode à employer.
Le WSDL définit quelles méthodes sont disponibles. Suite à la sélection d’une méthode Web, les
paramètres associés seront automatiquement associés et l'application pourra être employée par les
actions de processus.
78
Action de service Web de WSDL : paramètres supplémentaires
Aperçu
WorkflowGen créera quelques paramètres supplémentaires en mettant en référence un WSDL. Ces autres
paramètres peuvent être employés en plus de ceux déjà définis dans le dossier de WSDL.
Paramètres supplémentaires
Les autres paramètres qui sont définis par WorkflowGen sont les suivants :
l
RETURN_VALUE : Si le service Web renvoie une valeur, WorkflowGen ajoutera automatiquement un
paramètre OUT.
l
WFG_WS_URL : Spécifie un URL de service Web pour outrepasser l'URL prédéfini.
l
WFG_WS_USERNAME : Spécifie un nom d’utilisateur pour outrepasser le nom d’utilisateur prédéfini.
l
WFG_WS_PASSWORD : Spécifie un mot de passe pour outrepasser le mot de passe prédéfini.
Catégories
79
Écran catégorie
Barre de menu
Liens
Remarques
Nouveau
Affiche l’écran d’édition des catégories en mode ajout
Rafraîchir
Rafraîchit la liste des catégories
Filtres
Filtrer sur *
Remarques
Nom
Filtre par nom de catégorie
Description
Filtre par description de catégorie
Colonnes
Remarques
Nom
Nom de la catégorie
Un lien permet d’afficher la fiche d’édition de la catégorie
Description
Description de la catégorie
Utilisation
Nombre de processus listés dans la catégorie
Formulaire catégorie
Champs
Remarques
Nom
Champ obligatoire
Identifiant unique pour la catégorie; doit être conforme à la nomenclature et
Description
Champ obligatoire
Description de la catégorie limitée à 255 caractères
80
Suppression
Une catégorie ne peut pas être supprimée si elle est utilisée par un processus.
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ée. Le contenu de la liste est
mis à jour à chaque fois que le formulaire est éxécuté.
Écran des listes globales
81
Barre de menu
Liens
Remarques
Nouvelle liste
Affiche une nouvelle ligne vierge à la liste des listes globales
Rafraîchir
Rafraîchit les listes globales
Importer
Importe des données depuis un format CSV ou XML en remplacement du
contenu d’une liste globale existante ou créé une nouvelle liste globale
Ceci est utlie pour rapidement alimenter une liste globale depuis un fichier
ou un copier/coller
Exporter
Exporter des données dans un fichier CSV ou XML
Ceci est utile pour exporter des données de multiples environnements
(développement, production, etc...)
Dupliquer
Dupliquer une liste globale
Supprimer
Supprimer une liste globale
Filtres
Filtrer sur *
Remarques
Nom
Filtre sur le nom de la liste globale
Gestionnaire
Filtre sur le nom du gestionnaires de la liste globale
Date de mise à jour
Filtre sur la date de mise à jour (période du/au)
Utilisateur de la mise à jour
Filtre sur le dernier utilisateur qui à mis à jour la liste (nom ou prénom)
Liste de listes globales
Colonnes
Remarques
Nom
Nom de la liste
Gestionnaire
Aucun (aucune restriction) ou le participant autorisé à mettre à jour la liste
Vous pouvez restreindre l’accès à la liste globale aux utilisateur(s) contenu
(s) dans un participant global
Contenu
Nombre d’éléments et/ou lien vers le formulaire de la liste globale
Dernière màj
Date et heure de la dernière mise à jour
Par
Dernier utilisateur ayant mis à jour la liste globale
Formulaire de listes globales
Onglets
Remarques
Eléments
Pour ajouter des éléments statiques dans la liste globale
Colonnes
Pour ajouter des colonnes
Types de données supportés :
l
Texte
l
Numérique
l
Date
Par défaut les colonnes sont Texte (données de type texte) et Valeur
(données de type valeur)
Liaison
Chaîne de connexion à la base de données liée :
l
Nom de la chaîne de connexion définit dans le fichier web.config de
WorkflowGen par l’administrateur
l
Chaîne de connexion à la base de données
l
Requête SQL (commande SELECT) pour récupérer les données
Importer des données
Vous pouvez importer des données dans une liste globale depuis un fichier ou en copier de votre pressepapiers. Les formats supportés sont les listes globales WorkflowGen XML ou CSV.
Le format CSV doit être comme suit :
COL_NAME[,...n]
["TEXT|NUMERIC|DATE"[,...n]]
VALUE[ ,...n]
Exemples :
Importation uniquement des colonnes texte
82
83
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.
iso,country
AD,Andorra
AE,United Arab Emirates
AF,Afghanistan
AG,Antigua and Barbuda
AI,Anguilla
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.
Id,iso,Country
NUMERIC,TEXT,TEXT
1,AD,Andorra
2,AE,United Arab Emirates
3,AF,Afghanistan
4,AG,Antigua and Barbuda
5,AI,Anguilla
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.
Id,Lastname,Firstname,Address,Birthday
NUMERIC,TEXT,TEXT,TEXT,DATE
1,DOE,John,"1111 N. Sample, Mt. Prospect, IL 60000","01/01/1980"
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.
84
Définition de processus
Aperçu
Les processus sont organisés en dossiers administrés par des gestionnaires. Un niveau unique de dossier est
possible dans WorkflowGen.
La notion de gestionnaire de dossier intervient lorsqu’un dossier est associé à un participant de type liste de
personnes. Un gestionnaire correspond à une ou plusieurs personnes ; la liste de personnes avec
coordinateur n’est pas significatif ici. Les gestionnaires ont un accès complet à la définition de leurs
processus.
Les gestionnaires de dossier ont un accès complet aux processus de leur dossier mais pas aux processus
des autres dossiers ou aux autres fonctions d’administration.
Les utilisateurs avec un profil d’administrateur WorkflowGen ont un accès complet à tous les dossiers et leurs
processus associés, mais n’ont pas accès aux fonctionnalités administratives.
Un processus peut avoir plusieurs versions, mais seulement un peut être actif en même temps. Les
demandes courantes effectuées en utilisant des versions archivées continueront avec les définitions de
processus respectives de ces versions, jusqu’au moment où elles soient clôturées.
Un processus peut être déclaré en tant que sous-processus et ainsi être utilisé à travers une action d’un autre
processus en tant que sous-processus indépendant ou lié.
La définition d’un processus utilise les paramètres définis dans les concepts du workflow :
l
Participants (demandeur, acteur)
l
Données pertinentes (formulaire, accord, montant, etc...)
l
Actions (trouver des informations, valider, gérer, attendre)
l
Transitions (actions suivantes, conditions)
l
Méthodes d’affectations (automatique, manuelle, etc...)
l
Notifications (d’affectation, de clôture, etc...)
La définition d’un processus implique un nombre de règles de gestion important. Afin de simplifier sa mise en
œuvre, WorkflowGen regroupe la définition des processus en cinq sections :
Information du processus
Ces informations décrivent la publication du processus (statut, version) et les paramètres généraux
(archivage, notification de clôture).
Participants
Les participants globaux sélectionnés ou spécifiquement créés pour les processus et prenant le rôle de
demandeur ou intervenant.
Données
Données pertinentes et nécessaires au déroulement du processus.
Formulaire
L’éditeur intégré permettant une création en mode WYSIWYG du formulaire utilisé par le workflow.
Workflow
Une définition des actions et les transitions associées, les conditions et les exceptions.
Plein écran / Quitter le plein écran
Affiche ou quitte le mode d’affichage plein de la définition du processus.
Rapport
Un aperçu général de tous les paramètres utilisés dans la définition d’un processus ainsi que l’identification
des erreurs de conception. Des statistiques d’usage du processus concerné sont également présentées.
Test
Vous permet de tester le processus si le statut est défini à En test. Pour effectuer un test, le gérant du
dossier/process doit être un des initiateurs du processus.
Dossier
Écran liste des dossiers
85
Barre de menu
Liens
Remarques
Nouveau dossier
Affiche l’écran d’édition des dossiers en mode ajout
Rafraîchir
Rafraîchit la liste des dossiers
Filtres
Filtrer sur *
Remarques
Nom
Filtre par nom de dossier
Description
Filtre par description de dossier
Liste des dossiers
Colonnes
Remarques
Dossier
Nom de dossier
Un lien permet d’afficher la liste des processus contenus ddans le dossier
Description
Description du dossier
Processus
Nombre de procuessus contenus dans le dossier
Éditer
Un lien permet d’afficher la fiche d’édition du dossier
Écran dossier
Formulaire dossier
Champs
Remarques
Nom du dossier
Champ obligatoire
Identifiant unique pour le dossier; doit être conforme à la nomenclature et
Description
Champ obligatoire
Description du dossier limitée à 255 caractères
86
Gestionnaire
Champ obligatoire
Nom du participant global gérant le dossier
Gestionnaire de processus
Un gestionnaire de processus doit être un participant global de type personne ou liste de personnes.
Suppression d’un dossier
Un dossier ne peut pas être supprimé s’il contient des processus.
Liste des processus
Écran liste de processus
Barre de menu
Liens
Remarques
Nouveau processus
Affiche l’écran d’édition des processus en mode ajout
Rafraîchir
Met à jour la liste des processus
Supprimer
Supprime un processus
Filtres
Filtrer sur *
Remarques
Nom
Filtre par nom de processus
Description
Filtre par description de processus
87
Filtres externes
Remarques
Statut
Filtre par statut des processus
Liste des processus
Colonnes
Remarques
Nom
Nom et version du process
Affiche l’écran d’édition du processus
Description
Description du processus
Statut
Statut du processus
Édition d’un processus
Écran informations d’un processus
88
89
Barre de menu
Liens
Remarques
Infos
Affiche l’écran d’édition des processus en mode ajout
Participants
Affiche la liste des participants du processus
Données
Affiche la liste des données du processus
Formulaire
Affiche l’éditeur du formulaire
Workflow
Affiche la liste des actions du processus
Liens supplémentaires
Liens
Remarques
Plein écran
Affiche le contenu des différents onglets de la barre de menu en plein écran
Rapport
Affiche la documentation du processus et vérifie la validité de la définition
du processus
Tester
Lance une nouvelle demande test pour ce processus
90
Formulaire processus
Champs
Remarques
Modèle
Sélection d’un modèle de workflow directement testable, modifiable et
utilisable parmi la liste « Par défaut » ou dans la « librairie »
Défaut :
l
Deux niveaux d’approbation
l
Actions en parallèle
l
Approbation simple
l
Demande simple
Librairie :
l
Demande de changement informatique
l
Demande de congés
l
Demande d’investissement
l
Demande de support
l
Demande de travaux
l
Demande d’habilitation informatique
l
Création d’un nouveau produit
l
Note de frais
Un modèle de workflow personnalisé peut être créé et déployé sur le
serveur avec la structure de dossier et fichiers suivante :
\wfgen\App_Data\Templates\Processes\[langue]\[nom du dossier]\[nom
du processus]v[x].xml
Exemple :
\wfgen\App_Data\Templates\Processes \Fr\MonEntreprise\MON_
PROCESSUSv1.xml
Note : Seuls les processus avec formulaire intégré sont supportés en tant
que modèle de workflow.
Nom
Champ obligatoire
Identifiant unique pour le processus; doit être conforme à la nomenclature
Version
Le numéro de version du processus est en lecture seule et utilise un
incrément automatique par défaut
Description
Champ obligatoire
Description du processus limitée à 255 caractères
Statut
Statut du processus :
l
Actif
l
En test
l
En construction (par défaut)
l
Archivé
Formulaire intégré
Activer l’éditeur de formulaire intégré
Sous-processus
Détermine si un processus peut être utilisé en tant que sous-processus par
un autre processus ou par lui-même
Niveau d’accès
91
Champ obligatoire si l’option sous-processus est sélectionnée
Si le processus a été déclaré en tant que sous-processus, vous pouvez
choisir entre deux niveaux d’accès
l
Privé : le processus peut seulement être instancié par un processus
parent
l
Publique : le processus peut être exécuté manuellement depuis le
module utilisateur ou instancié par processus parent ou une
application externe
Catégories
Un lien permet d’afficher l’écran avec la liste des catégories associées
Délai de réalisation
Délai avant que le processus ne soit considéré comme en retard
Unités :
l
Années
l
Mois
l
Jours (prend en compte les jours ouvrés)
l
Heures (prend en compte les jours et heures ouvrés)
l
Minutes (prend en compte les jours et heures ouvrés)
l
Secondes (prend en compte les jours et heures ouvrés)
Vous pouvez choisir la manière dont le délai sera calculé en sélectionnant
(ou pas) l’option Tenir compte des jours/heures ouvrés lors du calcul
du délai.
Tenir compte des
jours/heures ouvrés lors du
calcul du délai
Calculer la durée en fonction des heures de bureau
Notifier le demandeur de la
clôture
Envoi un email au demandeur du processus lors de la clôture du processus
(sélectionné par défaut)
Archiver les résultats des
actions
Enregistre le résultat de chacune des actions de la demande à chaque
étape du processus (désélectionné par défaut)
Si cette option n’est par activée, tous les fichiers intermédiaires sont
supprimés lors de la clôture de la demande.
Stockage de données de
processus
Permet de stocker les données de type fichier (fichier joint compris) dans la
base de données afin de permettre une sauvegarde sans interruption de
service (les utilisateurs peuvent continuer à travailler pendant la
sauvegarde)
Texte d’aide
Texte d’aide sur le processus dans le module utilisateur
Un lien permet l’édition de ce texte.
Lien d’aide
URL d’un document d’aide externe sur le processus, visible dans le module
utilisateur
Test
Teste le lien d’aide dans un nouveau navigateur Windows
Email de support
Email de support du processus affiché dans le module utilisateur
Actions d’un processus
Fonctions
Remarques
Nouvelle version
92
Crée une nouvelle version lors du processus de construction avec la
possibilité de créer une nouvelle version depuis un fichier de définition
XPDL
Le numéro de version trouvé dans le XPDL sera conservé si celui-ci n’est
pas déjà utilisé pour le processus actuel, sinon l’incrément automatique est
utilisé.
Dupliquer
Duplique la définition du processus vers un nouveau processus
Déplacer
Permet le déplacement vers un nouveau dossier
Exporter
Permet l’exportatiion du processus dans un fichier XPDL
Importer
Permet la création du processus depuis un fichier XPDL
Supprimer les demandes
Affiche l’écran de suppression des demandes
Suppression des demandes
Champs
Remarques
Type de demande
Type des demandes à supprimer
l
Toutes
l
En test
l
Réelles
Statut des demandes
Statut des demandes à supprimer
l
Toutes
l
En cours
l
Clôturée
l
Clôturée – terminée
l
Clôturée – annulée
Période d’exécution
Définit la période d’exécution des demandes à supprimer
Des pictogrammes affichent un calendrier permettant de choisir la date
visuellement.
Numéro des demandes
Numéro des demandes à supprimer (séparée par des virgules)
Suppression d’un processus
Seuls les gestionnaires et les administrateurs peuvent supprimer un processus. La suppression d’un
processus induit la suppression des demandes associées.
Si le processus possède des demandes « réelles », seuls les administrateurs peuvent supprimer le
processus. La suppression est seulement autorisée si le processus n’est pas utilisé en tant que sousprocessus par une action d’un autre processus.
Suppression des demandes d’un processus
Les demandes associées à un processus en test peuvent seulement être supprimées par le gestionnaire de
processus ou un administrateur.
Les demandes associées à un processus actif peuvent seulement être supprimées par un administrateur.
93
Restrictions opérationnelles sur les processus avec un statut actif ou
archivé
Si le processus est actif, les opérations sur celui-ci sont limitées aux suivantes :
l
Modification du statut du processus
l
Modification des catégories du processus
l
Modification du texte, du lien ou de l’email de support du processus et des actions
l
Suppression du processus
l
Création d’une nouvelle version du processus
l
Duplication du processus
l
Suppression des demandes associées
l
Modification des associations du participant avec les annuaires
l
Modification des attributs des données (sauf leurs sécurités)
Si le processus est archivé, les opérations sur celui-ci sont limitées aux suivantes :
l
Suppression du processus
l
Création d’une nouvelle version du processus
l
Duplication du processus
l
Suppression des demandes associées
l
Modification des associations du participant avec les annuaires
l
Modification des attributs des données (sauf leurs sécurités)
L’activation d’un processus induit l’archivage de la version active. Les demandes en cours utilisent la version
du processus active au moment de leur création.
Modification d’un dossier
Seul l’administrateur WorkflowGen peut déplacer un processus d’un dossier à un autre. Ceci n’impacte pas
les utilisateurs finaux, mais pourrait impacter quels gestionnaires de processus ou de dossier pourront
accéder au processus.
94
Catégories d’un processus
Zone / Actions
Remarques
Disponibles
Catégories disponibles
Sélectonnées
Catégories sélectionnées
Ajouter ...
Lien vers un simple écran d’jout des catégories
Cliquez >> ou double-cliquez sur un
élément de la liste Disponibles
Ajoute les catégories sélectionnées dans la liste Disponibles dans
la liste Sélectionnées
Cliquez << ou double-cliquez sur un
élément da le liste Sélectionnées
Supprime les catégories de la liste Sélectionnées
Enregistrer
Enregistre les modifications
Fermer
Ferme la fenêtre
Exportation et importation de la définition XPDL d’un processus
Seul un administrateur WorkflowGen ou un gestionnaire de processus peuvent exporter et importer un
processus dans un fichier au format XPDL.
Éléments de processus exportés
Éléments
Description
Informations de processus
Toutes les informations générales du processus
Participants
Toutes les informations des participants
Données
Toutes les informations des données
Formulaire
Toutes les informations du formulaire
Workflow
Toutes les informations des action du workflow
95
Éléments de processus importés
Éléments
Description
Informations de processus
Toutes les informations générales du processus
Participants
Toutes les informations des participants
Données
Toutes les informations des données
Formulaire
Toutes les informations du formulaire
Workflow
Toutes les informations des actions du workflow
Note : Depuis la version 5.1.7, un processus qui comprend une notification préalable de retard dans une
action ne peut pas être importé dans une version WorkflowGen 5.1.6 ou inférieure en raison d'incompatibilités.
Règles d’importation pour des éléments spécifiques du processus
Éléments
Règles
Version du processus
Lors de la création d’un nouveau processus par importation d’un
XPDL, le numéro de version du processus dans le XPDL sera
utilisé.
Lors de la création d’un nouveau processus depuis la base de
données WorkflowGen, le numéro de version du nouveau processus
sera le dernier numéro de version disponible.
Lors de la création d’une nouvelle version d’un processus par
importation d’un XPDL, le numéro de version du nouveau processus
sera le numéro de version dans le XPDL si ce numéro n’a pas déjà
été utilisé; sinon le dernier numéro de version sera automatiquement
incrémenté pour le nouveau processus.
Catégorie du processus
Aucune catégorie ne sera ajoutée au processus si l’information
catégorie n’est pas présente dans le fichier XPDL.
Si la catégorie n’existe pas dans WorkflowGen elle ne sera pas
ajoutée au processus.
Notification de clôture du processus
au demandeur
La notification sera sélectionnée si la valeur de notification n’est pas
présente dans le fichier XPDL ou si la valeur est définie à « Y ».
Si la valeur est définie à « N » dans le fichier XPDL alors la
notification est désélectionnée.
Portée du participant
96
Si la portée n’est par présente dans le fichier XPDL, les règles
d’importations seront les mêmes que pour ces participants du
processus définies ci-dessous.
Participant global : Si le participant global existe déjà dans
WorkflowGen et est utilisé pour le processus importé, les
utilisateurs, groupes, annuaires et coordinateurs du participant
global existant peuvent être mis à jour avec ceux définis dans le
fichier XPDL (seulement si l’option Importer les associations de
l’annuaire est sélectionnée).
Participant processus : Si le participant global n’existe pas dans
WorkflowGen, le participant actual sera créé en tant que participant
global (seulement si l’option Importer les nouveaux participants
en tant que globaux n’est pas sélectionnée); sinon le participant
global existant sera associé avec le processus actuel.
Si le participant global existe déjà dans WorkflowGen et est utlisé
pour le processus actual importé, les utilisateurs, groupes,
annuaires et coordinateurs du participant global existant peuvent
être mis à jour avec ceux définis dans le fichier XPDL (seulement si
l’option Importer les associations de l’annuaire est
sélectionnée).
Utilisateur(s) associé(s) au
participant
Aucun utilisateur ne sera ajouté au participant si les informations des
utilisateurs sont manquantes dans le fichier XPDL.
Si l’utilisateur n’existe pas dans WorkflowGen il ne sera pas ajouté
au participant.
Groupe(s) associé(s) au participant
Aucun groupe ne sera ajouté au participant si les informations des
groupes sont manquantes dans le fichier XPDL.
Si le groupe d’un annuaire n’existe pas dans WorkflowGen il ne sera
pas ajouté au participant.
Annuaire(s) associé(s) au
participant
Aucun annuaire ne sera ajouté au participant si les informations des
annuaires sont manquantes dans le fichier XPDL.
Si l’annuaire n’existe pas dans WorkflowGen il ne sera pas ajouté au
participant.
Coordinateur(s) associé(s) au
participant
Aucun coordinateur ne sera ajouté au participant si les informations
des coordinateurs sont manquantes dans le fichier XPDL.
Si le coordinateur n’existe pas dans WorkflowGen il ne sera pas
ajouté au participant.
Sécurité des données
Dans le cas d’accès autorisés pour des participants spécifiques, si
l’utilisateur n’existe pas dans WorkflowGen il ne sera pas ajouté à la
liste d’autorisation d’accès.
97
Prodédure d’importation
1. Cliquez sur Importer.
2. Parcourir l’explorateur de fichier vers le fichier XPDL.
3. Sélectionnez l’option Importer les nouveaux participants en tant que participants globaux.
l
l
Si les participants du processus exporté étaient à l'origine les participants globaux, ils seront
toujours importés en tant que participants globaux.
Si les participants du processus exporté étaient à l'origine les participants spécifiques de
processus, la sélection de cette option les importera en tant que participants globaux. Si laissé non
sélectionné, ils seront importés en tant que participants spécifiques de processus.
4. Sélectionnez l’option Importer les associations avec l’annuaire pour importer les utilisateurs
manquants dans les participants globaux existants.
5. Sélectionnez l’option Importer le numéro de version du processus pour importer le numéro de
version.
6. Cliquez sur Importer pour commencer l’importation.
Participants d’un processus
Écran liste des participants d’un processus
Colonnes
Remarques
Ordre
Les flèches permettent la modification de l’ordre d’affichage du participant
Nom
Nom du participant
Un lien affiche l’écran du participant. Le lien Ajouter permet d’associer un
participant global ou de créer un nouveau participants spécifique au
processus.
Description
Rôle
Rôle du participant dans le processus
Utilisateurs
Nombre d’utilisateurs potentiels du participant
98
Champs
Remarques
Portée
Information de portée : Processus ou Global
Nom1
Champ obligatoire
Identifiant unique pour le participant (même les globaux); doit être
conforme à la nomenclature et limité à 30 caractères
Description1
Champ obligatoire
Description du participant limité à 255 caractères
Rôle2
l
Demandeur
l
Acteur
l
Superviseur du processus5
99
Type de participant1
Champ obligatoire
Type de participant, définissant les associations possibles avec
l’annuaire :
l
Personne
l
Liste de personnes
l
Liste de personnes avec coordinateur(s)
Utilisateur(s)
Liste des utilisateurs associés au participant
Un lien permet l’ajout ou la suppression des utilisateurs.
Groupe(s)3
Liste des groupes associés au participant
Un lien permet l’ajout ou la suppression des utlisateurs
Annuaire(s)3
Liste des annuaires associés au participant
Un lien permet l’ajout ou la suppression des annuaires
Coordinateur(s)4
Liste des coordinateurs associés au participant
Un lien permet l’ajout ou la suppression des coordinateurs.
Suivi graphique
Autorise les utilisateurs associés au participant à visualiser le suivi
graphique des demandes du process et l’aide graphique du processus
depuis le portail d’utilisateur
Permissions pour
superviseurs
l
l
l
Permissions pour
commentaires
l
l
l
100
Réaffecter les actions en cours
Annuler les demandes en cours
Accéder aux statistiques
Aucune : La liste des commentaires ne sera pas accessible aux
utlisateurs du particpant
Lire : Les utilisateurs du participant peuvent accéder à la liste des
commentaires en lecture
Lire + Écrire : Les utilisateurs du participant peuvent consulter et
envoyer de nouveaux commentaires.
Note : Les superviseurs du processus auront toujours les permissions de
lecture et écriture.
Requête (Aide)
La fonctionnalité de portée limitée des superviseurs permet aux
participants de type « Superviseur de processus » le filtrage dynamique
des demandes et des actions
Un lien pour effectuer un test est disponible pour valider la syntaxe de la
requête.
1. En mode lecture seule si le participant est de type global.
2. Un demandeur unique est autorisé par processus.
3. Accessible seulement aux participants de type Liste de personnes et Liste de personnes avec coordinateur.
4. Accessible seulement aux participants de type Liste de personnes avec coordinateurs.
5. Le participant superviseur ne doit pas être obligatoirement associé à une action.
Association avec un annuaire
Champs
Remarques
Nom *
Filtre par nom de personne
Disponible
Liste des associations posisbles avec l’annuaire
Sélectionné
Liste des associations actuelles avec l’annuaire
101
* Visible seulement si associé à un utilisateur ou un coordinateur et lorsque le nombre d’utlisateurs dans la base
est supérieur à la limite définie par l’administrateur du logiciel.
Un participant de type Personne est associé à un seul utilisateur.
Un participant de type Liste de personnes est associé à un ou plusieurs utilisateurs ou groupes ou
annuaires.
Un participant de type Liste de personnes avec coordinateur est associé à un ou plusieurs coordonnateurs
et à un ou plusieurs ou groupes ou annuaires.
Suppression
Un participant ne peut pas être supprimé si la personne est associée à une action d’un processus.
Ajout d’un participant global
Un participant global ne peut être associé qu’une seule fois avec un processus.
Demandeur d’un processus
Il ne peut y avoir qu’un seul participant de rôle Demandeur dans un processus.
Superviseur d’un processus
Il peut y avoir plusieurs participants de rôle Superviseur dans un processus, chacun avec sa propre
configuration de sécurité et de suivi précisée dans la requête de portée limitée des superviseurs.
Modification du type d’un participant
La matrice ci-dessous met en évidence les conditions permettant la modification du type d’un participant.
102
Portée limitée des superviseurs
Aperçu
La fonctionnalité de portée limitée des superviseurs permet aux participants de type Superviseur de
processus le filtrage dynamique des suivis des demandes et des actions. Lorsqu'un utilisateur est associé à
un participant de type « Superviseur de process » avec une requête de portée limitée définie, sa page
d’accueil de suivis, sa portlet de syndication rss, ses résultats de recherche de suivis et ses rapports de
statistiques seront filtrés d’après la requête. La requête est définie avec des conditions de critères dont la
syntaxe est comparable aux conditions de critères SQL. De plus, la définition de la requête, plus
spécifiquement les critères de filtrage, supporte l'utilisation les champs du profil d’utilisateur et les données de
processus.
Définitions
Participants du process
La requête de portée limitée des superviseurs peuvent être défini par les participants de type Superviseur de
processus seulement. Pour activer la fonctionnalité de la portée limitée, il s’agit seulement de définir la
requête pour un superviseur de process existant ou en créant un participant à nouveaux. La requête est limitée
à un maximum de 255 caractères.
Si la requête non défini, le superviseur peuvent accéder tous les demandes et tous les actions d’un
processus.
Aide
L’aide en ligne est disponible pour la requête de portée limitée des superviseurs en cliquant le lien Aide.
103
Validation syntaxe des requêtes
Cliquez le lien Test pour valider la syntaxe de la requête de portée limitée. Une sauvegarde d’une requête non
valide n’est pas autorisée.
104
Liste des champs et macros disponibles pour l’usage dans la requête
Voici une liste des champs et macros disponibles pour l’utilisation dans une demande de portée limitée des
superviseurs. Les champs disponibles sont ceux disponibles dans le profil des utilisateurs. Les données d’un
processus peuvent aussi être utilisées comme valeur de comparaison dans les critères de conditions pour
que la requête puisse filtrer les résultats.
Exemples :
Cet exemple produit les demandes/actions pour les utilisateurs dans la province du Québec :
STATE = 'QC'
Cet exemple produit les demandes/actions pour les utilisateurs dont l’adresse email se termine avec
« advantys.com » :
EMAIL LIKE '%ADVANTYS.COM'
Cet exemple produit les demandes/actions pour les utilisateurs faisant parti du groupe MONGROUPE :
105
{ISMEMBER(MONGROUPE)}
Cet exemple produit les demandes/actions dont le département est égal à la valeur d’une donnée de process
DEPT_DATA :
DEPT_DATA:
DEPARTMENT = @DEPT_DATA
Cet exemple produit les demandes/actions dont la ville de l’utilisateur est égale à la valeur d’une donnée de
process MA_VILLE et le pays de l’utilisateur est égal à la valeur d’une donnée de process MON_PAYS :
CITY = @MA_VILLE AND 'CANADA' = @MON_PAYS
Champs disponibles et définitions
LASTNAME
Nom
FIRSTNAME
Prénom
EMAIL
Email
PHONE
Téléphone
MOBILE
Portable
PAGER
Téléavertisseur
FAX
Fax
OFFICE
Bureau
DEPARTMENT
Département
COMPANY
Société
JOBTITLE
Fonction
PERSONALTITLE
Titre
EMPLOYEENUMBER
Matricule
EMPLOYEETYPE
Type d’employé
POSTALADDRESS
Adresse postale
POSTALCODE
Code postal
CITY
Ville
STATE
État/Région
COUNTRY
Pays
EXTATT_1
Champs personnalisé 1
EXTATT_2
EXTATT_3
EXTATT_4
EXTATT_5
Macros disponibles et définitions
{ISMEMBER(groupname)} *
Membre du groupe ‘groupname’
{ISMANAGER(username)} *
Responsable de l’utilisateur ‘username’
{ISSTAFFMEMBER(username)} *
Collaborateur de l’utilisateur ‘username’
106
* Les macros supportent seulement du texte statique comme paramètre. Indiquer le nom d’un champ dans le
processus n’est supporté. Par exemple :
Valide : {ISMEMBER(my_group_name)}
Non valide : {ISMEMBER(@GROUP_NAME)}
Informations supplémentaires
Opérateurs de comparaison
Vous pouvez utiliser les opérateurs de comparaison standards SQL tels que =, !=, <>, IS NULL, NOT IS
NULL, LIKE, NOT LIKE, etc...
Pour une meilleure compatibilité, il est recommandé d’utiliser les opérateurs standards qui sont supportés par
la base de données hébergeant WorkflowGen.
Exemple :
Cet exemple produit les demandes/actions des utilisateurs qui ne sont pas situés à Montréal :
CITY <> 'MONTREAL'
Opérateurs logiques et parenthèses
Vous pouvez utiliser les opérateurs standards de SQL tels que AND et OR pour combiner plusieurs critères
de conditions jusqu’à un maximum de 255 caractères. Il est fortement recommandé d’utiliser des parenthèses
pour logiquement enclore plusieurs critères ensembles.
Exemple :
Cet exemple produit les demandes/actions dont l’utilisateur est situé au Canada, plus précisément soit à
Toronto ou à la valeur contenue dans la donnée du processus CITY_DATA :
COUNTRY = 'CANADA' AND (CITY = 'TORONTO' OR CITY = @CITY_DATA)
Valeurs texte
Les valeurs texte utilisé dans les critères de conditions doivent être comprises entre apostrophes. Les
guillemets ne sont pas supportés comme délimiteurs mais sont valide comme valeur de critère. Les
caractères de remplacement tel que « % » et « _ » peuvent être utilisé avec l’operateur LIKE.
Exemple :
Cet exemple produit les demandes/actions dont le nom débute avec ‘AN’ :
LASTNAME LIKE 'AN%'
Données de processus
Vous pouvez utiliser les données du processus dans les critères de conditions pour filtrer les demandes
dynamiquement car la valeur des données peuvent différer d’une demande à l’autre. Vous devez tout
107
simplement faire appel aux données de processus et les préfixer avec le caractère « @ » (a-commercial).
Exemple :
Cet exemple renvoie les demandes/actions dont la société de l’utilisateur est égale à la valeur de la donnée de
processus DATA1 :
COMPANY = @DATA1
(« DATA1 » est utilisé comme exemple; n’importe quelle donnée de processus peut être utilisée.)
Note : Assurez-vous que les noms des données du processus utilisés comme critères de conditions soient
identiques à ceux définis dans WorkflowGen.
Macros
Vous pouvez aussi utiliser des macros dans les critères de conditions des requêtes. Vous devez tous
simplement ajouter une macro de la liste des macros disponibles à votre critère de conditions.
Exemple :
Cet exemple produit les demandes/actions dont l’utilisateur est membre du groupe Dev situé à Montréal.
CITY = 'MONTREAL' and {ISMEMBER(Dev)}
Note : Il est très important de respecter la syntaxe des macros disponibles dans la liste de macros.
Impacts d’exécution
portée limitée est appliquée avec des opérateurs LIKE et/ou les caractères de substitution (« % », « _ ») dans
les critères de conditions. La raison est due à la grande quantité d’information qui aura besoin d’être filtré par le
moteur de workflow avant d’être affichée aux utilisateurs.
Nous suggérons de tester l’impact de la requête de portée limitée des superviseurs dans une environnent de
développement avant de la mettre en production.
108
Écran liste des données
Liste des données
Colonnes
Remarques
Ordre d’affichage
Les flèches permettent la modification de l’ordre d’affichage des données
atteignable également par glisser-déposer
L’ordre d’affichage des données s’affecte également l’ordre des données
affichées aux utilisateurs dans le portail.
Nom
Nom de donnée
Un lien affiche l’écran d’édition de la donnée. Le lien Ajouter permet
d’afficher l’écran des données en mode ajout.
Description
Description de donnée
Type de donnée
Type de donnée
Direction *
Direction du paramètre de sous-processus
* Uniquement affiché si le processus est défini en tant que sous-processus.
Formulaire d’édition de donnée
Donnée de type fichier
109
110
Donnée de type texte, numérique ou date/heure
Édition de données
Champs
Remarques
Nom
Champ obligatoire
Identifiant unique pour la donnée; doit être conforme à la nomenclature et
Parcourir
Liste les identifiants de tous les champs du formulaire créés avec l’éditeur
intégré et permet de sélectionner manuellement les champs à l’aide de leur
identifiant à déclarer en données du processus.
Note : Ce bouton est affiché sur le formulaire d’addition de données.
Description
Champ obligatoire
Description de la donnée limitée à 255 caractères
Type de donnée
Champ obligatoire
Type de donnée :
l
Texte
l
Limitée à 4000 caractères
l
Détection automatique des URLs et adresses email qui ensuite les
affiche comme liens au lieu de textes ordinaires
l
Numérique
l
Date/Heure
l
Fichier
Valeur par défaut
111
Valeur par défaut de la donnée
Un lien affiche l’écran d’édition de la valeur par défaut
Format
112
Seulement applicable aux données de type numérique et date/heure. Après
avoir sauvegardé les données le menu déroulant Format sera rempli avec
les formats suivants :
Formats numériques :
l
Personnalisé (défini par l’usager)
l
Devise ({0:C})
l
Décimal ({0:D})
l
Scientifique ({0:E})
l
Virgule fixe ({0:F})
l
Standard ({0:G})
l
Nombre ({0:N})
l
Pourcentage ({0:P})
l
Aller-retour (float) ({0:R})
l
Héxadécimal ({0:X})
Formats date/heure :
l
Personnalisé (défini par l’usager)
l
Date courte
l
Date longue
l
Date/heure complète (heure courte)
l
Date/heure complète (heure longue)
l
Date/heure générale (heure courte)
l
Date/heure générale (heure longue)
l
Mois jour
l
Date/heure aller-retour
l
Date/heure RFC 1123
l
Date/heure triable (ISO 8601)
l
Heure courte
l
Heure longue
l
Date/heure universelle triable
l
Date/heure universelle complète
l
Année mois
Personnalisée
Affichage format associé
Autorise les formats personnalisés à être spécifié si le format
« personnalisé » est spécifié ci-dessus.
Précision
Nombre de places décimal à afficher (pour les formats applicables)
Culture
Force l’affichage des données en utilisant la culture choisie (format de
langue)
Valeur par défaut est la culture de l’usager courant.
Fuseau horaire
Applicable uniquement aux données de type « date/heure » , en précisant
un fuseau horaire spécifique forcera les données d’afficher en utilisant le
fuseau horaire sélectionné
La valeur par défaut est le fuseau horaire de l’utilisateur courant.
Nouveau fichier1
Fichier à ajouter ou à mettre à jour
Parcourir
Affiche une fenêtre pop-up de recherche de fichiers
Paramètre de sousprocessus2
Direction de la donnée lorsqu’utilisé en tant que paramètre par le processus
parent
Sécurité
Définit les participants qui ont accès aux données
Un lien permet de limiter l’accès de la donnée à certains participants ou
processus
Note : Vous ne pouvez que choisir des participants définis comme type
« demandeur » ou « acteur ».
Visibilité
Permet la définition des options de visibilité
113
Note : La visibilité des données est toujours modifiable sur les processus
actifs.
Option 1 : Afficher la donnée dans la fiche de suivi (sélectionnée par
défaut)
La donnée sélectionnée sera visible aux endroits suivants :
l
Formulaires de demande et de suivi
l
Messages de notification par défaut (emails)
l
Fenêtre pop-up des données eFormPDF
l
Liste des critères de recherche
Note : La désélection de cette option désactive et désélectionne les trois
autres.
Option 2 : Critère de recherche par défaut (non sélectionnée par
défaut)
La donnée sélectionnée sera affichée dans chaque écran de recherche en
tant que critère de recherche par défaut sans paramètre.
Note : Vous pouvez seulement filtrer par données définies dans la version
active du processus ou la dernière version si aucune n’est active.
Option 3 : Affichage en colonne dans les listes (non sélectionnée
par défaut)
La donnée sélectionnée sera affichée dans chaque liste d’action ou de
demande lorsqu’un unique processus est sélectionné (mode processus
simple)
Option 4 : Affichage en colonne dans la page d’accueil (non
sélectionnée par défaut)
La donnée sélectionnée sera affichée dans une colonne de la page
d’accueil lorsqu’un unique processus est sélectionné (mode processus
simple)
Taille de la colonne (en
pixels)
Définit la dimension de la colonne dans les listes et la page d’accueil
Disponible lorsque l’option 3 ou l’option 4 de visibilité est sélectionnée.
Lecture seule
114
Définit une donnée comme en lecture seule
Permet la réduction de l’utilisation de l’espace disque lorsqu’on l’associe à
une donnée de type fichier et lorsque celle-ci est associée avec le
paramètre obligatoire TEMPLATE d’une action eFormPDF.
Note : Les paramètres des actions OUT et INOUT utilisant les données
définies en lecture seule ne seront pas mis à jour.
Attention : Ne définissez pas un formulaire PDF en lecture seule lorsque
utilisez la fonctionnalité de signature électronique. Également, ne
définissez pas les éléments FORM_DATE des applications eForm (qui
contiennent les données du formulaire) en lecture seule.
1. Uniquement affiché si la donnée du processus est un fichier.
2. Uniquement affiché si le processus est défini comme un sous-processus.
Modification du type de donnée
Le type de donnée peut être modifié seulement si la donnée n’est pas utilisée par un des objets ci-dessous :
l
Un paramètre d’une action du processus
l
Une affectation dynamique d’une action du processus
l
Les conditions des transitions ou des notifications
l
Un paramètre d’un sous-processus utilisé
Suppression
Une donnée ne peut pas être supprimée si elle associée au workflow du processus (en tant que paramètre ou
dans les conditions des transitions). Une donnée ne peut pas être supprimée si elle est définie en tant que
paramètre d’un sous-processus et utilisé par un processus parent.
Workflow
Écran du workflow d’un processus (vue liste)
Écran du workflow d’un processus (vue graphique)
Vue liste des actions
Cliquez le lien Liste pour afficher cette vue.
Colonnes
Remarques
Nouvelle action
Ouvre la fenêtre Sélectionner un type d’action, puis le formulaire
Ajouter une action.
115
Rafraîchir
Met à jour la liste d’actions
Ordre
Les flèches permettent la modification de l’ordre d’affichage des
actions dans le workflow du processus
Nom
Nom de l’action
116
Un lien affiche l’écran d’édition de l’action.
Le lien Ajouter permet d’afficher l’écran de l’action en mode ajout.
Description
Action description
Actions précédentes
Liste des actions précédant l’action actuelle dans le workflow
Actions suivantes
Liste des actions suivant l’action actuelle dans le workflow
Le lien Ajouter l’écran d’édition des actions suivant l’action actuelle.
Vue graphique des actions
Cliquez le lien Graphique pour afficher cette vue.
Icônes
Outils
Remarques
Enregistrement du schéma
Enregistre le modèle actuel du diagramme de workflow
Impression du diagramme
Imprime le diagramme actuel
Sélectionner les objets
Outil de sélection
Supprimer les objets
Outil de suppression
Ajouter un participant
Ajoute un nouveau participant au processus
Ajouter des données
Ajoute de nouvelles données pour le processus
Ajouter une action
Ajoute une nouvelle action au processus
Ajouter une transition
Ajoute une nouvelle transition entre deux actions
Ajouter un point de
cassure
Ajoute un point de cassure entre deux actions
Ajouter une boucle
Ajoute une transition boucle à une action
Ajouter une condition
Ajoute une condition à une transition
Ajouter une
synchronisation
Ajouter une action de synchronisation au processus
Ajouter un point de fin
Ajoute un point de fin au processus
Ajouter un commentaire
Ajoute un commentaire au processus
Ajouter un texte
Ajoute un texte libre au processus
Zoom plus
Augmente le niveau de zoom
117
Zoom moins
Augmente le niveau de zoom
Mode de positionnement
automatique
Change de mode de positionnement entre le mode automatique et le
mode manuel pour les ancres des transitions
Afficher les colonnes
verticales
Ajoute des colonnes de participant en surimpression de la vue
graphique afin de regrouper les actions
Afficher les colonnes
horizontales
Ajoute des colonnes de participant en surimpression de la vue
graphique afin de regrouper les actions
Attention : Vous devez désactiver le bloqueur de fenêtres contextuelles (pop-up blocker) dans votre
navigateur car le module graphique utilise des évènements JavaScript déclenchés lors de la fermeture d’une
fenêtre.
Conseils :
l
Pour changer la grandeur des colonnes, glissez-déplacez un des côtés d’une colonne.
l
Pour naviguer dans la vue graphique, glissez-déplacez le graphique.
l
Pour agrandir ou réduire le graphique, utilisez les touches + and –.
Ajout d’une action
Cliquez l’icône Ajout d’une action pour ouvrir l’écran Sélectionner un type d’action.
118
Champs
Remarques
Application
Permet la création d’une action basée sur l’application sélectionnée
Synchronisation
Permet la création d’une action de type synchronisation
Manuel
Permet la création d’une action de type manuelle
Sous-processus indépendant
Permet la création d’une action de type sous-processus indépendant
Sous-processus lié
Permet la création d’une action de type sous-processus lié
119
Actions
Écran d’édition d’une action
Barre de menu
Liens
Remarques
Infos
Affiche l’écran d’édition de l’action
Paramètres
Affiche la liste des paramètres obligatoires et supplémentaires d’une
action de ce type
120
Actions suivantes
Affiche la liste des actions suivant l’action actuelle dans le workflow
du processus
Notifications
Affiche la liste des notifications automatiques et supplémentaires de
l’action
Édition d’une action
Champs
Remarques
Type d’application ou d’action
Type d’action ou d’application utilisé par l’action
Nom
Champ obligatoire
Identifiant unique pour l’action; doit être conforme à la nomenclature
Description
Champ obligatoire
Description de l’action limitée à 255 caractères
Participant
Champ obligatoire1
Participant associé à l’action
Processus
Champ obligatoire1
Sous-processus associé à l’action
La liste des sous-processus disponibles est générée en fonction du
statut du processus :
l
Si le processus est actif vous pouvez uniquement sélectionner
les sous-processus actifs ou archivés
l
Si le processus est en test ou en construction vous pouvez
sélectionner les sous-processus en test, actifs ou archivés
Méthode d’affectation
Champ obligatoire2
Méthode d’affectation d’une action à un participant
Demandeur du sous-processus
Champ obligatoire1
Utilisateurs du processus définis automatiquement en tant que
demandeurs du sous-processus
Récupérer les utilisateurs depuis
Champ obligatoire3
Donnée du processus contenant la liste des noms d’utilisateurs
(séparés par une virgule) des personnes à qui l’action sera affectée
Délai de réalisation4
121
Délai avant que l’action ne soit considérée comme en retard. La
valeur peut être définie via une constante ou à travers une donnée du
processus dont la valeur sera récupérée à l’exécution.
Unités :
l
Années
l
Mois
l
Jours (prend en compte les jours ouvrés)
l
Heures (prend en compte les jours et heures ouvrés)
l
Minutes (prend en compte les jours et heures ouvrés)
l
Secondes (prend en compte les jours et heures ouvrés)
Vous pouvez choisir la manière dont le délai sera calculé en
sélectionnant (ou pas) l’option Utiliser les jours et heures ouvrés
pour calculer la durée.
Annuler la prise en charge si le
retard est supérieur à5
L’affectation de l’action peut être annulée automatiquement si le
délai est supérieur à la valeur définie. Vous devez définir une unité
de durée pour ce champ.
Mode de clôture
Indique si l’action doit être complétée par le moteur de workflow en
arrière-plan
Cette option est utile quand la finalisation de la réalisation d’une
action prend du temps (beaucoup de notifications, l’action est suivi
par un service Web, etc...)
Dans ce cas l’utilisateur n’a pas à attendre que l’action se termine, il
est redirigé sur la fiche de suivi de la demande ou sur la page
d’accueil du portail (selon le paramétrage de la redirection définit
dans le paneau de configuration par l’administrateur).
Visible
Indique si l’action est affichée dans l’historique des actions de la
fiche de suivi de la demande dans le portail utilisateur
Texte d’aide
Texte d’aide sur l’action dans le module utilisateur
Un lien permet l’édition de ce texte.
Lien d’aide
URL d’un document d’aide externe sur l’action, visible dans le portail
utilisateur
Email de support
Email de support de l’action affiché dans le portail utilisateur
Identifiant interne
Identifiant interne de l’action
Taille d’icône
La taille d’icône pour le processus graphique du workflow
Toutes les actions peuvent être changées à la fois. Seulement
disponible en mode graphique.
1. Si l’action est un sous-processus.
2. Si l’action est une application.
3. Disponible pour les méthodes d’affectation automatique à la personne et manuelles.
4. Actif si la méthode d’affectation est manuelle.
5. Actif si un délai de retard est défini.
122
Suppression d’une action
Seul un gestionnaire de processus ou un administrateur peuvent supprimer une action. Si le processus est
actif ou archivé, l’action ne peut pas être supprimée.
Méthodes d’affectation
Méthodes automatiques
Remarques
Automatique au demandeur
L’action est affectée à l’utilisateur qui a initié la demande (ex. : la
première action du processus est affectée au demandeur).
Automatique à l’initiateur de
l’action1
L’action est affectée à l’utilisateur qui a fait l’action précédente (ex. :
lancement de plusieurs actions consécutives par la même
personne)
Automatique à la personne (action
affectée par utilisateur)2
Si le type de participant est une Personne, l’action est affectée à
l’utilisateur associé au participant.
Si le type de participant est une Liste de personnes, l’action peut
être affectée à l’utilisateur dont le nom d’utilisateur est récupéré
dans la donnée du processus sélectionnée. Si la donnée du
processus contient une liste de noms d’utilisateurs (séparés par une
virgule), une instance de l’activité concernée (action) est créée et
affectée pour chaque utilisateur de la liste.
Automatique à la personne qui a
fait ... (une action)
L’action est affectée à l’utilisateur qui a fait l’action sélectionnée
(ex. : la dernière validation doit être effectuée par le même utilisateur
qui a effectué la première validation)
Automatique au gestionnaire du
demandeur
L’action est affectée au gestionnaire de l’utilisateur qui a initié la
demande. Une erreur d’affectation peut arriver si aucun gestionnaire
n’est asocié à l’initiateur de l’action
Automatique au gestionnaire de
l’initiaeur de l’action
L’action est affectée au gestionnaire de l’utilisateur qui a réalisé
l’action précédente. Une erreur d’affectation peut arriver si aucun
gestionnaire n’est associé à l’utilisateur qui a réalisé l’action
sélectionnée.
Automatique au gestionnaire de la
personne qui a fait ... (une action)
L’action est affectée au gestionnaire de l’utilisateur qui a réalisé
l’action sélectionnée. Une erreur d’affectation peut arriver si aucun
gestionnaire n’est associé à l’utilisateur qui a réalisé l’action
sélectionnée.
Automatique au système
Utilisé pour une action de type synchronisation ou application
automatique (WebProcAsync, WebProc, Web Service)
Méthodes manuelles
Manuelle par l’initiateur de l’action
L’utilisateur qui a effectué l’action précédente doit sélectionner
l’utilisateur qui sera affecté à l’action suivante dans la liste des
utilisateurs du participant.
Manuelle par la personne qui a fait
... (action)
123
L’utilisateur qui a effectué l’action sélectionnée doit sélectionner
l’utilisateur qui sera affecté à l’action suivante dans la liste des
utilisateurs du participant.
Dans les processus contenant des sous-processus ou des
applications automatiques cette méthode peut remplacer « Par
l’initiateur de l’action » lorsque l’action précédente a été effectuée
par le système.
Manuelle par le coordinateur
(Répartition / Dispatching) Un des coordinateurs doit affecter
l’action à un utilisateur associé au participant de l’action.
Self service
Le premier utilisateur associé au participant qui décide de prendre en
charge l’action reçoit l’affectation de l’action (à cet instant les autres
ne seront plus capables de prendre en charge l’action).
1. Automatique à l’initiateur de l’action. Disponible si le participant de l’action précédente est le même que celui de
l’action actuelle.
2. Automatique à la personne. Si cette méthode est sélectionnée, le champ Récupérer l’utilisateur depuis une
donnée doit être défini.
124
La matrice ci-dessous indiqueles méthodes d’affectations disponibles selon le type d’action et le type
d’application de l’action :
2. Automatique à la personne - Si cette méthode est sélectionnée, le champ Récupérer l’utilisateur depuis une
125
La matrice ci-dessous indique les méthodes d’affectations disponibles lorsque l’on sélectionne une action de
type Application ou Application Web en fonction du type de participant associé et du rôle de ce participant.
2. Automatique à la personne. Si cette méthode est sélectionnée, le champ Récupérer l’utilisateur depuis une
Écran liste des paramètres
126
127
Liste des paramètres obligatoires
Colonnes
Remarques
Paramètre
Nom du paramètre obligatoire
Ce nom est le nom du paramètre de l’application ou celui du sousprocessus assujetti à l’action. L’écran d’édition du paramètre est
affiché en cliquant sur son nom
Direction
Direction du paramètre
Valeur
Donnée du processus associée au paramètre
L’écran d’édition du paramètre est affiché en cliquant sur la valeur.
Liste des paramètres supplémentaires
Colonnes
Remarques
Parametre
Nom du paramètre
Un lien afiche l’écran d’édition du paramètre. Le lien Ajouter permet
d’afficher l’écran du paramètre en mode ajout.
Direction
Direction du paramètre
Valeur
Donnée associée au paramètre
Suppressions
Le x permet la suppression du paramètre
128
Écran d’édition d’un paramètre
Édition d’un paramètre
Champs
Remarques
Paramètre
Champ obligatoire
Identifiant unique pour la paramètre; doit être conforme à la
nomenclature et limité à 30 caractères
Les paramètres d’application comme « FORM_FIELDS_
READONLY » sont disponibles à travers le bouton parcourir Autres
paramètres. Ce paramètre est souvent associé au nom/ID du champ.
Parcourir
129
Ce bouton est uniquement visible pour les actions qui sont conformes
avec au moins l’une de ces règles de gesiton suivantes :
l
L’action est basée sur eFormPDF et le paramètre TEMPLATE
est associé avec une donnée contenant un fichier PDF en tant
que valeur par défaut.
l
L’action possède au moins un paramètre d’application défini
(Autres paramètres)
Exemple : Liste toutes les fonctions de paramétrage
supplémentaires associées à l’action
Direction
Direction du paramètre :
l
IN : Lors de l’instanciation de l’action, la valeur du paramètre est
initialisée avec un texte, la valeur d’une macro ou une donnée du
processus.
l
OUT : Lors de la clôture de l’action, la valeur du paramètre est
stockée dans la valeur d’une donnée du processus.
l
INOUT : Lors de l’instanciation de l’action, la valeur du
paramètre est initialisée avec un texte, la valeur d’une macro ou
une donnée du processus. Par la suite, lors de la clôture de
l’action, la valeur du paramètre est stockée dans la valeur d’une
donnée du processus.
Envoyer la valeur depuis
La valeur IN à envoyer au paramètre
En fonction du type de donnée à associer, cette valeur peut être une
donnée du processus, une macro ou une valeur texte. Il est possible
de désélectionner un bouton radio sélectionné.
Récupérer la valeur dans
Donnée du processus où la valeur OUT est stocké
130
Bouton enregistrer
Enregistre les modifications
Bouton enregistrer et fermer
Enregistre les modifications puis ferme la fenêtre
Bouton ajouter
Enregistre les modifications de ce paramètre puis propose la fenêtre
d’ajout d’un paramètre supplémentaire (c’est-à-dire la même fenêtre
vide)
Bouton supprimer
Permet la suppression du paramètre actuel
Bouton fermer
Ferme la fenêtre sans sauvegarde
Écran des actions suivantes
Action suivante
Champs
Remarques
Sélectionnez l’action à ajouter *
Action du processus à ajouter en tant qu’action suivant l’action
actuelle
* Une action peut être utilisée une seule fois en tant qu’action suivante dans les transitions d’une autre action.
Colonnes
Remarques
Action suivante
Nom de l’action suivante
Transitions vers
Liste d’actions à suivre possibles
Condition/Exception
Un lien affiche l’écran d’édition de la condition ou exception de la
transition
Suppression
Le x permet la supression de la transition vers l’action suivante
131
Ajout d’une boucle sur la première action
Il n’est pas possible de créer une boucle avec la première action du processus. Vous devez ajouter une
nouvelle action affectée automatiquement au demandeur et créer une boucle avec celle-ci.
Exemple :
Ici, l’action « MODIFIER » est ajoutée :
- SAISIR > VALIDER > MODIFIER > VALIDER > MODIFIER > VALIDER > ...
Écran d’édition d’une condition
Édition des conditions d’une transition
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 VBScript avec une syntaxe correcte peut être insérée en tant que
132
condition. La syntaxe VBScript est vérifiée lors de l’enregistrement ou en cliquant le bouton Vérifier la
syntaxe.
Champs
Remarques
Données
Liste des données qui peuvent être utilisées dans la condition
Macros
Liste des macros qui peuvent être utilisées dans la condition
( )
Isole le texte sélectionné entre parenthèses
Et
Insère un opérateur logique AND
Ou
Insère un opérateur logique OR
Pas
Insère un opérateur logique NOT
IsNull
Fonction de test permettant de savoir si la donnée est vide
DateDiff
Insère la condition DateDiff avec des paramètres vides pour
permettre de régler les valeurs (voir Hiérarchie des notifications
des actions en retard on page 136 etHiérarchie des notifications
de pré-retard on page 136)
Sinon
Insère le mot clé OTHERWISE
Actions des conditions d’une transition
Fonctions
Remarques
Vérifier la syntaxe
Lien permettant la vérification de la syntaxe de l’expresison saisie
afin de s’assurer de son interprétation correcte lors de l’évaluation de
la condition
Ajout d’une condition
l
Vous pouvez ajouter plus d’une condition sur la même transition.
l
Les conditions peuvent être combinées avec les exceptions sur la même transition.
l
Des conditions multiples sont évaluées comme des « OR » (Condition 1 OR Condition 2 OR Exception 3
etc...)
133
Écran des exceptions
Types d’exception
Type d’exception
Remarques
Retard d’une action
Exception lancée par le système lorsqu’une action est en retard
Annulation d’une action
Exception lancée lorsqu’un utilisateur annule une action ou un sousprocessus en cours
Erreur d’assignation
Exception lancée lorsqu’une action est affectée à un utilisateur qui
n’est pas associé avec le participant
Erreur d’exécution
Exception lancée par le système lorsqu’une erreur se produit lors de
l’exécution automatique d’une application
Par défaut
Exception lancée par défaut
Règles d’exception
l
l
Vous pouvez ajouter plusieurs exceptions de types différents sur la même transition.
Les exceptions peuvent être combinées aux conditions la même transition (celles-ci sont évaluées
comme des « OR »).
l
l
134
Lorsqu’une exception intervient à l’exécution, l’exécution par défaut est lancée si aucune exception d’un
autre type n’est présente dans la définition du processus.
Si une exception conduit à la fin du processus et que cette exception se produise lors de l’exécution,
toutes les actions en cours sont annulées et la demande est clôturée avec le statut Clôturée – Annulée.
Écran de notification
Notifications automatiques
Champs
Remarques
À affecter
Indique si un email est automatiquement envoyé à l’utilisateur qui
doit effectuer l’affectation de l’action
À faire
doit réaliser l’action
En retard
doit réaliser une action en retard
Prise en charge annulée
135
Indique si un email est automatiquement envoyé lorsque l’affectation
de l’action est annulée de manière automatique
Champs
Remarques
Évènement
Types d’évènement de notification :
l
À faire
l
Annulée
l
Prise en charge annulée
l
Erreur d’assignation
l
En retard
l
Pré-retard
l
Réalisé
l
Erreur d’exécution
Destinataire
Destinataire de la notification :
l
Le demandeur
l
L’initateur de l’action (si la méthode d’affectation
est manuelle)
l
Les utilisateurs affectés à l’action
l
Des adresses email libres séparées par virgules
ou point-virgules)
l
Les utilisateurs associés à un participant
l
L’utilisateur qui a fait une action … (nom de
l’action)
l
Des adresses email contenues dans la donnée
(à sélectionner dans la liste ci-dessous)
séparées par virgules ou point-virgules
Modèle
Modèle de message de l’email
l
Défaut (utilise le modèle d’email standard
localisé dans \App_Data\Templates\Emails).
l
Utilise le contenu de la donnée (à sélectionner
dans la liste ci-dessous). Cette liste est
alimenée avec les données du processus de
type texte et fichier.
Vous pouvez utiliser dans une donnée de type fichier
les éléments suivants afin de définir votre propre
modèle :
l
Le mot-clé SUBJECT de manière à définir un
sujet personnalisé de l’email
l
Des macros (voir Macros)
l
Voir Notifications personnalisées on page 232
pour des instructions sur la création de modèles
de notification personnalisés
Capture d’écran
Colonnes
Remarques
Évènement
Type de l’évènement de notification
Destinataire
Destinataire(s) de l’email
Modèle
Le modèle sélectionné du message à envoyer
Condition
Un lien affiche l’écran d’édition de condition de la notification
Suppression
Le x permet la suppression de la notification
136
Hiérarchie des notifications des actions en retard
Vous pouvez créer une hiérarchie afin de gérer les notifications des actions en retard en définissant des
conditions de notification supplémentaires basées sur les fonctions de calcul des dates/heures VBScript.
Exemple :
Dans une action d’un processus, si vous voulez notifier le demandeur que le délai de l’action est supérieur à
un jour et sinon notifier le superviseur du processus aussi après deux jours, vous devez créer deux
notifications supplémentaires de l’action avec les paramètres ci-dessous :
Notifier le demandeur si le délai est supérieur à 1 jour :
Type : Retard
Destinataire : Demandeur
Condition 1 :
DateDiff("h",<WF_ACTIVITY_INST_LIMIT_DATETIME>,<WF_SYSTEM_DATETIME>) < 24
Notifier le superviseur du processus si le délai est supérieur à 2 jours :
Type : Retard
Destinataire : Le participant superviseur
Condition 1 :
DateDiff("h",<WF_ACTIVITY_INST_LIMIT_DATETIME>,<WF_SYSTEM_DATETIME>) >= 48
Hiérarchie des notifications de pré-retard
Vous pouvez créer une hiérarchie afin de gérer les notifications de pré-reatrd d’une en définissant des
conditions de notification supplémentaires basées sur les fonctions de calcul des dates/heures VBScript.
Dans un processus, si vous voulez notifier un utilisateur qu’il risque d’être en retard avant la date cible, vous
devez ajouter une notification additionnelle sur l’action utilisant l’évènement « pré-retard ».
Pour ajouter une notification de pré-retard, suivez les étapes suivantes :
1. Dans l’onglet de notification d’une action, sous la section Supplémentaires, sélectionnez l’évènement
« pré-retard ».
2. Sélectionnez le ou les destinataire(s).
3. Sélectionnez le modèle par défaut ou le modèle personnalisé précédemment créé.
137
4. Cliquez sur Ajouter.
5. Entrer une condition (voir les exemples ci-dessous).
Exemples :
La notification est envoyée 3 jours avant la fin de délai définit pour l’action :
DateDiff("d", <WF_SYSTEM_DATETIME> , <WF_ACTIVITY_INST_LIMIT_DATETIME>) <= 3
La notification est envoyée 15 minutes avant la fin de délai définit pour l’action :
DateDiff("n", <WF_SYSTEM_DATETIME> , <WF_ACTIVITY_INST_LIMIT_DATETIME>) <= 15
Vous pouvez également utiliser les syntaxes alternatives pour les deux exemples ci-dessus :
DateDiff("d", <WF_ACTIVITY_INST_LIMIT_DATETIME> , <WF_SYSTEM_DATETIME>) >= -3
DateDiff("n", <WF_ACTIVITY_INST_LIMIT_DATETIME> , <WF_SYSTEM_DATETIME>) >= -15
Il n’y a pas de limite sur les notifications additionnelles de pré-retard qui peuvent être ajoutées à une action
(ex. : 2 jours, 1 jour, 1 heure, 30 minutes, etc...).
Notes
l
l
Si vous ne spécifiez pas de condition, la notification de pré-retard sera envoyée chaque fois qu’une
action est créée avec un délai et que le service du moteur Windows sera exécuté. Il est donc préférable
d’ajouter une condition comme dans les exemples ci-dessus pour contrôler le moment où la notification
de pré-retard est envoyée.
Depuis la version 5.1.7, tous les processus qui incluent des notifications de pré-retard ne peuvent êtres
importés dans une version WorkflowGen 5.1.6 ou inférieure pour des raisons de compatibilité.
Rapport
Écran rapport d’un processus
138
139
Erreurs et avertissements
Erreurs (le processus ne peut pas être déclenché)
Évaluations générales :
l
Un processus doit avoir au moin un début et une fin
l
Un processus ne doit avoir qu’un seul participant avec le rôle demandeur
l
Il ne peut-y avoir qu’une seule condition « sinon » dans les transitions de l’action.
l
Si plus d’une condition sort vers deux actions, toutes les transitions doivent posséder une condition.
l
l
Toutes les données du processus doivent être utilisées dans les paramètres des actions ou dans les
conditions des transitions.
Une donnée utilisée dans une condition doit être associée à un paramètre de direction OUT ou INOUT si
aucune valeur par défaut n’est définie.
Évaluations des actions :
l
l
Toutes les actions doivent avoir au moins une action suivante ou une fin.
Si une action a une transition vers la fin du processus, la transition vers les actions suivantes doit avoir
une condition.
l
Une action qui boucle doit avoir une condition.
l
Pour une action ou un sous-processus, tous les paramètres obligatoires de l’action doivent être définis.
l
l
l
l
l
Les actions qui comportent une transition avec une condition « sinon » doivent avoir une autre transition
avec une condition qui n’est pas la condition « sinon ».
Si l’action provient d’une synchronisation, la méthode d’affectation Par l’initateur de l’action n’est pas
possible.
Si l’action peut être lancée après une exception, la méthode d’affectation Par l’initateur de l’action
n’est pas possible.
La méthode d’affectation Automatique à l’initiateur de l’action n’est pas permise si le participant n’est
pas un demandeur et si le participant de l’action précédente est différent.
La méthode d’affectation Par l’initateur de l’action n’est pas permise si l’action est lancée après une
exception.
l
Assurez-vous que tous les paramètres obligatoires de l’application pour une action sont définis.
l
Assurez-vous que tous les paramètres obligatoires pour un sous-processus sont définis.
Avertissements (n’empêchement pas le déclenchement du processus)
Évaluations des actions :
l
l
Une exception est recommandée pour les actions qui utilisent une des méthodes d’affectation suivantes
et si le nom d’utilisateur est récupéré depuis une donnée du processus :
l
Automatique à la personne qui a fait
l
Manuelle par la personne qui a fait
l
Automatique à la personne
Une exception est recommandée pour les actions qui utilisent une application automatique (procédure
Web, service Web ou procédure Web asynchrone).
l
Une exception est recommandée pour les actions qui utilisent un sous-processus.
l
Toutes les données du processus doivent être utilisées.
l
l
140
Assurez-vous que les paramètres par défaut et les paramètres supplémentaires définis avec une
direction OUT sont associées à des données du processus.
Les applications automatiques doivent utiliser une exception.
Utilisation
Champs
Remarques
Demandes
Environnement de demande
En cours
Nombre de demandes en cours
Clôturées
Nombre de demandes clôturées
Totales
Nombre total de demandes lancées
Champs
Remarques
Nom
Nom du processus
Version
Description
Statut
Statut du processus
Sous-processus
Est-ce un sous-processus ?
Niveau d’accès
Niveau d’accès public ou privé
Catégorie(s)
Liste des catégories associées au processus
Délai de réalisation
Délai de réalisation du processus
Tenir compte des jours/heures
ouvrés lors du calcul du délai
Utilise seulement les heures ouvrables pour calculer le délai
Notifier le demandeur quand fermé
Une notification est envoyée au demandeur lorsque la demande est
clôturée
Archiver les résultats des actions
Enregistre le résultat de chaque action du processus à chaque étape
du processus
141
Participants
Champs
Remarques
Description
Portée
Le participant est défini dans les informations globales
Rôle
Type de participant
Type d’association avec l’annuaire
Utilisateurs
Liste des utilisateurs associés avec le participant
Groupes
Liste des groupes associés avec le participant
Annuaire
Liste des annuaires asociés avec le participant
Coordinateurs
Liste des coordinateurs associés avec le participant
Suivi graphique
Visible dans le suivi graphique
Permissions pour les superviseurs
Permissions spéciales pour les superviseurs
Permissions pour les commentaires
Permissions aucune, lire ou lire/écrire.
Reqûete
Requête de portée limitée des superviseurs
Utilisé dans les actions
Actions dans lesquelles le participant est utilisé
Données
Champs
Remarques
Description
Description des données
Type de donnée
Type de donnée
Valeur par défaut
Valeur par défaut de la donnée
Sécurité
Liste des participants avec accès à la donnée
Afficher les données dans les
formulaires du suivi
La donnée est visible dans les écrans suivants :
l
Fiches de suivi des demandes et actions
l
Messages de notifications par défaut
l
eFormPDF data popup window
l
Dans la liste des critères de recherche
Note : Décocher cette option désactive les options Critère de
recherche par défaut, Affichage en colonne dans les listes et
Affichage en colonne dans la pages d’accueil
Critère de recherche par défaut
La donnée sélectionnée sera affichée dans le formulaire de
recherche comme critère de recherche sélectionné par défaut
Afficher en colonnes dans les listes
La donnée sélectionnée sera affichée dans les listes de demandes
et d’actions en mode mono-processus
Afficher en colonnes en page
d’accueil
La donnée sélectionnée sera affichée dans les listes de la page
portail en mode mono-processus
Lecture seule
La donnée est en lecture seule et ne peut être modifiée. Cette
fonctionnalité permet d’économiser de l’espace disque lorsqu’elle
est utilisée avec le paramètre TEMPLATE d’une action eFormPDF.
Ceci se fait en associant une seule copie du PDF par processus
pour tout les actions et demandes clôturées.
Note : La donnée ne sera pas modifiée si elle est utilisée en
paramètre de sortie (OUT ou INOUT) d’une action.
Attention : Si vous utilisez la fonctionnalité de signature
électronique pour les formulaires PDF, ne pas mettre en lecture
seule le modèle du formulaire PDF, et ne pas définir les éléments
FORM_DATA des applications eForm en lecture seule.
Utilisé dans les actions
Liste des actions dans lesquelles la donnée est utilisée
Utilisé dans les conditions
Liste des transitions du processus dans lesquelles la donnée est
utilisée
Actions
Les sections des actions en tant que sous-sections fournissent des informations à propos de :
l
Infos (générales)
l
l
Paramètres supplémentaires
l
Actions précédentes
l
Actions suivantes
l
Notifications
l
142
143
Formulaire
Écran formulaire de processus
Mode éditeur
Mode ASP.NET
Cliquez l’icône .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 toutes les tâches
personnalisées spécifiques. Cette fonctionnalité est principalement ciblée pour les développeurs ASP.NET.
144
Structure, apparence et gestion de 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.
Note : Les attributs que vous définissez dans la section générale de la fenêtre de configuration de formulaire
seront appliqués à toutes les sections. L'éditeur d’apparence propose ceux-ci ainsi que d'autres options de
style (par exemple, la police et la taille du texte, les couleurs de fond, les styles de bordure, etc...) que vous
pouvez personnaliser pour chaque élément de formulaire. Pour plus de renseignements, voir la section
Éditeur d’apparence.
En-tête
l
l
l
l
l
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 afficer le numéro de la demande actuelle. Son identifiant par défaut est
CURRENT_REQUEST et peut être référencé dans un paramètre d’action pour recevoir la macro
Request.Id.
L’image est utilisée pour afficher un logo. Elle peut être redimensionnée ou réalignée dans la fenêtre de
configuration du formulaire (Général / En-tête).
Une largeur et une hauteur fixe peuvent être réglées pour l’en-tête.
Section
l
Une section comprend un titre pour afficher le nom de la section. Son texte peut être édité directement
sur le formulaire.
l
Il peut avoir un ou plusieurs champs.
l
Chaque section doit avoir un identifiant unique.
l
l
l
l
l
145
Les sections peuvent seulement être alignées verticalement et réorganisées en utilisant le glisserdéplacer avec la souris.
Lors de l’insertion d’une section sur le formulaire, la nouvelle section sera placée en dernière position.
Les sections seront redimensionnées automatiquement en fonction du plus grand champ sur le
formulaire chaque fois qu’il y a un changement d’une largeur de champ.
Une largeur fixe peut être définie globalement pour les sections dans la configuration du formulaire
(Général / Sections).
Les paramètres de la section peuvent être édités en utilisant l’icône crayon sur le côté droit du nom de la
section.
Voir la section Outils on page 156 pour les différents types de section par défaut.
Champs
l
l
l
l
l
l
l
l
l
l
l
l
l
Un champ comprend un libellé et un contrôle de saisie.
Le libellé est utilisé pour afficher le nom du champ. Son texte peut être édité directement sur le
formulaire. Il peut être redimensionné et réaligné.
Une largeur fixe peut être définie globalement pour tous les libellés dans la configuration du formulaire
(Général / Libellés).
Le contrôle de saisie permet de capturée une valeur sur le formulaire. Il peut être redimensionné et
réaligné.
Chaque champ doit avoir un identifiant unique.
Tous les champs dans la même section sont préfixés avec l'identifiant de la section suivi par une barre
de soulignement.
Les champs d’une section peuvent êtres réorganisés verticalement en utilisant le glisser-déplacer avec
la souris.
Un champ peut être déplacé d'une section à une autre en utilisant le glisser-déplacer avec la souris.
Lors de l’insertion d'un outil de champ dans le formulaire, le nouveau champ sera placé dans la dernière
position de la section sélectionnée ou la première section si aucune section n’a été choisie.
Par défaut, les champs sont alignés verticalement sur la même colonne.
Plusieurs champs peuvent être alignés horizontalement (sur la même ligne) en utilisant le bouton Retirer
le saut de ligne (flèche vers la gauche) sur le côté droit du premier champ.
Plusieurs champs peuvent être alignés verticalement en utilisant le bouton Insérer un saut de ligne
(flèche vers le droit) sur le côté droit du premier champ.
Les paramètres du champ peuvent être édités en utilisant l’icône crayon sur le côté droit du champ.
Voir la section Outils on page 156 pour les différents types de section par défaut.
146
Boutons
l
Les boutons Soumettre et Enregistrer peuvent être renommés dans la configuration du formulaire
(Général / Boutons).
l
Le bouton Enregistrer peut être activé ou désactivé.
l
Leur identifiants sont « submitButton » et « saveAsDraftButton » respectivement
Pied de page
l
Le pied de page comprend un libellé et une image en option.
l
Le libellé peut être utilisé pour afficher une note. Son texte peut être édité directement sur le formulaire.
l
l
L’image est utilisée pour afficher un logo. Elle peut être redimensionnée ou réalignée dans la
configuration du formulaire (Général / Pied de page).
Une largeur et une hauteur fixe peuvent être définies pour le pied de page.
Note : Pour modifier la feuille de style et autres attributs (en-tête, image, pied de page, textes, etc...) au
moment de l'exécution du formulaire vous pouvez ajouter le code .NET suivant :
protected void Page_Load(object sender, EventArgs e)
{
base.Page_Load(sender, e);
String stylePath=HttpContext.Current.Request.PhysicalApplicationPath.Replace
("WfApps\\WebForms\\","App_Data\\Templates\\Forms\\En\\Default\\css");
Page.Header.Controls.Remove(this.FindControl("StyleSheet"));
Page.Header.Controls.Add(
new LiteralControl(
System.IO.File.ReadAllText(stylePath + "\\" + "metal.css")
)
);
string imageUrl="http://mywebsite/mylogo.jpg"
HeaderImage.Style["background-image"] = "url('" + imageUrl+ "')";
HeaderTitleLabel.Text="My Title #";
FooterTitleLabel.Text="My footer";
imageUrl="http://mywebsite/myfooter.jpg";
FooterImage.Style["background-image"] = "url('" + imageUrl+ "')";
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";
147
imageUrl="http://mywebsite/myfooter.jpg";
FooterImage.Style["background-image"] = "url('" + imageUrl+ "')";
}
Cet exemple remplace les éléments suivants :
l
Le feuille de style par la feuille de style nommée « metal.css »
l
Le titre de l’en-tête
l
L’image de l’en-tête
l
Le titre du pied de page
l
L’image du pied de page
Note : Vous pouvez avoir besoin de modifier la largeur et la hauteur dans le code .NET si vous changez
d’image.
Exemple :
FooterImage.Style["width"] = "200px";
FooterImage.Style["height"] = "100px";
Il est recommandé d’utiliser des adresses absolues pour les différentes ressources (images, CSS, etc...) de
manière à ce que les copies comme le « Form Archive » puissent les afficher indépendamment de leur
localisation (ex. : email de notification).
Barre d’outils
Icône
Nom
Description
Nouveau formulaire
Crée un nouveau formulaire ou remplacer le formulaire actuel.
Enregistrer le formulaire
Enregistre le formulaire actuel
Enregistrer une section
ou un champ en tant
qu'outil
Enregistre la section ou le champ sélectionné comme un outil.
Dupliquer une section ou
un champ
Effectue une copie de la section ou champ sélectionné et
l’insère dans le formulaire. La section ou champ doublé
apparaîtra en dessous de la section ou champ sélectionné.
Supprimer une section ou
un champ
Supprime la section ou le champ sélectionné du formulaire.
Configuration du
formulaire
Ouvre la fenêtre de configuration du formulaire
Vue workflow
Affiche la vue interactive du workflow
Imprimer le formulaire
Imprime le formulaire actuel
Annuler/refaire
Annule ou refait les modifications les plus récentes au
formulaire.
Mode éditeur
148
Sélectionner un style
Liste de styles personnalisés et par défaut
Sélectionnez un style pour changer le style du formulaire
actuel.
Sélectionner un outil
Liste des outils personnalisés et par défaut
Sélectionnez un outil en vue d'ajouter l'outil au formulaire en
utilisant le bouton Insérer.
Insérer l'outil sélectionné
Insère l'outil sélectionné dans le formulaire.
Éditer l'identifiant des
champs
Modifier l'identifiant des sections et des champs
Éditer l'infobulle des
champs
Modifier l'infobulle des sections et des champs
Éditer le format des
champs
Modifier le format des champs
Éditer l'apparence
Personnaliser l'apparence des en-têtes, pieds de pages,
libellés et champs
Éditer le comportement
des actions
Affiche la vue interactive du workflow, active les options
cliquables Requis, Lecture seule et Caché pour chaque
champ du formulaire et permet de définir le comportement des
sections et des champs du formulaire pour chaque action
Éditer la correspondance
des données d’actions
des champs
Affiche la vue interactive du workflow, active les options
cliquables Récupérer la valeur et Envoyer la valeur pour
chaque champ du formulaire et permet de définir les données
en entrées et en sortie au niveau de chaque action
Éditeur
Affiche l’éditeur de formulaire WYSIWYG
ASP.NET
Affiche l'éditeur de code ASP.NET côté serveur
Mode ASP.NET
Nouveau
Efface le code ASP.NET
Enregistrer
Enregistre le code ASP.NET
Configuration du formulaire
149
150
Nom
151
Description
Général
En-tête
Titre
Le titre du formulaire
Largeur
La largeur de l'en-tête du formulaire
Valeur numérique avec ou sans l'unité de mesure (px, pt, in, cm, mm, pc,
em, ex, %). Exemple : 720px
Hauteur
La hauteur de l'en-tête du formulaire
Alignement de l'image
L'alignement de l'image en-tête :
l
Droite : L'image sera alignée sur le côté droit
l
Gauche : L'image sera alignée sur le côté gauche.
l
Aucune : Pas alignement
URL de l'image
L'URL de l'image à afficher
Largeur de l'image
La largeur de l'image
Hauteur de l'image
La hauteur de l'image
Répétition de l'image
152
Définit si et comment l'image sera répétée
l
Aucune répétition : l'image ne sera pas répétée
l
Répétition : l'image sera répétée à la fois verticalement et
horizontalement (par défaut)
l
Répétition x : l'image sera répétée horizontalement seulement
l
Répétition y : l'image sera répétée verticalement seulement
Sections
Largeur
La largeur pour toutes les sections :
em, ex, %) Exemple : 150px
Appliquer la largeur
Cochez la case pour appliquer la largeur à toutes les sections
Libellés
Alignement
L'alignement des libellés pour tous les champs :
l
Droite : libellé sera aligné sur le côté droit du champ
l
Gauche : libellé sera aligné sur le côté gauche du champ
l
Haut : libellé sera alingé sur le dessus du champ
Largeur
La largeur des libellés pour tous les champs :
Appliquer la largeur
Cochez la case pour appliquer la largeur à tous les libellés
Boutons
Soumission
Le libellé pour le bouton de soumission
Enregistrer en brouillon
Le libellé pour le bouton d'enregistrement en brouillon
Activer le brouillon
Cochez pour activer et afficer le bouton de sauvegarde
Bas de page
Largeur
La largeur du bas de page :
Hauteur
La hauteur du bas de page :
Alignement de l'image
L'alignement de l'image du bas de page :
l
Droite : l'image sera alignée sur le côté droit
l
Gauche : l'image sera alignée sur le côté gauche
l
Aucune : pas d'alignement
URL de l'image
L'URL de l'image à afficher
Largeur de l'image
La largeur de l'image
Hauteur de l'image
La hauteur de l'image
Répétition de l'image
153
Définit si et comment l'image sera répétée :
l
l
Répétition : l'image sera répétée à la fois verticalement et
horizontalement (par défaut)
l
l
Sécurité
Permettre la signature XML
Cocher pour permettre l'usage de la signature XML dans les données du
formulaire
Les signatures digitales sont utilisées pour certifier qu’un document n’a pas
été modifié par le système ou par quelqu’un non autorisé qui a réussit à se
connecter au système. La signature XML est un standard du W3C qui
définit les règles de procédure pour la création et la représentation de
signatures digitales. C’est une méthode d’association d’une clé avec des
données de références pour assurer l’intégrité de ces données.
Misc.
Afficher un message de
confirmation de suppression
rapide
Cochez pour afficher un message de confirmation avant la suppression
Références Web
Inclure les librairies jQuery
API et jQuery UI
Cocher pour inclure les bibliothèques d'API de jQuery (v1.7.2) et jQuery UI
(v1.8.20) dans la durée d'exécution (l'exécution du formulaire). Par défaut,
ces bibliothèques sont disponibles en mode éditeur.
Texte libre
Références web personnalisées pour être incluses dans l’élément HTML
« head » qui sera disponible tant dans l’éditeur et d'exécution. Seulement
les balises <script>, <meta>, <link> et <style> sont suportées.
Exemple :
<link rel="stylesheet" type="text/css" href="mystyle.css" />
<style type="text/css">
body {background-color:yellow}
p {color:blue}
</style>
<meta name="description" content="my content" />
<script type="text/javascript">
alert("Hello World!");
</script>
<script type="text/javascript" src="myscript.js">
</script>
154
Traductions
Séléectionner une langue
L’éditeur de formulaire vous permet de traduire vos formulaires pour toutes
les langues définies dans WorkflowGen. Sélectionnez une langue
disponible dans la liste déroulante des langues disponible.
Note : Les langues génériques comme l’anglais, le français, l’espagnol,
etc... correspondent à la langue utilisée par le créateur du formulaire pour
créer son formulaire. Par exemple, s’il a utilisé la langue anglais US (ÉtatsUnis) alors la langue générique anglais contiendra sa traduction.
Texte libre
Saisir la traduction correspondantè à la langue sélectionnée. Si un texte
est laissé vide, alors sa valeur sera recherchée dans l’ordre suivant :
Culture de la langue (ex. : anglais US), langue générique (ex. : anglais),
langue par défaut.
Styles
Les exemples de styles clé en main contiennent des CSS additionnels qui formalisent et optimisent
automatiquement l’affichage du formulaire web sur smartphone et tablette selon la résolution de l’écran.
Nom
Styles par défaut
Air
Description
Dynamic
Essential
Metal
Standard
Structural
155
156
Styles personnalisés
Nom de styles
personnalisés
Un style personnalisé peut être créé et déployé sur le serveur avec la
structure de dossier et fichiers suivante : \wfgen\App_
Data\Templates\Forms\[langue]\[nom du dossier]\css\[nom du
style].css
Exemple :
\wfgen\App_
Data\Templates\Forms\Fr\MonEntreprise\css\MonStyle.css
Outils
Nom
Description
Gérer les outils
personnalisés
Ouvre la fenêtre Gérer les outils personnalisés.
Sections
personnalisées
Liste de modèles de sections personnalisées
Un modèle de section personnalisée peut être créé en sauvegardant une section en
tant qu’outil ou manuellement sur le serveur avec le dossier et structures de fichiers
suivante : \wfgen\App_Data\Templates\Forms\[langue]\[nom du dossier]\sections\
[nom de la section].txt
Exemple :
\wfgen\App_Data\Templates\Forms\FR\MonEntreprise\sections\MaSection.txt
Note : Un modèle de section personnalisée doit se conformer à la structuration des
contenus et les règles utilisées et connues par l’éditeur de formulaire. Ceci est
destiné aux utilisateurs avancés.
Champs
personnalisés
Liste des modèles de champs personnalisés
Un modèle de champ personnalisé peut être créé en sauvegardant un champ en tant
qu’outil ou manuellement sur le serveur avec le dossier suivant et structures de
fichiers suivantes : \wfgen\App_Data\Templates\Forms\[langue]\[nom du dossier]
\fields\[nom du champ].txt
Exemple :
\wfgen\App_Data\Templates\Forms\Fr\MonEntreprise\fields\MonChamp.txt
Note : Un modèle de champ personnalisé doit se conformer à la structuration des
contenus et les règles utilisées et connues par l’éditeur du formulaire. Ceci est
destiné aux utilisateurs avancés.
157
Sections par défaut
Validation
Une section qui contient un prénom,
nom, et champ de date en lecture
seule, ainsi qu’un bouton radio
d’approbation et un champ texte
multi-lignes pour commentaires.
Vide
Une section qui n’a pas de champs
Demande
nom, et champ de date en lecture
seule, ainsi qu’une liste déroulante
de catégories et un champ texte
multi lignes pour description.
Standard
nom et champ de date en lecture
seule
Champs par défaut
Pièce jointe
Joindre un fichier
Case à cocher
Case à cocher
Case à cocher –
liste
Plusieurs cases à cocher en
alignement horizontal
Case à cocher –
liste verticale
Plusieurs cases à cocher en
Monétaire
Contrôle pour saisir une valeur
monétaire
Date
Contrôle pour saisir une valeur date
Date heure
Contrôle pour saisir une valeur date
et heure
Liste déroulante
Liste des éléments pour une
sélection de choix unique
158
Tableau
Tableau dynamique de champs de
saisie
Chaque colonne représente un
champ et chaque ligne représente
un enregistrement.
Libellé
Texte affiché en lecture seule
Liste
Liste des éléments pour une
sélection multiple
Numérique
Contrôle pour saisir une valeur
numérique
Mot de passe
Contrôle pour saisir un mot de
passe
Le texte entré sera masqué.
Bouton radio
Bouton radio
Bouton radio – liste
Plusieurs boutons radio en
verticale
Plusieurs boutons radio en
alignement vertical
Monétaire – lecture
seule
Valeur monétaire en lecture seule
Date – lecture
seule
Valeur date en lecture seule
Date heure –
lecture seule
Valeur date/heure en lecture seule
Numérique –
lecture seule
Valeur numérique en lecture seule
Texte – lecture
seule
Valeur texte en lecture seule
Texte multi-lignes
Zone de texte multi-ligne
Texte
Zone de texte uni-ligne
Paramètres de section
Nom / Icône
Description
Fermer et appliquer les modifications au champ
Fermer et annuler les modifications au champ
159
Validation
Comportement
Note : Pour aider à la saisie de la condition, une liste exhaustive des champs du formulaire et une liste
d’opérateurs sont proposées dans les menus déroulants Sélectionner un champ et Sélectionner un
opérateur. Vous pouvez également appuyer sur Ctrl+Espace pour afficher le menu déroulant IntelliSense,
qui propose les variables et mots-clés disponsibles.
Required
Définit les champs de la section comme obligatoire
Condition
Les champs des sections obligatoires sont basés sur une condition
pesonnalisée. Si la condition est vide, alors il sera vrai. La condition
personnalisée doit être du code de syntaxe C# du côté serveur.
ex. : MonTextBox.Text == "Bonjour !"
Lecture seule
Définit les champs de la section en lecture seule
Condition
Les champs de la section en lecture seule sont basés sur une condition
personnalisée. Si la condition est vide, alors il sera vrai. La condition
personnalisée doit être du code de syntaxe C# côté serveur.
Caché
Définit les champs de la section comme champs cachés
Condition
Les champs de la section cachés sont basés sur une condition personnalisée. Si
la condition est vide, alors il sera vrai. La condition personnalisée doit être du
code de syntaxe C# côté serveur.
Paramètres de la pièce jointe
Nom / Icône
160
Description
Comportement
WorkflowFileUpload
Cocher pour activer l'utilisation du contrôle WorkflowFileUpload. Sinon, le
FileUpload .NET v2.0 est utilisé par défaut.
Lien de téléchargement
Vérifier si vous voulez le lien pour ouvrir le fichier permis
Afficher la taille de
fichier
Affiche la taille du fichier téléchargé à côté du lien de téléchargement
Limite de taille du
fichier (ko)
Définit la taille maximale du fichier téléchargé (ko)
Message d'erreur de
restriction de taille
Le message d'erreur qui s'affiche lorsque la taille maximale du fichier est
dépassée
Extensions autorisées
Limite le type de fichier autorisé par extension
ex. .txt, .doc, .html, .xml, .png
Extensions interdites
Liste d'extensions de fichier interdites pour les liens
Message d'erreur de
restriction d'extension
Le message d'erreur qui s'affiche lorsque l'extension de fichier erreur se produit
Message d'erreur de
fichier vide
Le message d'erreur qui s'affiche quand il n'y a pas de fichier auquel créer un lien
Libellé du bouton ajout
Le texte d'affichage pour le bouton d'ajout
Libellé du bouton de
suppression
Le texte d'affichage pour le bouton de suppression
mise à jour
Le texte d'affichage pour le bouton de mise à jour
remplacement
Vous permet de choisir un nouveau fichier
Mode d'affichage
Définit le mode d'affichage par défaut
l
Affichage : le champ est en lecture seule
l
Édition : le champ peut être modifié
Lien de téléchargement
Cochez la case pour afficher un lien pour télécharger le fichier téléchargé fourni
Validation
Comportement du champ
Requis
Définit le champ comme champ obligatoire
Condition
Le champ obligatoire est basé sur une condition personnalisée. Si la condition est
vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe
C# côté serveur.
Lecture seule
Définit le champ en lecture seule
161
Condition
Le champ en lecture seule est basé sur une condition personnalisée. Si la
condition est vide, alors il sera vrai. La condition personnalisée doit être du code
de syntaxe C# côté serveur.
Caché
Définit le champ comme champ caché
Condition
Le champ caché est basé sur une condition personnalisée. Si la condition est
C# côté serveur.
Attributs personnalisés
Bom
Tout nom qui n'est pas dans la liste du nom de l'attribut standard réservé (id,
name, class, style, title, multiple, type, value, checked, runat)
Tout autre nom additionnel de l'attribut réservé spécifique au Fichier joint /
Comportement : workflowfileupload, addtext, deletetext, updatetext,
allowedextensions, displaymode, downloadlink, filesizelimit, showfilesize
Une liste d’exemples d’attributs personnalisés est proposée au début de l’onglet.
Vous avez la possibilité d’en choisir un ou d’entrer un nom spécifique.
Valeur
Toute valeur
Ajouter un nouvel attribut
Supprimer l'attribut actuel
Paramètres des cases à cocher et boutons de radio
Ces paramètres s'appliquent aux champs de type : case à cocher – liste, case à cocher – liste verticale,
bouton de radio – liste et bouton de radio – liste verticale.
Nom / icône
162
Description
Fermer et annuler les modifications
Éléments
Utilisez le glisser-déplacer avec la souris pour changer l'ordre des éléments.
Sélectionné
Cochez les éléments sélectionnés par défaut pour le champ. Une seule sélection
est supportée pour un bouton radio alors qu’une case à cocher supporte plusieurs
sélections.
Valeur
Valeur de la case à cocher/bouton radio
Libellé
Le texte d'affichage de case à cocher/bouton radio
163
Ajouter une nouvelle case à cocher/bouton radio
Supprimer la case à cocher/bouton radio actuelle
Validation
Requis
Condition
vide, alors il sera vrai. La condition personnalisée doit être du code de syntaxe C#
côté serveur.
Note : Les champs de type case à cocher (liste ou unique) et bouton de radio
unique ne sont pas supportés par ce comportement.
Lecture seule
Condition
Caché
Condition
côté serveur.
aslist
Cette propriété permet à un champ de type bouton radio ou case à cocher avec un
item d’être converti en liste de contrôle (bouton radio liste/case à cocher liste) au
lieu d’un contrôle de bouton radio/case à cocher dans le formulaire web.
Valeurs booléenne acceptées : true ou false
164
Paramètres des textes
Ces paramètres s'appliquent aux champs suivants : monétaire, date, date heure, numérique, mot de passe,
texte multi-lignes.
Nom / Icône
Description
165
Validation
Longueur maximale
Le nombre maximum de caractères pouvant être saisis
Note : Non disponible pour le champ texte multi-lignes.
Requis
Condition
C# côté serveur.
Lecture seule
Condition
Caché
Condition
C# côté serveur.
166
Expression régulière
Expression
Une expression régulière pour déterminer la validité
ex. : adresse courriel : \b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,4}\b
Une expression régulière peut être saisie librement dans la zone à cet effet. Il est
également possible d’utiliser une expression régulière dans la liste Sélectionner
une expression régulière.
Example of regular expressions provided by default:
Adresse
Adresse Web (URL)
Numéro de téléphone français
Numéro de téléphone américain/canadien
Code INSEE français
Numéro de sécurité sociale américain
Numéro d'assurance sociale canadien
Code postal français
Code postal américain
Code postal canadien
Date (dd-MM-yyyy)
Date (MM-dd-yyyy)
Date (yyyy-MM-dd)
Heure (00:00 à 23:59)
Dollar ($999.99)
Pourcentage (%999.99)
Décimal
Visa
MasterCard
American Express
Message d'erreur
Message à afficher lorsque la valeur du champ n'est pas valide
Plage de valeurs
Valeur minimum
Valeur minimum pour le champ en cours de validation
Valeur maximum
Valeur maximum pour le champ en cours de validation
Message d'erreur
Message à afficher lorsque la valeur du champ n'est pas valide
Personnalisé
OnServerValidate
Code de validation de syntaxe C# côté serveur. La valeur de retour doit être une
valeur booléenne (vraie ou fausse)
Valider les textes vides
Cocher pour valider le texte d'un contrôle même si le texte est vide
Message d'erreur
Message à afficher lorsque la valeur du champ n’est pas valide
Comparaison
Valeur à comparer
Valeur à comparer
Champ à comparer
Sélectionnez un autre champ du formulaire en comparaison
Opérateur
Opération comparaison à appliquer aux valeurs :
l
Égal
l
Supérieur
l
Supérieur ou égal
l
Inférieur de
l
Inférieur ou égal
l
Non égal
Message d'erreur
167
Message à afficher lorsque la valeur du champ n’est pas valide
timezoneconversion
Applicable seulement aux champs de types Date et Date Heure
Cette propriété permet de désactiver le comportement de conversion du fuseau
horaire de l’utilisateur quand le format du champ du formulaire est Date ou Date
Heure.
Cette fonctionnalité est utile si vous voulez enregistrer et maintenir une valeur
unique de date cohérente et des données du processus sans appliquer la
conversion de fuseau horaire qui change parfois la valeur de la date
dépendemment du fuseau horaire original et des fuseaux horaires des
utilisateurs.
Valeur booléenne acceptée : true ou false
Tout autre nom additionnel spécifique de l'attribut à la validation :
maxlength, requiredcondition, readonlycondition, hiddencondition, validationexpression,
regularexpressionerrormessage, minimumvalue, maximumvalue, rangeerrormessage, onservervalidate,
validateemptytext, customerrormessage, valuetocompare, controltocompare, operator,
compareerrormessage.
Paramètres des listes et des listes déroulantes
Ces paramètres (exception aux éléments) s'appliquent aux champs suivants : libellé, monétaire - lecture
seule, date – lecture seule, date heure – lecture seule, numérique – lecture seule, texte – lecture seule.
168
Nom / Icône
Description
Élément
Utilisez le glisser-déplacer de la souris pour changer l'ordre des éléments
Sélectionné
Cochez les éléments sélectionnés par défaut pour le champ
Une seule sélection est supportée pour une liste déroulante. Les listes
supportent plusieurs sélections.
Valeur
Valeur de l'élément
Libellé
Texte d'affichage de l'élément
Ajouter un nouvel élément
Supprimer un élément
Liaison de données
Connexion
Sélectionnez le type de connexion pour la liaison de données :
l
Nom
l
Chaîne
l
Listes globales
l
XML
l
SharePoint
Connexion par nom
Nom
Liste des noms de connexion définie dans le fichier de la configuration web
WorkflowGen (<connectionStrings>)
Requête SQL Select
Requête SQL Select
ex. : select column_id, column_text from table_name;
169
170
Champ de valeur de
données
Le champ de données qui fournit la valeur de l'élément
ex. : column_id
Champ de texte de
données
Le champ de données qui fournit le texte de l'élément
ex. : column_text
Ajout des données
liées
Cochez pour ajouter les éléments de données liés à la liste. Sinon, les données
liées vont remplacer tous les éléments existants dans la liste.
Paramètres
Nom
Indique le nom du paramètre si la commande « Select » utilise un filtre avec une
valeur dynamique à partir d'un paramètre.
ex. : Nom=PARAM; Select command=select column_id, column_text from
table_name where column_id > @PARAM
Type de données
Spécifie le type de données du paramètre :
l
Boolean
l
Byte
l
Char
l
DateTime
l
DBNull
l
Decimal
l
Double
l
Empty
l
Int16
l
Int32
l
Int64
l
Object
l
SByte
l
Single
l
String
l
UInt16
l
UInt32
l
UInt64
Filtrer par domaine
Spécifie un autre champ dans la forme actuelle où la valeur dynamique sera
récupérée
Valeur de filtre par
défaut
Indique la valeur par défaut si le champ de paramètre a un vide valeur ou pas de
valeur
Si la valeur est vide
Sélectionnez l'une des opérations suivantes :
l
Ne rien faire
l
Retirez tous les éléments
l
Filtrer sur la valeur vide
Connexion par chaîne
Chaîne
Spécifie la chaîne de connexion
ex. : Data Source=sqlserver_name;Initial Catalog=wfgen;User ID=wfgen_
user;Password=abc123!;
Nom du fournisseur
171
Liste des noms de fournisseurs définis dans le fichier de la configuration Web
WorkflowGen (AdministrationFormDataProviderName). Il supporte également
des fournisseurs personnalisés tiers .NET.
l
System.Data.SqlClient (.NET FWK Data Provider for SQL Server)
l
System.Data.OleDb (.NET FWK Data Provider for OLE DB)
l
System.Data.Odbc (.NET FWK Data Provider for ODBC)
l
System.Data.OracleClient (.NET FWK Data Provider for Oracle)
Requête SQL Select,
Idem que la connexion par nom
Champ de valeur de
données, Champ de
texte de données, Ajout
des données liées,
Paramètre (Nom,
Champ, Valeur par
default, Type de
données)
Connexion par listes globales
Nom de la liste
Spécifie le nom de la liste
Colonne de valeur
Sélectionne la colonne utilisée pour la valeur de l’élément
Colonne de texte
Sélectionne la colonne utilisée pour le libellé de l’élément
Trier par la colonne
Sélectionne la colonne utilisée pour trier la liste
Ajouter des données
liées
Ajoute aux données saisies les données liées à la liste. Sinon, les données liées
remplaceront tous les éléments existants dans la liste
Filtre
Colonnes
Opérateur de
comparaison
Spécifie le nom de la colonne utilisée pour filtrer les données
l
l
l
l
l
l
l
l
l
l
l
l
l
l
Égal (=)
Non égal (<>)
Supérieur (>)
Supérieur ou égal (>=)
Inférieur (<)
Inférieur ou égal (<=)
Contient
Commence par
Finit par
Est nul
N'est pas nul
Est dans
N'est pas dans
Entre
Filtrer par le champ
Sélectionne le champ du formulaire qui contient la valeur du filtre
Valeur par défaut du
filtre
La valeur par défaut si le champ est vide
Si la valeur est vide
Définit le comportement du filtre si la valeur est vide
172
Connection par XML
XML
Indique le nom du fichier XML pour la liaison de données
ex. : c:\monfichier.xml
ex. : http://server_name/monfichier.xml
ex. : http://server_name/service.asmx/getmonfichierxml
Le fichier XML doit être structuré de telle sorte que les propriétés de chaque
élément sont exprimés sous forme d’attributs.
Si vous avez un fichier XML dans lequel les valeurs de propriété sont exprimées
dans un format autre que les attributs, vous devez :
l
Créer un fichier de transformation (.xslt) qui peut dynamiquement reformater
le fichier .xml afin qu’il soit compatible avec le contrôle XmlDataSource.
l
Spécifier le chemin de votre fichier XSLT dans le paramètre « XSL transform
file » (voir ci-dessus).
XPath
Indique l’expression XPath applique aux données XML dans le fichier XML, ex. :
rss/channel/item
Fichier de
transformation XSL
Indique le nom du fichier de XSL (Extensible Stylesheet Language) qui définit une
transformation XSLT pour être exécutée sur le fichier XML
ex. : c:\monfichier.xsl
Champ de valeur de
Idem que la connexion par nom
données, Champ de
texte de données, Ajout
des données liées
Connection par SharePoint (2007 et 2010)
Note : Les paramètres du fichier config doivent être réglés pour détecter SharePoint pour activer cette
option.
URL
Adresse URL de la liste SharePoint
ex. : http://www.monsitesps.com/meslistes
Nom de la liste
Nom de la liste SharePoint
ex. : Pays
Champ de valeur de
données
Nom de colonne représentant la valeur de l'élément
ex. : Id_Pays
Champ de texte de
données
Nom de colonne représentant le texte de l'élément
ex. : Description
Validation
173
Longueur maximale
Le nombre maxmimum de caractères qui peuvent êtres saisis
Note : Non disponible pour le champ TextArea.
Requis
Condition
C# côté serveur.
Lecture seule
Condition
Caché
Condition
C# côté serveur.
timezoneconversion
Applicable seulement aux champs de types Date et Date Heure
Cette propriété permet de désactiver le comportement de conversion du fuseau
horaire de l’utilisateur quand le format du champ du formulaire est Date ou Date
Heure.
Cette fonctionnalité est utile si vous voulez enregistrer et maintenir une valeur
unique de date cohérente et des données du processus sans appliquer la
conversion de fuseau horaire qui change parfois la valeur de la date
dépendemment du fuseau horaire original et des fuseaux horaires des
utilisateurs.
Valeurs booléennes acceptées : true ou false
Tout autre nom additionnel spécifique de l'attribut réservé à la liaison de données :
connectionname, connectionstring, providername, xmldatasource, xpath, transformfile, selectcommand,
parametername, parametercontrolid, parameterdefaultvalue, parametertype, datavaluefield, datatextfield,
appenddatabounditems, spsdatasource, spsdatalist, spsdatavaluefield, spsdatatextfield.
Paramètres de tableau
174
Nom / Icône
Description
Fermer et annuler les modifications
Colonnes
Utilisez le glisser-déplacer avec la souris pour changer l'ordre des colonnes
Texte d’en-tête
Texte d’affichage de l’en-tête des colonnes.
175
Type de champ
176
Liste des types de champ supportés dans le tableau :
l
Liste déroulante
l
Liste
l
Libellé
l
Texte multi-lignes
l
Texte
Notes :
l
Les types de champs Texte et Texte multi-lignes ne supportent pas les
paramètres de validation dans un tableau.
l
Le type de champ libellé ne supporte pas la liaison de données.
Texte de pied de page
Texte d’affichage du pied de page de la colonne
Le texte de pied de page de la colonne peut être un texte ou une expression
utilisée pour filtrer les lignes, calculer les valeurs d'une colonne, ou créer une
colonne agrégat.
ex. : calculer la somme de toutes les valeurs d’une rangée d'une colonne donnée :
=SUM
Pour plus renseignements, référez-vous à DataColumn.Expression au site
Microsoft : https://msdn.microsoft.com/frfr/library/system.data.datacolumn.expression%28v=vs.80%29.aspx
Ajouter une nouvelle colonne
Supprimer la colonne actuelle
Affichage
Libellé du bouton
d'édition
Le texte d'affichage pour le bouton d'édition
suppression
Le texte d'affichage pour le bouton de suppression
mise à jour
Le texte d'affichage pour le bouton de mise à jour
Libellé du bouton
annuler
Le texte d'affichage pour le bouton annuler
Afficher l'en-tête
Cocher pour afficher l'en-tête
Afficher le pied de
page
Cocher pour afficher le pied de page
Requis
Condition
côté serveur.
Lecture seule
Condition
177
Caché
Condition
Le champ caché est basé sur une condition personnalisée. Si la condition est vide,
alors il sera vrai. La condition personnalisée doit être du code de syntaxe C# côté
serveur.
Tout autre nom additionnel spécifique de l'attribut réservé au tableau / affichage : edittext, deletetext,
updatetext, showheader, showfooter
Outil de contrôle d'utilisateur ASP.NET
L’éditeur de formulaire supporte les outils de champ personnalisé. Ceci est un contrôle d’utilisateur ASP.NET.
Vous pouvez créer cet outil et le déployer manuellement sur le serveur. Il doit avoir les structures des
éléments, de dossiers et de fichiers suivants :
l
l
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 :
l
ASCX : « \wfgen\WfApps\WebForms\[nom du contrôle d’utilisateur].ascx »
l
Code-behind : « \wfgen\WfApps\WebForms\[nom du contrôle d’utilisateur].ascx.cs »
Quand vous entrez une balise, le champ de contrôle d'utilisateur insère automatiquement sa balise fermante.
Pour écrouler un codeblock, cliquez la flèche vers le bas, qui ensuite insérera une icône double-flèche à la
place du code. Pour élargir un codeblock, cliquez sur la flèche droite. Cliquez Ctrl+Espace pour afficher la
liste déroulante IntelliSense, qui propose les variables et mot-clés disponsibles.
Le champ de contrôle utilisateur supporte les paramètres personnalisés des attributs (voir Paramètres de la
pièce jointe on page 159).
É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
l
Chaque identifiant doit être unique
l
Il doit commencer par une lettre
l
Il ne peut contenir que des caractères alphanumériques et des caractères de soulignement
l
Il est sensible à la casse
l
l
178
Chaque champ dans une section sera automatiquement préfixé avec l’identifiant de la section suivi d’une
barre de soulignement (ex. : section id=ACTION1; field id=ACTION1_MYFIELD1)
Chaque champ dans un tableau sera automatiquement préfixé avec identifiant du tableau suivi d’une
barre de soulignement (ex. : identifiants du champ et du tableau : "gridview id=ACTION1_
MYGRIDVIEW1; field id=ACTION1_MYGRIDVIEW1_TITLE1".
l
l
Si le champ est déplacé d'une section à une autre section, l’identifiant du champ sera
automatiquement préfixé avec l’identifiant de la nouvelle section.
Si l'identifiant de la section est modifié tous les identifiants des champs de la section sera
automatiquement préfixé avec le nouvel identifiant.
Note : Une info-bulle avec l’identifant 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'info-bulle
Le menu Info-bulle dans la barre d'outils vous permet de modifier les info-bulles. Vous pouvez modifier
seulement les info-bulles des champs du formulaire. Les info-bulles sont normalement utilisés pour afficher
plus d'informations sur le champ lorsque l'utilisateur déplace le pointeur de la souris sur le champ.
Édition du format
Le menu Format dans la barre d'outils vous permet de modifier le format des champs. Vous pouvez modifier
le format des types de champs suivant : texte, monétaire, date, date heure, numérique, libellé, monétaire en
lecture seule, date en lecture seule, date heure en lecture seule, numérique en lecture seule, texte en lecture
seule. Les formats sont normalement utilisés pour spécifier la façon de saisir et d'afficher une valeur
spécifique basée sur la langue de l'utilisateur et de la culture.
Type de format
Description
Numérique
La valeur est numérique
Monétaire
La valeur est monétaire
Date et heure (système)
Date et heure par défaut de WorkflowGen
Date courte
6/15/2009 1:45:30 PM ➞ 6/15/2009 (en-US)
Date longue
6/15/2009 1:45:30 PM ➞ Monday, June 15, 2009 (en-US)
Heure courte
6/15/2009 1:45:30 PM ➞ 1:45 PM (en-US)
Heure longue
6/15/2009 1:45:30 PM ➞ 1:45:30 PM (en-US)
Date/heure complète (heure courte)
6/15/2009 1:45:30 PM ➞ Monday, June 15, 2009 1:45 PM (en-US)
6/15/2009 1:45:30 PM ➞ Monday, June 15, 2009 1:45:30 PM (enUS)
6/15/2009 1:45:30 PM ➞ 6/15/2009 1:45 PM (en-US)
Date/heure générale (heure longue)
6/15/2009 1:45:30 PM ➞ 6/15/2009 1:45:30 PM (en-US)
Mois/jour
6/15/2009 1:45:30 PM ➞ June 15 (en-US)
Date/heure aller-retour
6/15/2009 1:45:30 PM ➞ 2009-06-15T13:45:30.0900000
RFC1123
6/15/2009 1:45:30 PM ➞ Mon, 15 Jun 2009 20:45:30 GMT
Date/heure pouvant être triée
6/15/2009 1:45:30 PM ➞ 2009-06-15T13:45:30
Date/heure universelle pouvant être
triée
6/15/2009 1:45:30 PM ➞ 2009-06-15 20:45:30Z
Date/heure complète universelle
6/15/2009 1:45:30 PM ➞ Monday, June 15, 2009 8:45:30 PM (enUS)
Année/mois
6/15/2009 1:45:30 PM ➞ June, 2009 (en-US)
179
Éditeur d’apparence
L'Éditeur d’apparence vous permet de personnaliser l'apparence des éléments de formulare individuels ainsi
que d'autres options. Vous pouvez changer l'apparence des en-têtes et pieds de page, les champs et leurs
libellés, les boutons de radio et cases à cocher, et les boutons Envoyer et Enregistrer en brouillon.
Vous pouvez utiliser l'Éditeur d'apparence en mode Express ou Advancé.
Pour éditer en mode Express, passez la souris sur l'élément et une barre d'outils s'affichera dans laquelle
vous pouvez changer l'apparence du texte et la taille du haut de page. (Si l'élément comprend plusieurs
champs, des barre d'outils s'afficheront dans les positions correspondantes.) Vous pouvez aussi changer la
largeur des libellés et des champs. Pour afficher les barre d'outils Express pour tous les éléments du
formulaire, appuez sur Ctrl+Maj+A.
Le mode Avancé propose du plus amples options. Pour afficher le menu du mode Avancé, passez la souris
sur l'élément pour afficher la barre d'outils Express, puis cliquez sur l'icône crayon.
180
Texte vous permet de modifier l'apparence du texte, l'alignement et l'espacement entre les mots. Disposition
vous permet de modifier la largeur et le rembourrage de l'élément. Bordures vous permet d'ajouter des
bordures et en modifier l'apparence. Disposition du conteneur vous permet de régler les marges du haut, de
gauche et de droite du conteneur.
Vous pouvez également ajouter des images aux en-têtes et aux corps des sections :
l
URL de l'image de fond : L'URL de l'image à afficher.
l
Répétition de l'image définit si/comment l'image sera répétée :
l
l
Répétition : l'image sera répétée à la fois verticalement et horizontalement (valeur par défaut)
l
l
l
Position de l'image "x" aligne l'image à gauche, au centre horizontal, ou à droite
l
Position de l'image "y" aligne l'image en haut, au centre vertical, ou en bas
Depuis l'onglet Appliquer sur… vous pouvez spécifier les éléments auxquels vous désirez appliquer les
paramètres d'apparence personnalisés.
Pour appliquer vos paramètres d'apparence personnalisés et fermer le menu du mode Avancé, cliquez l'icône
encoche. Pour annuler les changements et fermer le menu, cliquer l'icône x.
181
Définition du comportement
L'écran Comportement permet de définir visuellement et à l’aide de simples clics le comportement des
sections et des champs du formulaire pour chacune des actions du workflow.
Pour activer la vue interactive du workflow et définir le comportement du formulaire cliquez sur
Comportement dans la barre d'outils.
Pour définir le comportement des sections et des champs du formulaire au niveau d’une action, cliquez sur
l’action souhaitée au niveau de la vue interactive du worklow.
Une fois l’action sélectionnée, les paramètres Requis, Lecture seule et Caché s’activent à l’écran sous
forme de bouton cliquable pour chaque section et champ du formulaire.
182
Pour définir le comportement du formulaire au niveau des autres actions du workflow, cliquez sur une autre
action via la vue interactive et répétez l’opération précédente selon le comportement souhaité.
Tableau des comportements paramétrables pour une section
Sections
Requis
Lecture
seule
Caché
x
x
x
Requis
Lecture
seule
Caché
x
x
x
Pièce jointe (contrôle WorkflowFileUpload)
x
x
Case à cocher
x
x
Case à cocher – liste
x
x
Case à cocher – liste verticale
x
x
Toutes les sections
Tableau des comportements paramétrables par type de champ
Champs par défaut
Pièce jointe (contrôle FileUpload .NET standard)
Monétaire
x
x
x
Date
x
x
x
Date heure
x
x
x
Liste déroulante
x
x
x
Tableau
x*
x
x
Tableau – Colonne
x*
Libellé
x
Liste
x
x
x
Numérique
x
x
x
Mot de passe
x
x
x
x
x
Bouton radio
x
x
x
Bouton radio – liste verticale
x
x
x
Monétaire – lecture seule
x
Date – lecture seule
x
Date heure – lecture seule
x
Numérique – lecture seule
x
Texte – lecture seule
x
Texte multi-lignes
x
x
x
Texte
x
x
x
* Sauf dans les conditions de champs.
183
Gestion des correspondances L’écran Correspondance permet de définir visuellement et à l’aide de simples clics ou de boîtes de dialogue
les valeurs par défaut (données en entrée) et/ou les données qui seront stockées par le workflow (données en
sortie) des champs du formulaire pour chacune des actions du workflow.
Pour afficher la vue workflow interactive et gérer les correspondances du formulaire, cliquez sur
Correspondance dans la barre d'outils.
Cliquez sur Correspondance dans la barre d'outils pour activer la vue interactive du Workflow et gérer les
correspondances du formulaire
Lorsque l'action est sélectionnée, les boutons Valeur d'entrée et Valeur de sortie seront activés pour
chaque section du formulaire.
Valeur par défaut (données en entrée)
Une valeur par défaut va alimenter automatiquement un champ lors de l’affichage du formulaire suite au
lancement d’une action. Ces valeurs par défaut peuvent être de plusieurs types.
l
Texte saisi manuellement
l
Une macro sélectionnée dans la liste des macros disponibles
l
Une donnée du workflow sélectionnée dans la liste des données
Pour définir les valeurs d'entrée par défaut des champs du formulaire au niveau d’une action, cliquez le bouton
Valeur d'entrée du côté droit du champ.
184
Dans la boîte de dialogue qui apparaît, définissez la valeur par défaut du champ en saisissant un texte dans la
zone Texte, en sélectionnant une macro dans la liste déroulante Macro ou en sélectionnant une donnée du
processus dans la liste déroulante Donnée puis cliquez sur la coche en haut à droite pour enregistrer.
Pour définir les valeurs par défaut des autres champs du formulaire au niveau de chacune des actions du
workflow, cliquez sur une autre action via la vue interactive et répéter l’opération précédente.
Données stockées par le workflow (données en sortie)
Pour définir les données du formulaire qui seront stockées au niveau d’une action, cliquez sur l’action
souhaitée au niveau de la vue interactive du worklow.
Les champs dont la valeur a été envoyée sont alors automatiquement déclarés dans l’onglet Données de la
définition du processus et seront exploitables :
l
dans les conditions de transitions du workflow
l
dans les fonctionnalités de suivi et de statistiques (reporting)
Pour envoyer la valeur d’un champ du formulaire et par conséquent la stocker en donnée du processus,
cliquez sur Valeur de sortie du côté droit de chaque champ concerné.
185
Les champs dont la valeur a été envoyée sont alors automatiquement déclarés dans l’onglet Données de la
définition du processus et seront exploitables dans les conditions de transitions du workflow, les
fonctionnalités de suivi et de statistiques (reporting), etc...
Pour définir les données stockées au niveau de chacune des actions du workflow, cliquez sur une autre action
via la vue interactive et répéter l’opération précédente.
Approbation rapide
Pour activer la fonctionnalité Approbation rapide sur les actions de validation, cliquez Activer
l'approbation rapide depuis l'onglet Approbation rapide. Vous pourrez alors définir des mots-clés
d'approbation par email et activer les commentaires.
186
Enregistrement d’une section ou d’un champ comme outil
Cette fonctionnalité vous permet d'enregistrer une section ou un champ existant en tant que champ ou section
personnalisé réutilisable dans le formulaire actuel et dans d'autres formulaires. Tout d'abord, sélectionnez une
section ou un champ, puis cliquez sur l'icône Sauvegarder une section ou un champ en tant qu’outil
dans la barre d'outils.
Champs
Description
Enregistrer comme outil
Nom
Entrez un nom unique pour l'outil personnalisé
Outils
Sélectionnez un outil existant dans la liste déroulante pour l'écraser
Gérer les outils personnalisés
Sélectionnez Gérer les outils personnalisés depuis la liste déroulante Outils.
187
Nom / Icône
188
Description
Sections
Nom
Nom de l'outil de section personnalisé
Supprimer l'outil de champ personnalisé
Champs
Nom
Nom de l'outil de champ personnalisé
Supprimer l'outil de champ personnalisé
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.
Un 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.
189
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.
Pour migrer un processus crée avec l’éditeur de formulaire web, suivez les étapes ci-dessous :
1. Sauvegardez une nouvelle version du processus ou le dupliquer en utilisant le formulaire intégré.
2. Décochez l'option Activer l’éditeur de formulaire sur l'onglet Info.
3. 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.
4. Vous pouvez laisser votre dossier web ([nom du processus]\V[numéro de version]) comme un sousdossier dans l'application Web « webforms » (\wfgen\wfapps\webforms) ou transformer ce dossier en
une application Web dans IIS
l
l
Dans le premier cas votre formulaire web sera dépendant des ressources de l’application Web
« webforms » (par exemple : \bin, \App_Data\, App_Resources, App_Themes, etc...) comme
avant la migration.
Dans le dernier cas votre formulaire web sera une application web indépendante et vous devrez
copier le sous-dossier \bin dans \webforms à votre dossier et si nécessaire actualiser le projet dans
Visual Studio
Pour plus de renseignements sur le développement des formulaires web, veuillez vous référer au guide de
développeur : http://community.workflowgen.com/downloads/documentation/workflowgen-5x-developerguides/Guide-du-developpeur-Fr.pdf.
190
Application de workflow eFormASPX
Aperçu
L’application WorkflowGen eFormASPX vous permet d’afficher et de remplir les différents champs de votre
formulaire électronique à travers un formulaire Web. Un formulaire Web est un équivalent ASP.NET à un
formulaire Windows. Il possède des caractéristiques similaires à un formulaire Windows.
L’application eFormASPX utilise deux paramètres obligatoires : une donnée de type fichier FORM_DATA, et
une donnée de type texte, FORM_URL, pour afficher le formulaire Web rempli avec les données saisies par
les différents acteurs lors de l’exécution du processus, ou avec des valeurs par défaut définies lors de la
création du processus.
FORM_URL (direction de données IN)
l
Contient le chemin du formulaire Web et peut être un chemin absoluou relatif.
FORM_DATA (direction de données INOUT)
l
l
Contient les données du formulaire en format XML, qui provient du dataset .NET (voir l’exemple cidessous)
WorkflowGen créera ce fichier à chaque soumission de formulaire. Vous n’avez pas besoin d’associer
une valeur par défaut. WorkflowGen créera et mettra à jour ce fichier automatiquement.
Exemple de FORM_DATA :
Un fichier XML FormData.xml contenant :
191
<?xml version="1.0" encoding="UTF-8" ?>
<NewDataSet>
<Table1 />
</NewDataSet>
Exemple de FORM_URL :
« /wfgen/WfApps/WebForms/MyFirstWebForm/v1/Form.aspx »
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 valideur du formulaire. Ce
paramètre associe un nom de champ du formulaire à une donnée du processus qui a déjà été définie.
Notes :
l
l
Des données peuvent seulement être employées pour stocker seulement une valeur de champ par
action.
Des données de type TEXTE peuvent seulement contenir un maximum de 4000 caractères.
Exemple :
Règle : Capturer la réponse du gestionnaire dans une donnée de processus « MGR_DECISION »
Méthode : Associer le nom du champ du formulaire avec des données de processus pré-définies.
192
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érique « * » 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
l
Liste des champs en lecture seule (IN) : FORM_FIELDS_READONLY
l
Liste des champs obligatoires (IN) : FORM_FIELDS_REQUIRED
l
Liste des champs cachés (IN) : FORM_FIELDS_HIDDEN
Exemples d’utilisation
Règle : Les champs EMP_NAME et EMP_DATE sont obligatoires
Méthode : FORM_FIELDS_REQUIRED = EMP_NAME, EMP_DATE
Règle : Tous les champs sont définis en lecture seule sauf les champs dont le nom commence par
EMP_
Méthode : FORM_FIELDS_READONLY = *, ^EMP_*
Règle : Tous les champs sont définis comme visibles sauf le champ DATE et les champs dont le nom
commence par SUP_ et finit par _APP
Méthode : FORM_FIELDS_HIDDEN = ^*, DATE, SUP_*_APP
Le paramètre supplémentaire FORM_ARCHIVE
Aperçu
C’est une manière de récupérer une copie statique du formulaire afin de la visualiser, imprimer ou envoyer par
email sans avoir besoin d’exécuter le code du formulaire Web.
Paramètre
Copie statique HTML du formulaire ASP.NET (OUT) : FORM_ARCHIVE
La valeur du nom du fichier doit être définie dans le fichier XML initial de cette manière :
<FORM_ARCHIVE>form_archive.htm</FORM_ARCHIVE>
Le dataset doit également posséder un champ nommé FORM_ARCHIVE.
193
WorkflowGen manipule cette copie statique et ainsi aucun travail supplémentaire ne doit être effectué par les
développeurs du processus ou du formulaire.
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 designer de processus doit :
l
Créer une donnée de processus pour stocker la copie statique du formulaire générée par WorkflowGen.
l
Associer cette donnée au paramètre OUT nommé FORM_ARCHIVE.
194
Application de workflow
XmlToDatabase
Aperçu
L’application WorkflowGen 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.
Le moteur WorkflowGen appelle l’application XmlToDatabase avec le contexte et les paramètres afin
d’obtenir les éléments suivants :
l
Le document XML contentant les données à exporter
l
Le fichier de transaction contenant :
l
l
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 XPaths)
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.
195
Description du fichier XML
Aperçu
Le fichier de transaction est principalement utilisé pour deux choses ; se connecter à la base de données et
faire la correspondance entre les champs de la requête et les champs du document XML contenant les
données. Rappelez-vous que le document XML contenant les données peut avoir une structure de
construction libre. Ceci explique pourquoi nous utilisons XPaths pour faire la correspondance entre les
champs de la base de données et les champs du fichier XML.
Structure
Nous pouvons avoir un nombre illimité de base de données et de commandes par base de données pour une
action (activité) XmlToDatabase. Ceci signifie que l’exportation peut être effectuée vers plusieurs bases de
données et que pour chaque base de données nous pouvons exécuter plusieurs commandes.
Voici un exemple de fichier de transaction :
<transactions>
<transaction name="">
<databases>
<database name="" connectionstring="" provider="" transaction="">
<command type="" loop="" xpath="">
[QUERY HERE]
</command>
</database>
</databases>
</transaction>
</transactions>
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 :
<transactions>
<transaction name="MY_TRANSACTION">
…
</transaction>
</transactions>
Pour trouver la définition de sa transaction une action de type XmlToDatabase va effectuer une recherche
dans l’ordre suivant :
1. Dans un paramètre nommé TRANSACTIONS_TEXT.
2. Dans un fichier dont le chemin est dans un paramètre nommé TRANSACTIONS_FILE.
196
3. Dans un fichier nommé MY_TRANSACTION.xml placé dans le dossier ..\App_Data.
4. Dans un fichier nommé Transactions.xml placé dans le dossier ..\App_Data.
L’ordre de priorité est donc :
1. Le paramètre TRANSACTIONS_TEXT.
2. Le paramètre TRANSACTIONS_FILE.
3. Le fichier « ..\App_data\MyTransaction.xml ».
4. Le fichier « ..\App_data\Transactions.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\WfApps\WebServices\XmlToDatabase\App_Data. L’application XmlToDatabase effectue une
recherche dans ce fichier pour trouver votre transaction.
L’action de type XmlToDatabase contient les paramètres suivants :
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 « MY_TRANSACTION.xml »
L’action de type XmlToDatabase les mêmes paramètres que pour un fichier commun.
Note : 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.
197
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.
Créez une donnée de type fichier contenant votre transaction.
198
Ensuite, é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
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 texte de votre processus.
Note : Dans ce cas, vous êtes limité à 4000 caractères.
Créez une donnée de type texte contenant votre transaction.
199
200
Ensuite, é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.
Attributs
l
l
l
L’attribut « transaction name » est utilisé pour lier la transaction à l’action (activité) XmlToDatabase.
Dans WorkflowGen, un paramètre TRANSACTION (texte) devra être défini pour chaque action (activité)
XmlToDatabase. Le texte saisi dans le paramètre doit correspondre avec le nom de l’attribut de la
transaction afin d’utiliser la bonne transaction pour la bonne action (activité).
L’attribut « database name » est le nom de la base de donées utilisée pour l’exportation.
L’attribut « database connectionstring » doit contenir la chaîne de connexion (ConnectionString) pour la
connexion à la base de données.
l
l
l
l
l
l
201
L’attribute « database provider » est utilisé pour informer XmlToDatabase du namespace à utiliser pour
accéder à la base de données (System.Dta.OleDb ou System.Data.Odbc).
L’attribut « database transaction » est utilisé pour informer XmlToDatabase de l’utilisation ou non d’une
transaction pour l’exportation vers une base de données (valeurs : « yes » ou « no »).
L’attribut « command type » est utilisé pour informer XmlToDatabase du type de commande à exécuter,
les valeurs possibles ne sont pas limitées sauf si on appelle une procédure stockée. Si c’est le cas, le
type doit être « PROCEDURE ».
L’attribut « command loop » peut prendre les valeurs « yes » ou « no ». Il est utilisé pour exécuter un
batch de commandes utilisant toutes les valeurs retournées pour chaque xpath dans la requête. Par
exemple, si l’attribut loop est défini à « yes » et si un xpath dans la requête retourne dix résultats et que
les autres n’en retournent que cinq, la commande sera exécutée dix fois et les cinq dernières auront des
valeurs nulles. Si l’attribut loop est défini à « no », la commande sera exécutée une seule fois avec le
retour du premier nœud seulement par chaque xpath contenu dans la requête.
L’attribut « command xpath » est utilisé pour factoriser une partie des xpaths utilisés dans la requête.
L’attribut « connectionstringname » est utilisé dans le fichier de transaction XmlToDatabase pour
spécifier le nom de la chaîne de connextion à utiliser pour définir le nœud xml « database »
XmlToDatabase Transaction file:
…
<database name="MYDB" connectionstringname="MYDBSOURCE">
..
web.config:
..
<connectionStrings>
<add name="MYDBSOURCE" connectionString="Data Source="Data
Source=MYSQLSERVER;Initial Catalog=MYDB;User ID=user;password=pwd;"
providerName="System.Data.SqlClient"/>
<connectionString>
…
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 :
l
XML_FIELDS_DATE : liste des champs de type date
l
XML_FIELDS_NUMERIC : liste des champs de type numérique
l
XML_LOCALE : code culture à utiliser pour formater les valeurs date et numériques (ex. : fr-FR ou enUS)
Les deux paramètres XML_FIELDS_DATE et XML_FIELDS_NUMERIC doivent contenir la liste des
expressions xpath séparées par des caractères « , » (virgule).
202
Format data 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/MyExemple/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 définie à « 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, un « rollback » général sera
exécuté 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 TEST_MODE dans le fichier de configuration doit être définie à « Y ».
Note : Si cette constante est définie à « 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 web service est défini à « Y », le
fichier de log suivi sera généré dans le répertoire \wfgen\WfApps\WebServices\XmlToDatabase\App_
Data\LogFiles.
Les entrées du log song du format suivant :
"Date; [Database name;] Transaction name; SQL query; Execution result"
Les valeurs « execution result » sont :
l
Si la requête a été exécutée avec succès : « OK »
l
Si une erreur est intervenue : « ERROR : code erreur – description »
203
Exemples :
12/14/2005 4:51:23 PM; ACCESS; TEST_TRANS; INSERT INTO DATA …; OK
12/14/2005 4:51:24 PM; ACCESS; TEST_TRANS; DELETE FROM DATA2; ERROR: 1234-Table
was not found
Les erreurs suivantes peuvent intervenir lors de l’exécution des transactions :
Erreur
Cause
Le paramètre du fichier XML est
manquant
(The XML file parameter is missing)
Le paramètre obligatoire XML a une valeur nulle ou n’est pas défini.
Le contexte XML ne peut pas être
vide
(The XML context cannot be empty)
L’application XMLToDatabase doit recevoir un contexte de
WorkflowGen; elle ne peut pas être utilisée sans être associée à un
processus WorkflowGen.
Erreur d’analyse XML (1)
(XML parsing error (1))
Le paramètre XML point vers un fichier XML invalide.
Erreur d’analyse XML (2)
(XML parsing error (2))
Le fichier de transaction XML est un fichier XML invalide.
Erreur d’analyse XML. L’attribut du
provider est obligatoire.
(XML parsing error. The provider
attribute is required.)
L’attribut provider de la base de données n’est pas présent dans la
transaction.
Impossible de confirmer les
transactions
(Unable to commit transactions)
L’opération de « commit » n’a pas réussie.
Erreur lors de l’ouverture du fichier
de log
(Error while opening log file)
Le fichier de log ne peut pas être ouvert.
Le paramètre TRANSACTION est
manquant
(The TRANSACTION parameter is
missing)
Le paramètre obligatoire TRANSACTION a une valeur nulle ou n’est
pas défini.
La définition de la transaction n’a par
été trouvée
(The definition of the transaction has
not been found)
Le fichier « transactions.xml » ne possède pas de transaction avec
un nom d’attribut corresdponant avec la valeur du paramètre
TRANSACTION.
Instruction SQL invalide : le
paramètre n’a pas été trouvé
(SQL Instruction not valid: the
parameter has not been found)
Le PARAM {nom du paramètre} n’a pas été trouvé.
204
Erreur d’analyse XML. L’attribut
connectionstring est obligaoitre.
(XML parsing error. The
connectionstring attribute is
required.)
L’attribut connectionstring n’a pas été spécifié dans le nœud de la
base de données.
Le champ XML a été déclaré en tant
que date mais sa valeur est invalide
(The XML field was expected to be
date, but its value is not valid)
Un des xpath indiqué dans XML_FIELDS_DATE fait référence à un
champ qui n’est pas une date.
Le champ XML a été déclaré en tant
que numérique mais sa valeur est
invalide
(The XML field was expected to be
numeric, but its value is not valid)
Un des xpath indiqué dans XML_FIELDS_NUMERIC fait référence
à un champ qui n’est pas numérique.
Le xpath n’est pas une expression
xpath valide
(The xpath is not a valid xpath
expression)
Un des xpath indiqué dans le fichier de transaction n,est pas une
expression xpath valide.
Le xpath passé en paramètre n’est
pas une expression xpath valide
(The xPath passed as a parameter
is not a valid xpath expression)
Un des xpath dans les paramètres XML_FIELDS_DATE ou XML_
FIELDS_NUMERIC n’est pas une expression xpath valide.
Erreur lors du chargement du fichier Le paramètre XML ne pointe pas vers un fichier XML.
XML : fichier non trouvé
(Error while loading the XML file: File
was not found)
Erreur de connexion à la base de
données
(Database connection error)
La connexion à la base de données ne peut pas être établie. Vérifiez
la validité de la chaîne de connexion contenue dans l’attribut
connectionstring du nœud de la base de données.
Erreur lors de l’exécution de la
commande SQL
(Error during the execution of the
SQL command)
L’exécution de la commande SQL a échoué. Vérifiez la syntaxe de
la commande SQL correspondante.
Erreur lors de l’exécution de la
commande SQL loop.
(Error during the execution of the
SQL loop command)
L’exécution de la commande SQL a échoué. Vérifiez la syntaxe de
la commande SQL correspondante.
Instruction SQL non valide : le
champ XML n’a pas été trouvé
(SQL instruction not valid: the XML
field has not been found)
Une des expressions xpath utilisée dans vos paramètres de la
commande ne retourne aucun champ. Vérifiez la syntaxe de vos
expressions xpath.
Le code culture pour le fichier
XML dans le paramètre XML_
LOCALE n’est pas valide
(The culture code for the XML file in
the param XML_LOCALE is not
valid)
Vérifiez que le paramètre XML_LOCALE possède le bon format
(ex. : « fr-FR » ou « en-US »)
205
Exemples d’export
Exemple 1 :
Structure du fichier XML :
<data>
<request_number>1</request_number>
<request_first_name>John</request_first_name>
<request_last_name>Smith</request_last_name>
</data>
Le nœud commande peut ressmbler à ceci :
<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>
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.
Attention : Les xpath ne retournant pas de nœuds utiliseront les valeurs « null ».
Note : 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 :
<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>
206
<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 /> // Will insert a NULL value automatically
<author id=""/> // Will insert a NULL value automatically
</book>
</BOOKS>
</Library>
Le nœud commande peut ressembler à ceci :
<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>
Note : 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 dans lequel XPATH:: est indiqué en caractères
gras).
207
GetUsersFromDir
Aperçu
L’application GetUsersFromDir permet la récupération d’une liste de noms d’utilisateurs (« username »), d’une
liste d’emails ou d’une liste de « user id ». 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
l
l
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.
208
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 (username) des utilisateurs de la province du Québec :
QUERY1_CMD: STATE = 'QC'
RESULT_LIST
Cet exemple retourne une liste des noms d’utilisateur (username) des utilisateurs dont l’adresse email termine
par « advantys.com » :
QUERY1_CMD: EMAIL LIKE '%ADVANTYS.COM'
RESULT_LIST
Cet exemple retourne une liste des noms d’utilisateur (username) des utilisateurs appartenant au groupe de
développement :
QUERY1_CMD: {ISMEMBER(DEV)}
RESULT_LIST
Définition des champs disponibles
LASTNAME
Nom
FIRSTNAME
Prénom
EMAIL
Adresse email
PHONE
Numéro de téléphone
MOBILE
Numéro de téléphone mobile
PAGER
Numéro de téléavertisseur
FAX
Numéro de fax
OFFICE
Numéro de bureau
DEPARTMENT
Département
COMPANY
Société
JOBTITLE
Fonction
PERSONALTITLE
Titre
EMPLOYEENUMBER
Matricule
EMPLOYEETYPE
Type d’employé
POSTALADDRESS
Adresse
ZIPCODE
Code postal
CITY
Ville
STATE
État/Région
COUNTRY
Pays
EXTATT_1
Extended attribute 1
EXTATT_2
EXTATT_3
EXTATT_4
EXTATT_5
209
Définition des macros disponibles
{ISMEMBER(groupname)}
Retourne les membres du groupe
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 :
QUERY1_CMD: CITY = 'MONTREAL'
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 :
QUERY2_CMD: CITY = 'TORONTO'
QUERY3_CMD: CITY = 'NEW YORK'
QUERY1_RESULT_LIST
QUERY2_RESULT_LIST
QUERY3_RESULT_LIST
RESULT_LIST
210
Note : Un maximum de 4000 caractères peut être stocké en tant que résultat d’une requête.
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 usernames des utilisateurs de l’annuaire VotreSociété dans le paramètre
RESULT_LIST :
QUERY1_DIR: VotreSociété
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 usernames des utilisateurs de Montréal de l’annuaire WORKFLOWGEN
dans le paramètre (IN) QUERY1_RESULT_LIST, la liste des usernames des utilisateurs de Montréal de
l’annuaire INTRANET dans le paramètre (IN) QUERY2_RESULT_LIST et la liste complète des usernames
des deux requêtes dans le paramètre (IN) RESULT_LIST :
QUERY1_DIR: WORKFLOWGEN
QUERY2_DIR: INTRANET
QUERY1_RESULT_LIST
QUERY2_RESULT_LIST
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.
211
Exemples :
Cet exemple retourne seulement les deux premiers usernames de cette requête :
QUERY1_TOP: 2
RESULT_LIST
Cet exemple retourne tous les usernames de cette requête :
RESULT_LIST
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 » :
QUERY1_CMD: COMPANY = 'SOCIETE_FICTIVE'
QUERY1_DEFAULT_VALUE = défaut1
RESULT_LIST
QUERYRESULT_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 :
RESULT_SEPARATOR: ***
RESULT_LIST Cet exemple retourne la valeur nom1,nom2,nom3 :
RESULT_LIST WorkflowGen 6.0 Module d’administration – Guide de référence
212
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 and QUERY2) dans les paramètres QUERY1_RESULT_
COUNT et QUERY2_RESULT_COUNT :
QUERY1_CMD: CITY = 'NY'
QUERY1_DIR: WORKFLOWGEN
QUERY2_CMD: CITY = 'NY'
QUERY2_DIR: INTRANET
RESULT_LIST
RESULT_COUNT
QUERY1_RESULT_COUNT
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, QUERYx_RESULT_COUNT, QUERYx_
RESULT_LIST, RESULT_LIST, RESULT_COUNT or RESULT_SEPARATOR.
Vous pouvez alors appeler ces paramètres dans la condition en les préfixant par le caractère « @ » (a
commercial).
Exemple :
Cet exemple retourne la liste des usernames des utilisateurs de Montréal de l’annuaire WORKFLOWGEN :
QUERY1_CMD: CITY = @PARAM1
PARAM1: MONTREAL
RESULT_LIST
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.
213
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 usernames des utilisateurs membres du groupe « Dev » venant de
Montréal et associés à l’annuaire WORKFLOWGEN :
QUERY1_CMD: CITY = 'MONTREAL' and {ISMEMBER(Dev)}
RESULT_LIST
Important : 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 :
QUERY2_CMD: CITY = 'TORONTO'
QUERY1_RESULT_LIST_EMAIL
QUERY2_RESULT_LIST_EMAIL
RESULT_LIST_EMAIL
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.
Message d’erreur
Solution
Cet annuaire n’existe pas
(This directory does not exist)
Vérifiez que l’annuaire défini dans la requête est
valide.
214
Contexte XML vide ou incorrect
(XML context is empty or incorrect)
Vérifiez si l’application est réellement exécutée par
WorkflowGen
Erreur de connexion à la base de donnée
(Database connection error)
Vérifiez si la chaîne de connexion à la base de
données dans le fichier « config.inc » est valide.
Erreur de requête
(Query error)
Vérifiez si les champs ou les macros utilisés dans le
paramètre QUERYx_CMD sont valides.
La requête retourne trop de valeurs
(The queries return too many values)
Ajouter des conditions dans le paramètre QUERYx_
CMD pour filtrer les résultats.
Le paramètre « (nom du paramètre) » possède le
même nom qu’un nom de paramètre reservé par
WorkflowGen. Vous devez modifier ce nom.
(The parameter “(parameter name)” has the same
name as a WorkflowGen reserved parameter. You
must change the name.)
Modifiez le nom de ce paramètre pour un nom
différent de ceux réservés par WorkflowGen pour
les paramètres.
Les requêtes retournent trop d’enregistrements
(The queries return too many records)
Ajouter des conditions dans les paramètres
QUERYx_CMD pour filtrer les résultats.
Le paramètre « (nom du paramètre) » doit avoir une
valeur
(The parameter "parameter name" must have a
value)
Vérifiez dans l’action de WorkflowGen si ce
paramètre est vide.
Le paramètre « (nom du paramètre) » est obligatoire
("Parameter name" parameter is required)
Ajouter ce paramètre à l’action WorkflowGen.
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é.
215
Application de workflow XmlTrans
Aperçu
Cette application transforme n’importe quel document XML en n’importe quel autre format en utilisant une
feuille XSLT.
Le moteur WorkflowGen appelle une application XmlTrans avec le contexte et les paramètres. XmlTrans
utilise le contexte et les paramètres pour obtenir les éléments suivants :
l
Un fichier XML à convertir
l
Un fichier XSLT permettant de convertir le fichier XML vers n’importe quel type de format
l
Un paramètre RESULT pour stocker le résultat
l
Un paramètre RESULT_FILEEXT permettant de connaître l’extension du résultat
l
Un paramètre RESULT_MIMETYPE permettant de connaître l’extension le type MIME du résultat
Après la collecte de l’ensemble des informations XmlTrans est prêt à effectuer la transformation et retourne
ensuite le contexte à WorkflowGen pour que le workflow se poursuive.
216
Les erreurs suivantes peuvent se produire lors de l’exécution des transactions.
Code
Description
1
Le champ obligatoire XML est manquant.
2
Le champ obligatoire RESULT est manquant.
3
Le champ obligatoire XSLT est manquant.
4
Le fichier XML n’est pas un document XML valide.
5
Le fichier XSLT n’a pas été trouvé.
6
Le fichier XML n’a par été trouvé.
7
Impossible d’écrire le résultat dans le paramètre RESULT. Vérifiez que les règles de sécurité
sont correctes.
8
Impossible de lire le fichier XML. Vérifiez que les règles de sécurité sont correctes.
9
Le fichier XSLT n’est pas une feuille de style de transformation XSLT valide.
10
Le contexte reçu n,est pas valide.
11
Si les paramètres RESULT_FILEEXT ou RESULT_MIMETYPE sont définis, l’autre doit être
défini également.
217
RaiseException
Aperçu
Cette application vous permet de lever une exception sur des actions identifiées. La seule exception prise en
charge est l’exception d’annulation. Cette application de workflow peut être appelée par une action afin
d’annuler une ou plusieurs actions de sa demande ou de n’importe quelle autre demande. L’application est
convertie en une Assembly de workflow pour simplifier la configuration et améliorer la performance
Note : 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 :
l
l
l
Utiliser les paramètres par défaut pour annuler toutes les actions d’une demande identifiée.
Utiliser les paramètres optionnels 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 supplméntaires pour définir plusieurs couples de références d’actions.
Ce paramètre définit l’ID de la demande dans laquelle l’action sera annulée.
Nom : REQUEST_ID
Type de donnée : Numeric
Direction : IN
Nom de l’action
Ce paramètre définit le nom de l’action qui sera annulée.
Nom : ACTIVITY_NAME
Type de donnée : TEXT
Direction : IN
218
Exemple :
Dans cet exemple, l’application va annuler tous les instances de l’action PENDING_ACTION dans la
demande n°455 :
REQUEST_ID = 455
ACTIVITY_NAME = "PENDING_ACTION"
Utilisation des paramètres optionnels
Liste des identifiants de demande
Ce paramètre définit une liste d’ID de demandes dans lesquelles l’action sera annulée.
Nom : REQUEST_ID_LIST
Direction : IN
Liste des noms des actions
Ce paramètre définit une liste d’ID de demandes dans lesquelles l’action sera annulée.
Nom : ACTIVITY_NAME_LIST
Direction : IN
Nom d’utilisateur
Ce paramètre est utilisé pour définir le nom d’utilisateur (username) utilisé pour annuler l’action. Le nom
d’utilisateur utilisé doit faire partie d’un participant du processus.
Nom : USERNAME
Direction : IN
Note : Si ce paramètre n’est pas défini le compte utilisé est le compte défini dans le fichier « web.config » de
l’application grâce aux propriétés de l’application suivante :
<add key="DefaultIdentityUsername" value=""/>
<add key="DefaultIdentityPassword" value=""/>
<add key="DefaultIdentityUserDomain" value=""/>
Mot de passe
Ce paramètre est utilisé pour définir le mot de passe (password) associé au nom d’utilisateur (username)
utilisé pour annuler l’action.
Nom : PASSWORD
Direction : IN
219
EXCEPTION_NAME
Les valeurs possibles pour ce paramètre sont :
l
CANCEL
l
ERROR
l
TIMEOUT
l
ASSIGNMENT_ERROR
L’exception correspondante sera déclenché sur l’action.
EXCEPTION_MESSAGE
Ce paramètre est utilisé avec le nom de l’exception « ERROR » pour fournir plus de détails sur l'erreur dans la
mesure de suivi.
Exemples :
Dans cet exemple l’application va annuler toutes les instances des actions PENDING_ACTION1 et
PENDING_ACTION2 dans les demandes n°445, n°446 et n°447 :
REQUEST_ID_LIST = "455, 456, 457"
ACTIVITY_NAME_LIST = "PENDING_ACTION1, PENDING_ACTION2"
Dans cet exemple l’application va annuler toutes les instances des actions nommées PENDING_ACTION
dans la demande n°445 à la place de Jean Dupont :
REQUEST_ID = "455"
ACTIVITY_NAME = "PENDING_ACTION"
USERNAME = "jdupont"
PASSWORD = "1234"
Ce paramètre défini l’ID de la demande dans laquelle l’action sera annulée pour le couple spécifié par le « ? »
(point d’interrogation).
Nom : EX?_REQUEST_ID
Type de donnée : Numérique
Direction : IN
Nom de l’action
Ce paramètre défini le nom de l’action qui sera annulée pour le couple spécifié par le « ? » (point
d’interrogation).
220
Nom : EX?_ACTIVITY_NAME
Direction : IN
Non prise en compte de l’erreur NOTHINGTODO
Par défaut, RAISE_EXCEPTION renvoi une erreur si vous essayez d’annuler une action qui ne possède
aucune instance ouverte. Si vous définissez ce paramètre à « Y », l’application ignorera ce type d’erreur.
Nom : IGNORE_NOTHINGTODO_ERROR
Direction : IN
Exemple :
Dans cet exemple l’application va annuler toutes les instances de l’action PENDING_ACTION1 dans la
demande n°455 et toutes les instances de l’action PENDING_ACTION2 dans la demande n°456. Si les
actions n°455 et n°456 n’ont pas d’instance ouverte aucune erreur n’est remontée.
EX1_REQUEST_ID = 455
EX1_ACTIVITY_NAME = "PENDING_ACTION1"
EX2_REQUEST_ID = 456
EX2_ACTIVITY_NAME = "PENDING_ACTION2"
IGNORE_NOTHINGTODO_ERROR = "Y"
Les erreurs suivantes peuvent se produire lors de l’exécution de l’application :
Erreur
Cause
Solution
Erreur RaiseException : Le
contexte WorkflowGen est vide
Tous les paramètres RAISE_
EXCEPTION sont vides
Vérifiez les paramètres RAISE_
EXCEPTION
Erreur RaiseException : Les
paramètres de l’application ne
sont pas saisis correctement
Les paramètres RAISE_
EXCEPTION ne sont pas remplis
correctement
EXCEPTION
(Exception Web WorkflowGen)
Statut HTTP : ...
Réponse de l’erreur : ... or The
FUNCTION_NAME parameter
was not found
Une erreur est survenue lors de
l’émission de la requête HTTP à
WorkflowGen
Vérifiez le statut HTTP :
401 : erreur de sécurité
Vérifiez vos paramètres
d’authentification
404 : Impossible de se connecter
à l’URL 500 : Erreur interne du serveur
Vérifiez les indications dans les
messages d’erreur renvoyés
Erreur RaiseException :
Erreur lors de la tentative de
connexion à la base de données
WorkflowGen
Message d’erreur : ....
Une erreur est survenue lors de la
tentative de connexion à la base
de données WorkflowGen
Vérifiez la chaîne connexion dans
le fichier « web.config ».
messages d’erreur renvoyés.
221
(Erreur RaiseException)
Paramètres : <Nom du paramètre
de l’ID de demande >/<Nom du
paramètre du nom de l’action >
Erreur : WorkflowGen a levé une
exception de sécurité.
L’utilisateur défini par les
paramètres IDENTITY n’est pas
participant du processus
Vérifiez les paramètres
IDENTITY_USERNAME et
IDENTITY_PASSWORD.
Identifiez la demande avec les
noms des paramètres retournés
dans le message d’erreur.
Paramètres <Nom du paramètre
Erreur : L’action <Nom de
l’action/activité > n’existe pas
dans la demande <Identifiant de
la demande >.
Un des noms d’action définis
dans les paramètres RAISE_
EXCEPTION n’existe pas.
EXCEPTION.
Paramètres <Nom du paramètre
Erreur : L’action <Nom de
l’action/activité > n’a pas
d’instance dans la demande
<Identifiant de la demande >.
Une des actions à annuler n’est
pas ouverte.
EXCEPTION.
Définissez le paramètre
IGNORE_NOTHINGTODO_
ERROR à « Y » afin d’ignorer ce
type d’erreur.
222
UpdateProcessData
Aperçu
Cette application 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.
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 optionels 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 : Donnée : AMOUNT_UPDATE
Note : 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.
223
CompleteAction
Aperçu
Cette application vous permet de completer une action en cours avec les paramètres correspondant. Elle
fournit une solution pour interagir et synchroniser des processus entre eux.
Numéro de demande
Le parameter 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 :
l
l
l
Le paramètre ACTION_NAME de direction IN et de type texte permet de compléter l’action par son nom.
La première instance de l’action trouvée sera alors complétée.
Le paramètre ACTION_ID de direction IN et de type numérique permet de compléter l’action par son
identifiant unique.
Le paramètre IMPERSONATE_USERNAME vous permet de spécifier l’utilisateur qui sera associé à la
réalisation de l’action.
Vous pouvez ajouter autant de paramètres optionnels que l’action à compléter a de paramètres.
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 :
Le paramètre AMOUNT reçoit la valeur de la donnée TOTAL (vous devez créer cette donnée dans votre
processus)
dans votre processus, ajoutez une action de type COMPLETEACTION avec les paramètres suivants :
REQUEST_ID envoie la valeur dans la donnée REQUEST_ID_UPDATE (donnée à créer)
ACTION_NAME envoie le nom de l’action à compléter « MYASYNCACTION »
AMOUNT envoie la valeur de la donnée AMOUNT_UPDATE (donnée à créer)
224
Note : 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.).
225
GetProcessData
Aperçu
Cette application 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.
Numéro de demande
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 à 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 la donnée : CUSTOMER_COMPANY
Les données COMPANY et CUSTOMER_COMPANY doivent être de même type.
Note : 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...).
226
Application de workflow GetFormData
Aperçu
Cette application 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é aux données du processus.
Numéro de demande
demande valide.
Action
Tout autre paramètre permet de récupérer les valeurs des champs dans les données du processus exécutant
l’application GETFORMDATA.
Nom du paramètre : l’identifiant complet du champ dans le formulaire (ex : REQUEST_COMPANY)
Récupérer la valeur dans : une donnée du processus.
Exemple :
Pour récupérer la valeur du champ REQUEST_COMPANY dans une donnée du processus nommée
CUSTOMER_COMPANY, ajouter une action de type GETFORMDATA avec comme paramètres :
Nom du paramètre : REQUEST_ID
Envoyer la valeur : l’identifiant d’une demande valide.
Nom du paramètre : REQUEST_COMPANY
Récupérer la valeur dans la donnée : CUSTOMER_COMPANY
Notes
l
l
La donnée du processus et le champ du formulaire doivent être de même type.
Vous devriez ajouter une gestion d’exception sur l’action de type GETFORMDATA en cas d’erreur (par
exemple, numéro de demande invalide, etc.).
227
CancelRequest
Aperçu
L’application CancelRequest vous permet d’annuler une demande en cours.
Paramètres
Numéro de demande à annuler
Le paramètre optionnel NOTIFY_PARTICIPANT de direction IN et de type texte permet d’indiquer si les
participants de la demande spécifiée dans le paramètre REQUEST_ID doivent être notifiés de l’annulation de
la demande. Ses valeurs possibles sont « Y » ou « N » (valeur par défaut).
228
Macros
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.
Macro
Balise
Valeur
Utilisateur connecté.champ *
<WF_USER_champ> *
Informations sur l’utilisateur
Utilisateur assigné.champ *
<WF_ASSIGNEE_champ> *
Informations sur l’utilisateur
délégué
Demandeur.champ *
<WF_REQUESTER_champ> *
Informations sur le demandeur
Initiateur de l’action.champ *
<WF_INITIATOR_champ> *
Informations sur l’initiateur de
l’action
Process.Id
<WF_PROCESS_ID>
Identifiant du processus
Process.Nom
<WF_PROCESS_NAME>
Nom du processus
Process.Description
<WF_PROCESS_DESC>
Process.Statut
<WF_PROCESS_STATUS>
Statut du processus
Process.FormUrl
<WF_PROCESS_FORM_URL>
URL du formulaire de processus
Process.Version
<WF_PROCESS_VERSION>
Action.Id
<WF_ACTIVITY_ID>
Identifiant de l’action
Action.Nom
<WF_ACTIVITY_NAME>
Nom de l’action
Action.Description
<WF_ACTIVITY_DESC>
Description de l’action
Action en cours.Id
<WF_ACTIVITY_INST_ID>
Identifiant de l’instance de
l’action
Action en cours.Nom
<WF_ACTIVITY_INST_NAME>
Nom de l’instance de l’action
Action en cours.Date de création
<WF_ACTIVITY_INST_
CREATION_DATETIME>
Date de création de l’action
Action en cours.Délai
<WF_ACTIVITY_INST_LIMIT_
DATETIME>
Délai de ralisation de l’action
Action en cours.Compteur
<WF_ACTIVITY_INST_
COUNT>
Nombre d’instances de l’action
en cours complétées
Demande.Id
<WF_PROCESS_INST_ID>
(instance du processus)
Demande.Id relatif
<WF_PROCESS_INST_
RELATIVE_ID>
Identifiant relatif de la demande
Demande.Id relatif mensuel
<WF_PROCESS_INST_
MONTH_RELATIVE_ID>
Identifiant mensuel relatif de la
demande
Demande.Id relatif annuel
<WF_PROCESS_INST_YEAR_
RELATIVE_ID>
Identifiant annuel relatif de la
demande
Demande.Nom
<WF_PROCESS_INST_NAME>
Nom de la demande (instance du
processus)
229
Demande.Date de création
<WF_PROCESS_INST_
CREATION_DATETIME>
Date de création de la demande
(instance du processus)
Demande.Délai
<WF_PROCESS_INST_LIMIT_
DATETIME>
Délai de réalisation de la
demande (instance du
processus)
Action.Paraticipant.Nom
<WF_PARTICIPANT_NAME>
Nom du participant de l’action
Système.Date
<WF_SYSTEM_DATE>
Date système
Système.Date/heure
<WF_SYSTEM_DATETIME>
Date/heure système
Système.Heure
<WF_SYSTEM_TIME>
Heure système
Système.Langue
<WF_SYSTEM_LANGUAGE>
Langue système de l’utilisateur
Système.Null
<WF_SYSTEM_NULL>
Autorise le concepteur du
processus à réinitialiser à null la
valeur d’un champ d’un formulaire
PDF
* Champ : voir le tableau suivant.
Suffixes des macros utilisateurs
Champ
Description
LASTNAME
Nom
FIRSTNAME
Prénom
USERNAME
Nom d’utilisateur
MANAGER
Nom du gestionnaire
EMAIL
Adresse email
PHONE
Numéro de téléphone
MOBILE
Numéro de téléphone mobile
PAGER
Numéro de pager
FAX
Numéro de fax
OFFICE
Numéro de bureau
DEPARTMENT
Département
COMPANY
Société
JOBTITLE
Fonction
INITIALS
Initiales
TITLE
Titre
EMPLOYEENUMBER
EMPLOYEETYPE
Type d’employé
POSTALADDRESS
Adresse
ZIPCODE
Code postal
CITY
Ville
STATE
État/Région
COUNTRY
Pays
OBJECTSID
SID
EXTATT1
Attribut étendu 1
EXTATT2
Attribut étendu 2
EXTATT3
Attribut étendu 3
EXTATT4
Attribut étendu 4
EXTATT5
Attribut étendu 5
230
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 cidessous :
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.
Champ
Description
Type de donnée
FILENAME
Nom du fichier
Texte
SIZE
Taille du fichier en KB
Nombre
CONTENTTYPE
Type de contenu du fichier
Texte
DESCRIPTION
Description du fichier
Texte
DATELASTMODIFIED
Date de la dernière modification du
fichier
Date/Heure
Exemples de syntaxe
Considérant une donnée de type fichier appelée MON_FICHIER.
Exemple 1 :
Règle : Vérifiez 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érifiez si la taille du fichier est inférieure à 1 MB :
Méthode : <MON_FICHIER.SIZE> < 1024
Exemple 3 :
Règle : Vérifiez si le fichier est un document MS Word :
Méthode : <MON_FICHIER.CONTENTTYPE> = "application/msword"
Exemple 4 :
Règle : Vérifiez 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 cidessous dans une condition pour vérifier si le fichier existe.
IsNull(<MON_FICHIER>)
231
232
Notifications personnalisées
Aperçu
Des notifications personnalisées peuvent être employées au lieu des gabarits de défauts de WorkflowGen.
Ces gabarits personnalisés peuvent être créés en HTML ou en texte simple et peuvent également employer
des macros régulières de WorkflowGen pour afficher l'information spécifique de processus.
Processus
Pour que WorkflowGen puisse utiliser les notifications personnalisées, celles-ci doivent être ajoutées aux
données du processus comme type FICHIER.
Pour ce faire, créez une nouvelle donnée dans le processus pour chaque gabarit, puis attacher le gabarit à
employer.
Notifications des actions
WorkflowGen peut employer un nombre illimité de notifications personnalisées par action. Pour en créer,
suivez les étapes suivantes.
Dans la section Supplémentaires sur l’onglet Notifications :
1. Sélectionnez l’événement qui causera l’avis.
2. Sélectionnez le destinataire de l’avis.
233
234
3. Sélectionnez les données de processus qui contiennent le gabarit. Vous pouvez choisir la notification
personnalisée créée ou employer le gabarit par défaut de WorkflowGen.
Gabarits
Pour créer un gabarit, utiliser un éditeur de texte pour créer un fichier comme suit :
Sujet
Pour créer une ligne sujet personnalisée pour les gabarits, la première ligne dans le gabarit de HTML doit être
« SUBJECT : » suivi par la ligne sujet. Les macros pourraient être aussi utilisées ici.
HTML
Créez une page de HTML qui servira d'un gabarit pour l'email. Afin de soutenir Unicode nous recommandons
sauvegarder le fichier en utilisant le mode UTF-8 et l'addition d’une série de caractères UTF-8 dans l'en-tête
de la page de HTML, comme indiquée au-dessous. Les styles de CSS pourraient être aussi appliqués dans la
page HTML.
235
Images incorporées
Pour ajouter des images dans vos notifications il suffit de modifier les gabarits personnalisés ou intégré dans
WorkflowGen (\wfgen\App_data\Templates\Emails). Les étiquettes dont la source (src="") commence
avec « http » ne sont pas inclus dans le courriel mais relié. Par contre les étiquettes qui commence avec un
lettre de disque (ex. « c:\ ») seront inclues dans le courriel et en conséquence augmente la taille du courriel.
Par contre une connexion au serveur n’est pas nécessaire.
Exemples :
L’image est incluse dans le message :
<img src="C:\inetpub\wwwroot\wfgen\App_Themes\Default\portal\images\ activity_s.gif">
L’image n’est pas incluse dans le message :
<img src="http://localhost/wfgen/App_Themes/Default/portal/images/ activity_s.gif">
Exemple d’un gabarit HTML
SUBJECT: Mon sujet
<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"> <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>">link 1</a>
</td>
</tr>
<tr>
<td>
Faire le suivi de l’action
</td>
<td>
<a href="<WF_LINK_ACTIVITY_INST_FORM>">link 2</a>
</td>
</tr>
<tr>
<td>
Faire le suivi de l’action
</td>
<td>
<a href=" <WF_LINK_ACTIVITY_INST_FORM> ">link 2</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>
Texte
Un gabarit de notification de texte de non-Unicode peut être créé en utilisant un éditeur de texte comme le
bloc-notes Windows.
Exemple d’un gabarit texte :
SUBJECT : Mon sujet
Décision : <WF_PROCESS_INST_RELDATA_VALUE.MGR_DEC>
Date : <WF_SYSTEM_DATE>
Lancer l’action : <WF_LINK_ACTIVITY_INST_LAUNCH>
236
237
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>
Macros
En plus de macros régulières qui sont disponibles, les macros suivantes pourraient être aussi utilisées dans
les gabarits de notification personnalisés.
Macro
Remarques
<WF_PROCESS_INST_RELDATA_VALUE.DATANAME>
Une valeur de données de procesus où
DATANAME est le nom des données de la
valeur que vous souhaitez afficher
<WF_LINK_ACTIVITY_INST_LAUNCH>
Un lien sera affiché pour lancer l’action
directement de la notification
<WF_LINK_ACTIVITY_INST_FORM>
Un lien sera affiché voir le suivi de l’action
directement de la notification
<WF_PROCESS_INST_RELDATA_FILE.DATANAME>
La valeur d’une donnée du processus où
DATANAME est le nom de la donnée dont
la valeur veut être attachée au courriel
comme pièce jointe
238
URLs WorkflowGen
Aperçu
Les modules de WorkflowGen peuvent être accédés directement de la barre d'adresse de votre navigateur en
tapant l'URL de chacun.
Portail
http://VOTRESITE/wfgen/default.aspx
http://VOTRESITE/wfgen/admin/default.aspx
http://VOTRESITE/wfgen/admin/Config.aspx
239
Intégrations par l’entremise d’URLs
Aperçu
Les intégrations aux sites externes sont possible par l’entremise des applications WorkflowGen, des flux
RSS, ainsi que l’API de services web WorkflowGen. De plus, des intégrations peuvent se faire avec
l’utilisation d’URLs pour activer les fonctions suivantes :
l
l
Lancement de processus depuis un site externe, avec ou sans les menus WorkflowGen.
Lancement d’action dans une fenêtre non-WorkflowGen avec retour à un autre site Web nonWorkflowGen.
l
Visualisation de la fiche de suivi déconnectée du portail WorkflowGen.
l
Visualisation du suivi graphique déconnecté du portail WorkflowGen.
Des exemples incluent l’intégration de WorkflowGen dans un portail externe tel que Microsoft SharePoint.
SAP Portal, DotNetNuke, ou autre. La saisie et soumission de formulaires web ainsi que le suivi des activités
peuvent ensuite être complétés sans l’utilisation du portail WorkflowGen.
Pour assurer la sécurité appropriée dans WorkflowGen, ces fonctions nécessitent que les utilisateurs
s’authentifient; nous recommandons donc d’utiliser le mode de sécurité intégré.
Lancement d’un processus depuis une URL
l
La première action d’une nouvelle demande est démarrée.
l
La sécurité participant est appliquée.
l
Le bandeau et les menus WorkflowGen sont visibles.
Pour lancer un processus directement depuis un lien ou une URL, utilisez les exemples ci-dessous :
Paramètre
Description
VOTRESITE
Le site WorkflowGen
QUERY
Le paramètre de départ de processus WorkflowGen
Ex. : START
P
Le nom du processus que WorkflowGen tentera de déclencher
Ex. : CLUB_CS_LEAVE
Exemple :
http://VOTRESITE/wfgen/show.aspx?QUERY=START&P=CLUB_CS_LEAVE
240
Lancement de la première action d’un processus
depuis un site Web différent
l
La première action d’une nouvelle demande est démarée.
l
l
Le bandeau et les menus WorkflowGen sont visibles.
l
Retour à un site externe suite à la soumission du formulaire.
Pour lancer un processus directement depuis un lien ou une URL et retourner à un site Web autre que
WorkflowGen, utilisez l'exemple suivant :
Paramètre
Description
VOTRESITE
Le site WorkflowGen
QUERY
Ex. : START
P
Le nom du processus que WorkflowGen tentera courir
Ex. : CLUB_CS_LEAVE
BACKURL_SUBMIT
L’URL de retour si l’utilisateur clique sur le lien d’annulation affiché
dans le formulaire
Ex. : http://www.workflowgen.com
BACKURL_CANCEL
The URL that the user will be returned to when selecting the "Back"
link generated on the top left of the form page
e.g. http://www.workflowgen.com
FORM_BGCOLOR
La couleur de fond à utiliser pour l’affichage de la bordure du
formulaire
Ex. : white
Exemple :
http://VOTRESITE/wfgen/show.aspx?QUERY=START&P=CLUB_CS_LEAVE&BACKURL_
SUBMIT=http://www.advantys.fr&BACKURL_CANCEL=http://www.workflowgen.com&FORM_
BGCOLOR=white
Lancement d’une action sans le portail WorkflowGen
l
Lancement de la deuxième ou subséquente action d’un processus.
l
l
Le bandeau et les menus WorkflowGen sont cachés.
Pour lancer une action directement d’un lien ou URL, utiliser l’exemple suivant :
Paramètre
Description
VOTRESITE
Le site WorkflowGen
QUERY
Ex. : APPLICATION_START
ID_PROCESS_INST
L’ID de l’instance du processus que WorkflowGen lancera
Ex. : 192
ID_ACTIVITY_INST
L’ID de l’action que WorkflowGen lancera
Ex. : 2
ID_APPLICATION
L’application WorkflowGen utilisée par l’action (notez que
eFormASPX représente ID_APPLICATION 1)
Ex. : 1
BACKURL_SUBMIT
L’URL de retour après la soumission du formulaire.
Ex. : http://www.advantys.fr
241
Note : Si BACKURL_SUBMIT n’est pas défini, WorkflowGen suivra
les normes de retour au site WorkflowGen tels que définies dans le
panneau de configuration.
Exemple :
http://VOTRESITE/wfgen/show.aspx?QUERY=APPLICATION_START&ID_PROCESS_
INST=192&ID_ACTIVITY_INST=2&ID_APPLICATION=1&BACKURL_
SUBMIT=http://www.advantys.fr
Lancement d’une action depuis le portail
WorkflowGen
l
Lancement de la deuxième ou subséquente action d’un processus.
l
l
Le bandeau, les menus et les fiches de suivi WorkflowGen sont visibles.
Pour lancer une action directement d’un lien ou URL, utiliser l’exemple suivant :
Paramètre
Description
VOTRESITE
Le site WorkflowGen
QUERY
Le paramètre de départ de procesuss WorkflowGen
NO_REDIR
Assurer le retour à WorkflowGen suite à la soumission du formulaire.
Ex. : Y
ID_PROCESS_INST
Ex. : 192
ID_ACTIVITY_INST
ID_APPLICATION
L’application WorkflowGen utilisée par l’action (notez que
eFormASPX représente ID_APPLICATION 1)
Ex. : 1
REQUEST_QUERY
242
Le paramètre de contrôle de la méthode de la demande, dans cet
exemple le lancement d’une application
Exemple :
http://VOTRESITE/wfgen/show.aspx?QUERY=CONTEXT&NO_REDIR=Y&ID_PROCESS_
INST=192&ID_ACTIVITY_INST=2&ID_APPLICATION=1&REQUEST_QUERY=APPLICATION_
START
Lancement d’une fiche de suivi de la demande sans
le portail WorkflowGen
l
Lancement de la fiche de suivi déconnectée du portail WorkflowGen.
l
l
Pour lancer la fiche de suivi de la demande déconnectée, suivez l’exemple suivant :
Paramètre
Description
VOTRESITE
Le site WorkflowGen
QUERY
Le paramètre de contrôle de la demande
Ex. : PROCESS_INSTANCE_FORM
ID_PROCESS_INST
Ex. : 192
SUPERUSER
La mode de sécurité appliquée au fiche de suivi
l
Mode USER (le paramètre SUPERUSER exclus) : réservée
aux participants actifs de la demande
l
Mode ADMIN (SUPERUSER=Y) : réservée aux superviseurs
de processus, gestionnaires de processus et administrateurs
Exemple :
http://VOTRESITE/wfgen/show.aspx?QUERY=PROCESS_INSTANCE_FORM&ID_PROCESS_
INST=192&SUPERUSER=Y
Lancement d’une fiche de suivi de l’action sans le
portail WorkflowGen
l
Lancement de la fiche de suivi déconnectée du portail WorkflowGen.
l
l
243
Pour lancer la fiche de suivi de l’action déconnectée, suivez l’exemple suivant :
Paramètre
Description
VOTRESITE
Le site WorkflowGen
QUERY
Ex. : ACTIVITY_INSTANCE_FORM
ID_PROCESS_INST
L’ID de l’instance de processus que WorkflowGen lancera
Ex. : 192
ID_ACTIVITY_INST
Ex. : 2
Exemple :
http://VOTRESITE/wfgen/show.aspx?QUERY=ACTIVITY_INSTANCE_FORM&ID_PROCESS_
INST=192&ID_ACTIVITY_INST=2
Lancement d’un suivi graphique sans le portail
WorkflowGen
l
Lancement de la fiche de suivi graphique déconnectée du portail WorkflowGen.
l
l
l
Le zoom avant des actions est désactivé.
Pour lancer la fiche de suivi graphique déconnectée, suivez l’exemple suivant :
Paramètre
Description
VOTRESITE
Le site WorkflowGen
QUERY
Ex. : WFCANVAS_PROCESS_INSTANCE
ID_PROCESS_INST
Ex. : 192
Exemple :
http://VOTRESITE/wfgen/show.aspx?QUERY=WFCANVAS_PROCESS_INSTANCE&ID_
PROCESS_INST=192
Erreurs possibles
Erreur
Description
Invalid request: Process NAME or
ID is required
Le nom ou l’identificateur du processus (le paramètre ID_
PROCESS ou PROCESS) n’a pas été trouvé.
244
DbConnect
La base de données n’est pas disponible.
GetUserInfos
Incapable de rapporter l’information de l’utilisateur spécifié par le
paramètre REQUESTER_USERNAME.
Invalid user: user not found
Le nom d’utilisateur passé par le paramètre REQUESTER_
USERNAME ne correspond pas à un utilisateur WorkflowGen.
Incorrect request: The request
cannot be found
Le processus spécifié n’a pas été trouvé ou son statut ne permet
pas l’instanciation par le système.
Incorrect request: The action cannot
be found
L’action spécifiée n’a pas été trouvée ou son son statut ne permet
pas l’instanciation par le système.
This process cannot be launched by
an external application
Le processus n’a pas été déclaré comme un sous-processus public.
Security: You are not authorized to
launch this request
Le demandeur spécifié n’est pas associé au participant demandeur
du processus.
CONTEXT Invalid XML
Le contenu de XML n’est pas une ficelle de XML valide.
CONTEXT Invalid recordset
Le contenu de XML ne représente pas un objet de recordset
d’ADODB valide.
245
Menu personnalisés
Aperçu
Pour créer des menus personnalisés dans le module administration, vous devez créer et un fichier XML
nommé « admin.xml » dans le répertoire \wwwroot\wfgen\App_Data\customMenus.
Ces menus seront disponibles comme liens sur la page principale du module d’administration et/ou comme
des options de menus supplémentaires. WorkflowGen supporte deux niveaux de menus personnalisés.
Les menus peuvent être sécurisés par profil d’utilisateur.
Contenu XML
Article de menu / propriétés du nœud
Titre : Spécifie le titre de nœud. Le titre du nœud de « menuItem » sera le nom utilisé pour l'article sur la page
d'accueil de module d'administration.
Profil : Spécifie si le lien sera visible aux utilisateurs avec un profil d'administrateur d’utilisateur. Si utilisateur
est spécifié, il n'accorde pas l'accès à tous les utilisateurs mais seulement à ceux qui ont accès au module
administration (par exemple, les gérants de dossier).
Valeur du paramètre : user | admininstrateur
URL : Spécifie l’URL à ajouter. Ex. : http://www.workflowgen.com/
Description : Spécifie une description pour le lien personnalisé. Exemple : Visitez le site Web WorkflowGen !
Cible : Spécifie si le lien personnalisé sera ouvert dans la page de WorkflowGen (défaut) ou dans une
nouvelle fenêtre de navigateur.
Valeur du paramètre : _new | "" (deux guillemets)
showInHomepage : Spécifier si le lien personnalisé sera affiché seulement sur la page principale ou aussi
sur la page d'accueil de module d'administration (défaut).
Valeur du paramètre : true | false
Icon : Spécifier le chemin d’une icône personnalisée à afficher au lieu de l'icône cercle-flèche qui apparaît par
défaut.
Vous pouvez utiliser aussi des images dans un thème personnalisé. 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\MYTHEME\admin\images\.
Le répertoire par défaut est wfgen\App_Themes\Default\admin\images\. Vous pouvez aussi ajouter vos
propre images personnalisée a ce dossier et les utiliser à partir de ce dossier (voir l’exemple ci-dessous).
246
Exemple de fichier admin.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>
Portail d’utilisateur
Aperçu
Pour créer des menus personnalisée dans le module de l’usager, il faut créer et modifier le fichier XML nommé
« admin.xml » dans le dossier CustomMenu situé dans le dossier \wwwroot\wfgen\App_
Data\customMenus\.
Les menus personnalisés seront disponible comme une option menue en extra pour la page portail de
l’utilisateur.
Les items de menu peuvent être sécurisés avec un profil d’utilisateur.
Contenu XML
Article de menu/propriétés du nœud
Titre : Spécifie le titre du nœud. Le titre de nœud de « menuItem » sera le nom utilisé pour l'article sur la page
d'accueil du portail d’utilisateur.
Profil : Spécifie si le lien sera visible aux utilisateurs avec un profil d’administrateur, d’utilisateur, de
superviseur ou de gestionnaire.
Valeur du paramètre : user | supervisor | manager | admin
URL : Spécifie l’URL à ajouter. Exemple : http://www.workflowgen.com
Description : Spécifie une description pour le lien personnalisé. Exemple : Visitez le site Web WorkflowGen !
Cible : Spécifie si le lien personnalisé sera ouvert dans la page de WorkflowGen (défaut) ou dans une
nouvelle fenêtre de navigateur.
Valeur du paramètre : _new | "" (deux guillemets)
Icon : Spécifier le chemin d’une icône personnalisée à afficher au lieu de l'icône cercle-flèche qui apparaît par
défaut.
247
Vous pouvez utiliser aussi des images dans un thème personnalisé. 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\MYTHEME\admin\images.
Le répertoire par défaut est \wfgen\App_Themes\Default\portal\images. Vous pouvez aussi ajouter vos
propres images personnalisées à ce dossier et les utiliser à partir de de ce dossier (voir l’exemple ci-dessous).
Exemple de fichier portal.xml
<?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&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>
248
Portlet
Aperçu
Le module portlet permet de retrouver les informations provenant de la page d’accueil du portail WorkflowGen
(portail d’utilisateur) au format RSS ou autre (par transformation XSL).
Les résultats reçus depuis une requête HTTP sont retournés au format XML RSS et classés par catégories.
Ce format permet le traitement et la présentation des données via tous langages capables de lire et d’analyser
du contenu XML.
URL et paramètres HTTP
URL
Vous pouvez obtenir le contenu généré par le module portlet avec l’URL suivante :
http://votresite/wfgen/show.aspx?QUERY=SHOW_RSS
Paramètres
Paramètre
Description
Exemple
USERNAME
Récupère les données pour cet utilisateur. Le
login actuel est supposé si ce paramètre est
manquant.
wfgen_admin
CATEGORY
Liste des catégories à récupérer séparées par
« ; » (point-virgule). Si ce paramètre est
manquant, toutes les catégories disponibles
sont retournées.
REQUEST_RUNNING_
NB;ACTION_TODO_NB
PROCESS
Permet au contenu d’être filtré par des
processus spécifiques. Spécifiez les noms des
processus séparés par « ; » (point-virgule).
DDE_CONGES
PROCESS_CATEGORY
Permet de filtrer le contenu par des catégories
spécifiques de processus. Spécifiez les noms
des catégories séparés par « ; » (point-virgule).
RH
SHOW_NEW_
REQUEST
Récupère la liste des processus que l’utilisateur
courant peut lancer.
Y
XSL
Chemin de la feuille XSL uitilisée pour
transformer le contenu RSS.
http://votresite/portlet.xsl
Exemples :
Retrouver toutes les catégories pour l’utilisateur pour lequel le nom d’utilisateur est « jeand » :
http://votresite/wfgen/show.aspx?QUERY=SHOW_RSS&USERNAME=jeand
249
Retrouver les actions à faire (normales et en retard) pour l’utilisateur pour lequel le nom d’utilisateur est
« jeand » :
http://votresite/wfgen/show.aspx?QUERY=SHOW_
RSS&USERNAME=jeand&CATEGORY=ACTION_TODO_NB;ACTION_TODO_OVERDUE_NB
Retrouver les informations relatives à la catégorie RH pour l’utilisateur courant :
http://votresite/wfgen/show.aspx?QUERY=SHOW_RSS&PROCESS_CATEGORY=RH
Sécurité
Authentification
Pour appeler le module portlet, vous devez utiliser un compte ayant accès au portail d’utilisateur de
l’application WorkflowGen (ex. : wfgen_admin).
Nom d’utilisateur avec ou sans nom de donnée
Vous devez supprimer le nom de domaine du nom d'utilisateur lors de l'appel du module portlet si les noms
d'utilisateurs sont préfixés par le nom du domaine dans le module de gestion des utilisateurs.
Format de spécifications RSS
Spécifications officielles
Vous pouvez obtenir plus d’informations officielles (en anglais) sur le standard RSS 2.0 à l’adresse suivante :
http://blogs.law.harvard.edu/tech/rss.
Exemple de contenu
<?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>
250
</rss>
Description des nœuds XML RSS
Nom
Chemin
Description
Exemple
channel
rss
Root node
title
rss/channel
Channel title
WorkflowGen
description
rss/channel
Channel description
WorkflowGen
pubdate
rss/channel
language
rss/channel
item
rss/channel
Categories container node
title
rss/channel/item
Category title
link
rss/channel/item
Contextual link of the
category in WorkflowGen
description
rss/channel/item
Category value
category
rss/channel/item
Category name
Liste des catégories disponibles
Les catégories disponibles sont décrites ci-dessous :
Nom
Description
REQUEST_RUNNING_NB
Nombre de demandes en cours
REQUEST_RUNNING_OVERDUE_NB
Nombre de demandes en cours en retard
ACTION_TODO_NB
Nombre d’actions à faire
ACTION_TODO_OVERDUE_NB
Nombre d’actions à faire en retard
ACTION_TEAM_NB
Nombre d’actions d’équipe à faire
ACTION_TEAM_OVERDUE_NB
Nombre d’actions d’équipe à faire en retard
ACTION_TOASSIGN_NB
Nombre d’actions à affecter
ACTION_TOASSIGN_OVERDUE_NB
Nombre d’actions à affecter en retard
REQUEST_CLOSED_NB
Nombre de demandes clôturées depuis mon dernier
accès
REQUEST_CLOSED_OVERDUE_NB
Nombre de demandes en retard clôturées depuis
mon dernier accès
REQUEST_TOFOLLOW_NB
Nombre de demandes à suivre
REQUEST_TOFOLLOW_OVERDUE_NB
Nombre de demandes en retard à suivre
ACTION_TOFOLLOW_NB
Nombre d’actions à suivre
ACTION_TOFOLLOW_OVERDUE_NB
Nombre d’actions en retard à suivre
NEW_REQUEST
Liste des processus disponibles que l’utilisateur
peut lancer
251
Note : Si une catégorie est vide à l’éxécution, elle n’est pas ajoutée au contenu RSS.
Erreurs possibles
Lorsqu’une erreur survient, le statut HTTP de la page est modifié et une erreur à l’éxécution sera affiché avec
un numéro personnalisé.
Les erreurs suivantes peuvent survenir durant l’éxécution du script :
Titre
Description
Numéro
Statut HTTP
Unable to connect to the database
La base de données n’est pas
disponible.
100
500
Unknown user
L’utilisateur envoyé par le paramètre
USERNAME ne correspond pas à
un utilisateur existant de
WorkflowGen.
101
500
Error during the execution of the
request <CATEGORY>
Une erreur survient durant
l’exécution de la requête
SQL correspondant à la catégorie
<CATEGORY>.
102
500
252
Messages d’erreur
Licence
Erreur
Cause
Votre licence est expirée
Votre période d’essai est expirée. Vous devez saisir un
numéro de série valide pour activer votre version.
Une licence valide ne peut pas être
trouvée
Le fichier licence ne correspond pas avec votre numéro de
série.
Erreur de licence
Cette opération n’est pas autorisée avec votre licence.
Sécurité
Erreur
Cause
Vous n’êtes pas autorisé à voir cette page
L’utilisateur doit être un utilisateur WorkflowGen ou un
administrateur pour accéder à l’application.
Vous n’êtes pas autorisé à accéder à ce
fichier
Si le téléchargement est sécurisé, seul l’administrateur, un
gestionnaire de processus ou un participant avec des droits de
lecture suffisants peut accéder aux fichiers de la demande.

My Document - Documentation

Transcription

Documents pareils

Formulaire de contact de la mairie de Saint Pé d`Ardet

Formulaire de rétraction À : Foot Locker Europe.com

formulaire-type de rétractation

Formulaire pour demande de devis

Objet : Procédure de retour Madame, Monsieur, Nous vous prions

Formulaire de rétractation

Formulaire de rétractation de commande relatif au site www.rougier

CHALLENGE JACQUIE MATHIEU ET MICHEL LALLEMAND

formulaire de retractation

Attention à l`arnaque à l`annuaire !