Macros

Aperçu

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

Liste des macros

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>

Description du processus

Process .Statut

<WF_PROCESS_STATUS>

Statut du processus

Process. FormUrl

<WF_PROCESS_FORM_URL>

URL du formulaire de processus

Process. Version

<WF_PROCESS_VERSION>

Version du processus

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 réalisation de l’action

Action en cours. Jours pré-retard

<WF_ACTIVITY_INST_PREOVERDUE_DAYS>

Nombre de jours avant que l’action devienne en retard, arrondi vers le haut au jour le plus proche

Action en cours. Heures pré-retard

<WF_ACTIVITY_INST_PREOVERDUE_HOURS>

Nombre d’heures avant que l’action devienne en retard, arrondi vers le haut à l’heure la plus proche

Action en cours. Minutes pré-retard

<WF_ACTIVITY_INST_PREOVERDUE_MINUTES>

Nombre de minutes avant que l’action devienne en retard, arrondi vers le haut à la minute la plus proche

Action en cours. Secondes pré-retard

<WF_ACTIVITY_INST_PREOVERDUE_SECONDS>

Nombre de secondes avant que l’action devienne en retard, arrondi vers le haut à la seconde la plus proche

Action en cours. Jours en retard

<WF_ACTIVITY_INST_OVERDUE_DAYS>

Nombre de jours que l’action est en retard, arrondi vers le bas au jour le plus proche

Action en cours. Heures en retard

<WF_ACTIVITY_INST_OVERDUE_DAYS>

Nombre d’heures que l’action est en retard, arrondi vers le bas à l’heure la plus proche

Action en cours. Minutes en retard

<WF_ACTIVITY_INST_OVERDUE_MINUTES>

Nombre de minutes que l’action est en retard, arrondi vers le bas à la minute la plus proche

Action en cours. Secondes en retard

<WF_ACTIVITY_INST_OVERDUE_SECONDS>

Nombre de secondes que l’action est en retard, arrondi vers le bas à la seconde la plus proche

Action en cours. Compteur

<WF_ACTIVITY_INST_COUNT>

Nombre d’instances complétées de l’action en cours

Action en cours. Compteur de boucle directe

<WF_ACTIVITY_INST_DIRECT_LOOP_COUNT>

Nombre d'instances complétées en boucle directe de l’action en cours

Demande. Id

<WF_PROCESS_INST_ID>

Identifiant de la demande (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)

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

Système. ApplicationBase Url

<WF_SYSTEM_APPLICATION_BASE_URL>

