Application de workflow GETUSERSFROMDIR
Aperçu
L’application de workflow GETUSERSFROMDIR permet la récupération d’une liste de noms d’utilisateurs, d’une liste d’emails ou d’une liste des IDs utilisateur. Ces listes s’obtiennent via une action automatique WorkflowGen qui exécute des requêtes SQL sur la base de données WorkflowGen. Elle peut être utilisée pour les notifications automatiques ou pour définir (filtrer) les utilisateurs d’une action d’un processus WorkflowGen.
Définitions
Le caractère
x
: Le caractèrex
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 avoirQUERY1_CMD
,QUERY2_CMD
,QUERY3_CMD
etc...Action : Vous devez créer une action WorkflowGen de type GETUSERSFROMDIR pour utiliser cette application.
Liste des champs et macros disponibles pour les requêtes
Voici les champs et macros disponibles pour les requêtes créées dans les paramètres QUERYx_CMD
. Ils peuvent être utilisés dans les conditions de ces requêtes afin de filtrer leurs résultats.
📌 Exemples
Cet exemple retourne une liste des noms d’utilisateur des utilisateurs de la province du Québec :
Cet exemple retourne une liste des noms d’utilisateur des utilisateurs dont l’adresse email termine par advantys.com
:
Cet exemple retourne une liste des noms d’utilisateur des utilisateurs appartenant au groupe de développement :
Utilisation des paramètres supplémentaires
QUERY1_CMD
: Exécution d’une requête SQL
QUERY1_CMD
: Exécution d’une requête SQLDescription
Pour lancer une requête SQL vous devez ajouter le paramètre (IN) QUERY1_CMD
à l’action. Si le paramètre est vide ou inexistant l’opération ne sera pas exécutée.
📌 Exemple
Cet exemple retourne la liste des utilisateurs de la ville de Montréal dans le paramètre RESULT_LIST
:
RESULT_LIST
/ QUERYx_RESULT_LIST
: Capture du résultat des requêtes
RESULT_LIST
/ QUERYx_RESULT_LIST
: Capture du résultat des requêtesDescription
Pour récupérer le résultat de toutes les requêtes (liste des utilisateurs au format chaîne de caractères) vous devez ajouter le paramètre (OUT) RESULT_LIST
à l’action. Pour récupérer le résultat individuel par requête vous devez ajouter le paramètre (OUT) QUERYx_RESULT_LIST
pour chaque requête.
📌 Exemple
Cet exemple retourne la liste des utilisateurs de Montréal, Toronto et New York dans le paramètre RESULT_LIST
. QUERY1_RESULT_LIST
contient la liste des utilisateurs de Montréal, QUERY2_RESULT_LIST
contient la liste des utilisateurs de Toronto et QUERY3_RESULT_LIST
contient la liste des utilisateurs de New York :
À partir de la version 7.15.0 de WorkflowGen, le résultat d'une requête renvoyée dans des données de processus de type TEXT n'a plus de limite de 4 000 caractères pour la base de données MS SQL Server.
QUERY1_DIR
: Définition de l’annuaire
QUERY1_DIR
: Définition de l’annuaireDescription
Vous pouvez définir l’annuaire des utilisateurs sur lequel vous voulez que porte la requête. Vous devez ajouter un paramètre (IN) QUERY1_DIR
dans l’action. Si ce paramètre est NULL ou n’existe pas l’annuaire par défaut est WORKFLOWGEN
(ou l’annuaire défini comme défaut par l’administrateur).
📌 Exemple
Cet exemple retourne la liste des noms d'utilisateur des utilisateurs de l’annuaire VotreSociété
dans le paramètre RESULT_LIST
:
QUERYx_CMD
: Utilisation de plusieurs requêtes
QUERYx_CMD
: Utilisation de plusieurs requêtesDescription
Vous pouvez ajouter plusieurs requêtes dans la même action WorkflowGen et récupérer les résultats dans une liste complète ou dans une liste par requête. Vous devez ajouter le paramètre (IN) QUERYx_CMD
dont x
est le numéro de la requête. Vous devez ajouter les paramètres (OUT) QUERYx_RESULT_LIST
pour récupérer les résultats de chaque requête.
📌 Exemple
Cet exemple retourne la liste des noms d'utilisateur des utilisateurs de Montréal de l’annuaire WORKFLOWGEN
dans le paramètre (IN) QUERY1_RESULT_LIST
, la liste des noms d'utilisateur des utilisateurs de Montréal de l’annuaire INTRANET
dans le paramètre (IN) QUERY2_RESULT_LIST
et la liste complète des noms d'utilisateur des deux requêtes dans le paramètre (IN) RESULT_LIST
:
QUERYx_TOP
: Définition du nombre maximum d’enregistrements du résultat
QUERYx_TOP
: Définition du nombre maximum d’enregistrements du résultatDescription
Vous pouvez spécifier le nombre maximum d’enregistrements retournés par les requêtes en ajoutant le paramètre (IN) QUERYx_TOP
à l’action. Cette requête ne sera pas capable de retourner plus de résultats que le nombre défini dans ce paramètre.
📌 Exemples
Cet exemple retourne seulement les deux premiers noms d'utilisateur de cette requête :
Cet exemple retourne tous les noms d'utilisateur de cette requête :
QUERYx_DEFAULT_VALUE
: Définition d’une valeur par défaut
QUERYx_DEFAULT_VALUE
: Définition d’une valeur par défautDescription
Vous pouvez définir une valeur par défaut à retourner pour les valeurs qui ne retournent pas de valeur. Vous devez ajouter un paramètre (IN) QUERYx_DEFAULT_VALUE
à l’action.
📌 Exemple
Dans cet exemple, la requête ne retourne aucune valeur car la société définie n’existe pas. Ainsi le paramètre RESULT_LIST
contiendra la valeur défaut1
:
RESULT_SEPARATOR
: Définition d’un séparateur
RESULT_SEPARATOR
: Définition d’un séparateurDescription
Vous pouvez définir un caractère de séparation des résultats dans la liste retournée en ajoutant un paramètre (IN) RESULT_SEPARATOR
à l’action. Le séparateur par défaut est ,
(virgule).
📌 Exemple
Pour cet exemple, la valeur retournée dans le paramètre RESULT_LIST
est nom1***nom2***nom3
:
Cet exemple retourne la valeur nom1,nom2,nom3
:
RESULT_COUNT
/ QUERYx_RESULT_COUNT
: Compteur du nombre d’enregistrements retournés
RESULT_COUNT
/ QUERYx_RESULT_COUNT
: Compteur du nombre d’enregistrements retournésDescription
Vous pouvez récupérer le nombre d’enregistrements retournés par chaque requête ou par toutes les requêtes. Pour le nombre total d’enregistrements retournés par toutes les requêtes vous devez ajouter le paramètre (OUT) RESULT_COUNT
à l’action. Pour le nombre d’enregistrements retournés par requête vous devez ajouter le paramètre (OUT) QUERYx_RESULT_COUNT
à l’action.
📌 Exemple
L’exemple suivant retourne le nombre total d’enregistrements dans le paramètre RESULT_COUNT
et le nombre d’enregistrements par requête (QUERY1
et QUERY2
) dans les paramètres QUERY1_RESULT_COUNT
et QUERY2_RESULT_COUNT
:
Utilisation des paramètres dans les conditions des requêtes SQL
Description
Vous pouvez utiliser des paramètres dans les conditions SQL contenues dans le paramètre QUERYx_CMD
. Vous devez ajouter des paramètres IN avec des noms différents des noms réservés suivants :
QUERYx_CMD
QUERYx_DIR
QUERYx_TOP
QUERYx_RESULT_COUNT
QUERYx_RESULT_LIST
RESULT_LIST
RESULT_COUNT
RESULT_SEPARATOR
Vous pouvez alors appeler ces paramètres dans la condition en les préfixant par le caractère @
(arobase).
📌 Exemple
Cet exemple retourne la liste des noms d'utilisateur des utilisateurs de Montréal de l’annuaire WORKFLOWGEN
:
N’oubliez pas que le nom du paramètre utilisé dans la condition doit être le même que celui défini dans l’action WorkflowGen.
QUERYx_CMD
: Utilisation des macros dans les conditions des requêtes SQL
QUERYx_CMD
: Utilisation des macros dans les conditions des requêtes SQLDescription
Vous pouvez utiliser des macros dans les conditions SQL contenues dans les paramètres QUERYx_CMD
. Vous devez simplement ajouter une macro disponible dans la condition.
📌 Exemple
L’exemple suivant retourne la liste des noms d'utilisateur des utilisateurs membres du groupe Dev
venant de Montréal et associés à l’annuaire WORKFLOWGEN
:
Il est important de respecter la syntaxe dans la liste des macros disponibles.
RESULT_LIST_EMAIL
/ QUERYx_RESULT_LIST_EMAIL
: Capture des résultats des requêtes sous forme de liste d’emails
RESULT_LIST_EMAIL
/ QUERYx_RESULT_LIST_EMAIL
: Capture des résultats des requêtes sous forme de liste d’emailsDescription
Pour récupérer la liste des emails résultant de toutes les requêtes vous devez ajouter un paramètre (OUT) RESULT_LIST_EMAIL
à l’action. Si vous voulez retrouver les emails par requête vous devez ajouter un paramètre (OUT) QUERYx_RESULT_LIST_EMAIL
pour chaque requête.
📌 Exemple
Cet exemple retourne la liste des emails des utilisateurs de Montréal et Toronto dans le paramètre RESULT_LIST_EMAIL
. Les paramètres QUERY1_RESULT_LIST_EMAIL
et QUERY2_RESULT_LIST_EMAIL
contiennent respectivement la liste des emails des utilisateurs de Montréal et de Toronto :
Gestion des erreurs dans WorkflowGen
Vous devez ajouter une action corrective liée à l’action GETUSERSFROMDIR afin de gérer les erreurs d’exécution. Cette action corrective est de type manuel et est lancée sur erreur d’exécution. Ainsi vous devez ajouter cette exception sur la transition entre les deux actions. Vous trouverez ci-dessous la liste des erreurs les plus fréquentes retournées par l’application.
Nombre maximum d’enregistrements retournés
Il existe une constante GetUsersFromDirMaxResultNb
dans le fichier web.config
contenant le nombre maximum d’enregistrements pouvant être retourné par une requête. Cette limite réduit le risque d’une erreur d’expiration d’un temps limite qui peut se produire lorsque les résultats des requêtes sont trop nombreux. Si le nombre d’enregistrements retournés est supérieur à la valeur de cette constante un message d’erreur indiquant que les requêtes retournent trop d’enregistrements (« The queries returned too many records ») sera affiché.
Dernière mise à jour