Le plug-in Form Process Launch permet de lancer un formulaire enfant distinct depuis un formulaire parent. En outre, il permet d’initier un processus séparé pour un individu spécifique d’une liste, et pour les données à copier du formulaire parent au formulaire enfant.
Si vous déployez une solution et que les paramètres app, library, processname, appgroup, userapp, et/ou userlibrary sont introuvables, vous recevrez un message d’erreur.
Propriétés
Nom |
Description |
Obligatoire |
Nom du groupe |
Modes |
||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
app |
Nom de l’application qui contient le formulaire et le processus que vous désirez lancer. Exemple : Valeur directe : AppName Valeur provenant du champ solution : [field1] |
Oui |
Processus de formulaire |
Tout |
||||||||||||||||||
bibliothèque |
Bibliothèque qui contient le processus ou la solution que vous désirez lancer. Exemple : Valeur directe : LibraryName Valeur provenant du champ solution : [field1] |
Oui |
Processus du formulaire |
Tout |
||||||||||||||||||
processname |
Nom du processus ou de la solution que vous désirez lancer. Ce processus/cette solution doit être publiée avant d’utiliser le plug-in Form Process Launch et doit avoir un formulaire correspondant. Exemple : Valeur directe : SolutionName Valeur provenant du champ solution : [field1] |
Oui |
Processus du formulaire |
Tout |
||||||||||||||||||
appgroup |
Un groupe que vous associez au couloir désigné au sein de la propriété du couloir. Si le paramètre appgroup est utilisé, un seul index de couloir peut être utilisé. Les couloirs multiples peuvent être affectés s’ils sont affectés dans les listes de données de référence. Exemple : Valeur directe : CollectionOwner Valeur provenant du champ solution : [field1] |
Non |
Résolveur de couloir |
Appgroup |
||||||||||||||||||
swimlane[index] |
Nom du couloir du workflow de processus/solution que vous désirez lancer. Pour le mécanisme de groupes d'application : au lancement du processus, les utilisateurs renvoyés par le paramètre appgroup sont affectés à ce couloir du processus enfant. Mécanisme de données de référence : le couloir du processus enfant auquel les utilisateurs renvoyés par le paramètre usercolumn (à la position spécifiée par l'index) sont assignés lors du lancement du processus. Exemple : Valeur directe : swimlaneName Valeur provenant du champ solution : [field1] Remarquez que la valeur d’index commence par zéro (vierge), et continue à partir de 0. |
Oui |
Résolveur de couloir |
Tout |
||||||||||||||||||
userapp |
Le nom de l’application qui contient la solution de données de référence à partir de laquelle les utilisateurs doivent être extraits. Exemple : Valeur directe : AppName Valeur provenant du champ solution : [field1] |
Non |
Résolveur de couloir |
Données de référence, groupe répétitif |
||||||||||||||||||
userlibrary |
La bibliothèque qui contient la solution de données de référence à partir de laquelle les utilisateurs doivent être extraits. Exemple : Valeur directe : LibraryName Valeur provenant du champ solution : [field1] |
Non |
Résolveur de couloir |
Données de référence, groupe répétitif |
||||||||||||||||||
usersolution |
Le nom de la solution de données de référence à partir de laquelle les utilisateurs doivent être extraits. Exemple : Valeur directe : SolutionName Valeur provenant du champ solution : [field1] |
Non |
Résolveur de couloir |
Données de référence, groupe répétitif |
||||||||||||||||||
usercolumn[index] |
Le nom de la colonne solution de données de référence comprenant les utilisateurs qui sont affectés à un couloir à la position spécifiée dans l'index. Il est uniquement utilisé avec le mécanisme de données de référence. Exemple : Valeur directe : SolutionName Valeur provenant du champ solution : [field1] Si la valeur d’index est vierge, elle peut être la valeur directe, la valeur de champ formulaire ou la valeur de champ solution. Si elle n’est pas vierge, elle peut être uniquement la valeur directe. La valeur d’index commence par zéro/vierge, et continue à partir de 0. |
Non |
Résolveur de couloir |
Données de référence, groupe répétitif |
||||||||||||||||||
query |
Requête à utiliser lors de l’extraction des lignes de données de référence. Exemple : Valeur directe [Plant]=@[/my:myFields/my:group1/my:group2/my:field5] |
Non |
Résolveur de couloir |
Données de référence, groupe répétitif |
||||||||||||||||||
groupcolumn |
Le nom de la colonne solution de données de référence qui contient les noms Groupe d’utilisateurs/application. Exemple : Valeur directe : testGroupColumn Si les deux paramètres -- usercolumn et groupcolumn -- sont définis, le système recherchera ces deux colonnes dans les données de référence. Cela créera un processus pour tous les utilisateurs dans chaque groupe désigné. Exemple : Valeurs de User Column --/-- Valeurs de Group Column
Le système démarrera trois processus enfants, un pour chaque groupe comme suit : Premier processus pour les utilisateurs - utilisateur1, utilisateur2, utilisateur3 Premier processus pour les utilisateurs - utilisateur1, utilisateur4, utilisateur5, utilisateur6 Troisième processus pour les utilisateurs - utilisateur7, utilisateur8 |
Non |
Résolveur de couloir |
Données de référence, groupe répétitif |
||||||||||||||||||
sourcefield[index] |
Le nom d’un champ au sein d’un formulaire parent, dont la valeur est copiée dans un champ du formulaire enfant. L’utilisateur doit fournir l’Xpath du champ de formulaire enfant dans le paramètre de champ de destination au même index. La valeur d’index commence à 0. |
Non |
Copier des champs formulaire |
Tout |
||||||||||||||||||
destinationfield[index] |
L’Xpath d’un champ au sein d’un formulaire enfant auquel la valeur d’un champ du formulaire parent sera copiée. Les valeurs d’un index donné seront copiées du paramètre sourcefield au champ de destination avec le même index. La valeur d’index commence à 0. Exemple : Valeur directe : /my:myFields/my:field2 |
Non |
Copier des champs formulaire |
Tout |
||||||||||||||||||
singleprocess |
Indique que seul un processus unique ou multiple devrait être lancé. Si défini sur Oui, un processus unique est lancé et tous les utilisateurs sont traités en tant qu’équipe au sein d’une affectation d’équipe. Si défini sur Non, plusieurs processus sont lancés, un pour chaque utilisateur. |
Non |
Solution de formulaire |
Tout |
||||||||||||||||||
autosyncfields |
Copie automatiquement les valeurs de tous les champs nommés de manière identique dans les formulaires parents et enfants. Si ce paramètre est défini sur Oui, il est inutile d'associer les champs (dans les paramètres sourcefield et destinationfield) avec le même nom dans les champs enfants et parents. Si autosyncfields est défini, cette opération est exécutée avant de définir explicitement les valeurs de champ, spécifié via le paramètre sourcefield [index], etc. |
Non |
Copier des champs formulaire |
Tout |
||||||||||||||||||
repeatinggroupfieldxpath[index] |
Le nom d’un champ du groupe répétitif au sein d’un formulaire parent, dont la valeur est copiée dans un champ du formulaire enfant. L’utilisateur doit fournir l’Xpath du champ de groupe répétitif du formulaire enfant dans le paramètre fielddestinationxpath au même index. La valeur d’index commence à 0. |
Non |
Copier des champs formulaire |
Tout |
||||||||||||||||||
fielddestinationxpath[index] |
L’Xpath d’un champ au sein d’un formulaire enfant auquel la valeur d’un champ de groupe répétitif du formulaire parent sera copiée. Les valeurs d’un index donné seront copiées du paramètre repeatinggroupfieldxpath au champ de fielddestinationxpath avec le même index. La valeur de l'index commence à 0. SingleProcess doit avoir la valeur False pour que ce paramètre fonctionne. Les groupes répétitifs multiples ne sont pas pris en charge. Exemple : Valeur directe : /my:myFields/my:field2 |
Non |
Copier des champs formulaire |
Groupe répétitif |
||||||||||||||||||
repeatinggroup |
Le nom du groupe répétitif dans le formulaire parent. SingleProcess doit avoir la valeur False pour que ce paramètre fonctionne. |
Non |
Résolveur de couloir |
Groupe répétitif |
||||||||||||||||||
resolveswimlanes |
Un champ booléen qui indique s’il faut exécuter les résolveurs de participants du couloir à partir du processus enfant. La valeur par défaut est Non. Si définie sur Oui, les couloirs du processus enfant seront toujours résolus. Si les utilisateurs sont également résolus par le paramètre swim lane , les utilisateurs des paramètres PR et swim lane seront fusionnés. Si définie sur Non, le paramètre swimlane résout tous les couloirs de processus enfant et ainsi la résolution du PR n’est pas achevée. Si tous les couloirs du processus enfant ne sont pas résolus par le paramètre swimlane, il se comporte comme si la valeur Oui était sélectionnée. |
Non |
Résolveur de couloir |
Tout |
Exemples
Un utilisateur lance un formulaire et utilise le formulaire pour rechercher une liste d’enregistrements. Si l’enregistrement existe déjà, l’utilisateur lance un formulaire Modifier l’enregistrement (depuis le formulaire parent) qui sera attribué à un ou plusieurs utilisateurs en fonction d’un paramètre Appgroup ou des Données de référence ou d’un Groupe répétitif de personne attribuant les tâches pour modifier l’enregistrement. Si la colonne Données de référence contient 10 personnes, un nouveau processus et un nouveau formulaire sont lancés pour chaque membre. Ce qui représente 10 formulaires et processus, un pour chaque membre.
Il existe 3 mécanismes de lecture d’un formulaire lancé par ce plug-in :
- Le mécanisme Appgroup permet de démarrer un formulaire et un processus pour chaque personne du groupe.
- Le mécanisme Données de référence démarre un formulaire et un processus pour chaque ligne d’une colonne Données de référence et affecte les utilisateurs spécifiés de la liste à des couloirs définis.
- Le mécanisme Groupe répétitif est l’emplacement dans lequel une requête basée sur les champs dans un groupe répétitif peut retourner ou non un utilisateur. Les résultats de la requête sont utilisés pour résoudre le ou les couloirs.
Dans le mécanisme Groupe répétitif, vous pouvez associer les champs d’une section répétitive dans le formulaire enfant. Les paramètres utilisés pour cela sont repeatinggroup, fielddestinationxpath[index] et repeatinggroupfieldxpath[index]. Pour associer les champs d’un groupe répétitif, définissez les paramètres repeatinggroup, fielddestinationxpath et repeatinggroupfieldxpath. Les deux derniers paramètres sont indexés. Par conséquent, plusieurs champs du formulaire parent peuvent être également associés aux champs du formulaire enfant.
Attendre les processus enfants
Le workflow peut être configuré pour attendre la fin de l’exécution des processus enfants avant de poursuivre l’exécution du workflow. Par exemple, si vous créez un formulaire Nouvelle embauche, Tâches informatiques pourrait être un formulaire enfant. En utilisant un plug-in Wait for Child, le formulaire Nouvelle embauche peut être suspendu jusqu’à l’exécution complète du formulaire enfant Tâches informatiques.
Lorsque vous utilisez des plug-ins Wait for Child immédiatement après le plug-in Form Process Launch, ajoutez un nœud Attendre pour donner le temps au plug-in enfant de démarrer. Autrement, le plug-in Wait for Child peut se terminer prématurément. Le délai d’attente est déterminé par la vitesse à laquelle le travail en arrière-plan peut traiter le type de travail formprocesslaunch.
Voici des exemples rapides de paramètres et de valeurs de « brefs formulaires » que vous pouvez utiliser pour diverses fonctions.
Exemple de groupes d'applications
|
Cet exemple permet de démarrer le nouveau processus Processus Formulaire commentaire par rapport à un nouveau Formulaire Commentaire pour chaque personne dans le groupe Commentateur. Il attribue la personne au couloir Commentaires dans chaque processus. |
Exemple de données de référence
|
Cet exemple permet de démarrer le nouveau processus appelé Processus Formulaire commentaire par rapport à un nouveau Formulaire Commentaire pour chaque ligne de la liste Cessionnaires de commentaire de la solution de données de référence de la bibliothèque ReferenceDataLibrary1 pour l’application App2. La personne dans le champ Commentateur sera attribuée au couloir Commentaires, et la personne dans le champ Gestionnaire d’utilisateur est attribuée au couloir Gestionnaires. |
Exemple 1 de groupes répétitifs
|
Cet exemple interroge la liste d’utilisateurs Cessionnaires de commentaire dans l’application App2 pour chaque ligne du groupe répétitif my:Repeating_Group_2. Si un utilisateur est trouvé, il démarre le nouveau processus appelé Processus Formulaire commentaire par rapport au nouveau Formulaire commentaire dans lequel le champ 1 et le champ 2 dans le groupe répétitif du formulaire parent sont associés respectivement au champ 1 et au champ 2 du formulaire enfant, pour cette ligne de l’application App1. La personne dans le champ Commentateur retourné par la requête est attribuée au couloir Commentaires. |
Exemple 2 de groupes répétitifs
|
Cet exemple interroge la liste d’utilisateurs Cessionnaires de commentaire dans l’application App2 pour chaque ligne du groupe répétitif my:Repeating_Group_2. Si un utilisateur est trouvé, il démarre le nouveau processus appelé Processus Formulaire commentaire par rapport au nouveau Formulaire Commentaire dans lequel le champ 1 et le champ 2 dans le groupe répétitif du formulaire parent sont associés respectivement au champ 1 et au champ 2 du formulaire enfant, pour cette ligne de l’application (App1). La personne dans le champ Commentateur retourné par la requête est attribuée au couloir Commentaires. Les résolveurs de participants du couloir du processus enfant sont également exécutés, car resolveswim lanes a la valeur true. |