Renvoie l'URL racine de l'application (p.ex. http://[servername])

Système. ApplicationUrl

<WF_SYSTEM_APPLICATION_URL>

Renvoie l'URL de l'application WorkflowGen (p.ex. http://[servername]/wfgen)

Système. ApplicationPortal ScriptUrl

<WF_SYSTEM_APPLICATION_PORTAL_SCRIPT_URL>

Renvoie l'URL de la page du portail de l'application WorkflowGen (p.ex. http://[servername]/wfgen/show.aspx)

Système. ApplicationConfigPath

<WF_SYSTEM_APPLICATION_CONFIG_PATH>

Renvoie le chemin physique vers le web.config WorkflowGen (p.ex. C:\inetpub\wwwroot\wfgen\web.config)

Système.

ApplicationDataPath

<WF_SYSTEM_APPLICATION_DATA_PATH>

Renvoie le chemin physique du dossier de données d'application (p.ex. C:\inetpub\wwwroot\wfgen\app_data)

Système. Guid

<WF_SYSTEM_GUID>

Identificateur global unique (GUID) généré par le système

⚠️ Important : Le GUID généré sera le même lorsqu'il sera utilisé dans les paramètres d'action standard, sauf si l'option de script est activée. Dans ce cas, chaque expression aura un GUID unique.

Parent. Nom du process

<WF_PARENT_PROCESS_NAME>

Retourne le nom du processus parent dans une action de sous-processus

Parent.

Version du process

<WF_PARENT_PROCESS_VERSION>

Retourne la version du processus parent dans une action de sous-processus

Parent.

Identifiant de la demande

<WF_PARENT_PROCESS_INST_ID>

Retourne l'identifiant de la demande parent dans une action de sous-processus

Parent.

Identifiant de l'activité

<WF_PARENT_ACTIVITY_INST_ID>

Retourne l'identifiant de l'action parent dans une action de sous-processus

Paramètres de l'application de configuration Web

<WF_APP_SETTING_nom>

Macros créées selon des paramètres de l'application de configuration Web (voir la section Macros de paramètres d'application de configuration Web)

* champ : Voir le tableau suivant.

Suffixes des macros utilisateurs

Champ

Description

LASTNAME

Nom

FIRSTNAME

Prénom

USERNAME

Nom d’utilisateur

MANAGER

Nom d'utilisateur du gestionnaire

MANAGER_LASTNAME

Nom du gestionnaire

MANAGER_FIRSTNAME

Pré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

Numéro d’employé

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

Utilisation des macros

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

📌 Exemple 1

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

  • Nom du paramètre : REQUESTER_USERNAME

  • Envoyer la valeur d’une macro : Requester.Username

📌 Exemple 2

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

  • Nom du paramètre : REQUESTER_NAME

  • Envoyer la valeur d’un texte : <WF_REQUESTER_FIRSTNAME> <WF_REQUESTER_LASTNAME>

Macros des données de type fichier

Accès aux propriétés du fichier

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

Champ

Type

Description

FILENAME

TEXT

Nom du fichier

SIZE

NUMERIC

Taille du fichier en kilooctets

CONTENTTYPE

TEXT

Type de contenu du fichier

DESCRIPTION

TEXT

Description du fichier

DATELASTMODIFIED

DATETIME

Date de la dernière modification du fichier

Exemples de syntaxe

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

📌 Exemple 1

  • Règle : Vérifier si le nom du fichier contient le mot clé rapport

    • Méthode : InStr(1,<MON_FICHIER.FILENAME>,"rapport",1) <> 0

📌 Example 2

  • Règle : Vérifier si la taille du fichier est inférieure à 1 Mo

    • Méthode : <MON_FICHIER.SIZE> < 1024

📌 Exemple 3

  • Règle : Vérifier si le fichier est un document MS Word :

    • Méthode : <MON_FICHIER.CONTENTTYPE> = "application/msword"

📌 Exemple 4

  • Règle : Vérifier si le fichier a été modifié aujourd’hui :

    • Méthode : <MON_FICHIER.DATELASTMODIFIED> > [Date]

Vérification de l’existence d’un fichier

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

📌 Exemple

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

IsNull(<MON_FICHIER>)

Exemples de macros

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

Macro

Exemple

Utilisateur connecté.champ

<WF_USER_FIRSTNAME> <WF_USER_DEPARTMENT> donnera "John Accounting"

Utilisateur assigné.champ

<WF_ASSIGNEE_EMPLOYEENUMBER> <WF_ASSIGNEE_EMPLOYEETYPE> donnera "11225 Permanent"

Demandeur.champ

<WF_REQUESTER_COMPANY>

<WF_REQUESTER_LASTNAME> donnera "My company Smith"

Initiateur de l’action.champ

<WF_INITIATOR_FIRSTNAME>

<WF_INITIATOR_LASTNAME> donnera "John Smith"

Process.Id

12

Process.Nom

"APPROBATION_SIMPLE"

Process.Description

"Approbation simple"

Process.Statut

"ACTIVE"

Process.FormUrl

"http://mycompany.com/wfgen/wfapps/webforms/MACRO_TEST_2/V1/Default.aspx"

Process.Version

1

Action.Id

2

Action.Nom

"INITIATES"

Action.Description

"Le demandeur lance la demande"

Action en cours.Id

2

Action en cours.Nom

"2-VALIDATES"

Action en cours.Date de création

2019-04-20T20:23:07Z

Action en cours.Délai

2019-04-30-T20:25:25:46Z

Action en cours.Compteur

2

Demande.Id

1701

Demande.Id relatif

12

Demande.Id relatif mensuel

12

Demande.Id relatif annuel

12

Demande.Nom

"2_LEVELS_APPROVAL #1795"

Demande.Date de création

2019-04-20T20:35:00Z

Demande.Délai

2019-04-30T09:00:00Z

Action.Participant nom

"Jean"

Système.Date

4/20/2019

Système.Date/heure

4/20/2019 2:44 PM

Système.Heure

1:44 PM

Système.Langue

"en-US"

Système.Null

<NULL>

Application.BaseUrl

http://myserver.com

Macros de paramètres d'application de configuration Web

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

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

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

📌 Exemple

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

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