Documentation AEM 6.5 Guide de l’utilisateur

Référence sur les étapes de workflow

Dernière mise à jour : 30 avril 2024

S'applique à :
Experience Manager 6.5

Rubriques :
Développement

Créé pour :

Développeur

Les modèles de workflow se composent d’une série d’étapes de différents types. En fonction du type, ces étapes peuvent être configurées et étendues avec des paramètres et des scripts afin de fournir les fonctionnalités et le contrôle dont vous avez besoin.

REMARQUE

Cette section décrit les étapes standard du workflow.

Pour les étapes spécifiques aux modules, voir :

Propriétés des étapes

Chaque composant d’étape comporte une boîte de dialogue Propriétés de l’étape qui vous permet de définir et de modifier les propriétés requises.

Propriétés des étapes - Onglet courant

Une combinaison des propriétés suivantes est disponible pour la plupart des composants d’étape de workflow, sur l’onglet Courant de la boîte de dialogue des propriétés :

Titre
Titre de l’étape.
Description
Description de l’étape.
Étape du workflow

Sélecteur déroulant pour appliquer une phase à l’étape.
Délai dépassé

La période au bout de laquelle l’étape « expire ».
Vous avez le choix entre : Désactivé, Immédiat, 1 h, 6 h, 12 h et 24 h.
Gestionnaire de dépassement de délai

Gestionnaire qui contrôle le workflow lorsque l’étape expire. Par exemple, Auto Advancer
Avance du gestionnaire

Sélectionnez cette option pour avancer automatiquement le workflow à l’étape suivante après l’exécution. Si cette option n’est pas sélectionnée, le script de mise en œuvre doit gérer l’avancement du workflow.

Propriétés des étapes - Onglet utilisateur/groupe

Les propriétés suivantes sont disponibles pour de nombreux composants d’étape de workflow, dans l’onglet Utilisateur/Groupe de la boîte de dialogue des propriétés :

Avertir l’utilisateur ou l’utilisatrice par e-mail
- Notifiez les participants et les participantes en leur envoyant un e-mail lorsque le workflow atteint l’étape.
- Si cette option est activée, un e-mail est envoyé à l’utilisateur ouà l’utilisatrice défini par la propriété Utilisateur/Groupe, ou à chaque membre du groupe si un groupe est défini.
Utilisateur/Groupe
- Une liste déroulante de sélection vous permet d’accéder à un utilisateur, une utilisatrice ou à un groupe et de le sélectionner.
- Si vous attribuez l’étape à un utilisateur ou une utilisatrice spécifique, cette personne sera la seule à pouvoir agir sur l’étape.
- Si vous attribuez l’étape à un groupe entier, alors lorsque le workflow atteint cette étape tous les utilisateurs et utilisatrices de ce groupe disposeront de l’action dans leur boîte de réception des workflows.
- Pour plus d’informations, reportez-vous à la section Participation aux workflows.

Division ET

La Division ET crée une division dans le workflow, après laquelle les deux branches deviennent actives. Vous ajoutez des étapes de workflow à chaque branche selon vos besoins. Cette étape vous permet d’ajouter plusieurs chemins de traitement dans le workflow. Par exemple, vous pouvez autoriser certaines étapes de révision à se produire en parallèle, ce qui vous permet de gagner du temps.

wf-26

Division ET - Configuration

Pour configurer la division :

Modifiez les propriétés de la division ET :
- Fractionner le nom : attribuez un nom à des fins d’explication.
- Sélectionnez le nombre de branches nécessaires : 2, 3, 4 ou 5.
Ajoutez des étapes de workflow aux branches, le cas échéant.

Étape du conteneur

Une étape de conteneur lance un autre modèle de workflow qui s’exécute en tant que workflow enfant.

Ce conteneur peut vous permettre de réutiliser des modèles de workflow pour implémenter des séquences d’étapes courantes. Par exemple, un modèle de processus de traduction peut être utilisé dans plusieurs workflows de modification.

wf-28

Étape du conteneur - Configuration

Pour configurer l’étape, modifiez et utilisez les onglets suivants :

Commun
Conteneur
- Workflow secondaire : sélectionnez le workflow à démarrer.

Etape Atteindre

L’Étape Goto vous permet de spécifier l’étape suivante à exécuter dans le modèle de workflow. Vous pouvez spécifier une définition de règle, un script externe ou un script ECMA comme expression de routage pour évaluer l’étape suivante du modèle de workflow.

Si la condition que vous spécifiez est vraie, l’Étape Goto se termine et le moteur de workflow exécute l’étape spécifiée.
Si la condition que vous spécifiez ne contient pas la valeur true, l’Étape Goto se termine et la logique de routage normale détermine l’étape suivante à exécuter.

L’Étape Goto vous permet de mettre en œuvre des structures de routage avancées dans vos modèles de workflow. Par exemple, pour mettre en œuvre une boucle, l’Étape Goto peut être définie pour exécuter une étape antérieure dans le workflow, avec le script évaluant une condition de boucle.

Etape Atteindre - Configuration

Pour configurer l’étape, modifiez et utilisez les onglets suivants :

Commun
Processus
- Étape Cible : sélectionnez l’étape à exécuter après l’évaluation de la condition de l’expression de routage.
- Expression de routage : sélectionnez la définition de règle, un script externe ou un script ECMA qui détermine s’il faut exécuter l’Étape Cible.
  - Définition de règle : utilisez l’éditeur d’expression pour définir la règle.
  - Script externe : chemin d’accès du script externe.
  - Script ECMA : script qui détermine si l’Étape Goto doit être exécutée.

Simulation d’une « boucle for »

Pour simuler une « boucle for », vous devez compter le nombre d’itérations de boucle qui se sont produites :

Ce nombre représente généralement un index des éléments qui sont traités dans le workflow.
Ce nombre est évalué comme critère de sortie de la boucle.

Par exemple, pour implémenter un workflow qui exécute une action sur plusieurs nœuds JCR, vous pouvez utiliser un compteur de boucles comme index pour les nœuds. Pour rendre le compte persistant, stockez une valeur integer dans le mappage de données de l’instance de workflow. Pour incrémenter le compte et comparer ce compte aux critères de sortie, utilisez le script de l’étape Atteindre.

function check(){
   var count=0;
   var keyname="loopcount"
   try{
      if (workflowData.getMetaDataMap().containsKey(keyname)){
        log.info("goto script: found loopcount key");
        count= parseInt(workflowData.getMetaDataMap().get(keyname))+1;
      }

     workflowData.getMetaDataMap().put(keyname,count);

     }catch(err) {
         log.info(err.message);
         return false;
    }
   if (parseInt(count) <7){
       return true;
   } else {
      return false;
   }
}

Simulation d’une boucle for à l’aide la définition de règle

Vous pouvez également simuler une boucle for à l’aide de la définition de règle comme expression de routage. Créez une variable countde type de données Long. Utilisez Expression comme mode de mappage dans l’étape Définir la variable pour définir la valeur de la variable count sur count + 1 à chaque exécution de l’étape Définir la variable.

Simulation d’une boucle for

Dans l’Étape Goto, utilisez Définir la variable comme Étape cible et count < 5 comme expression de routage.

Condition de simulation d’une boucle for

L’étape Définir la variable s’exécute à plusieurs reprises pour incrémenter la valeur de la variable Compte de 1 pour chaque exécution, jusqu’à ce que la valeur atteigne 5.

Division OU

La Division OU crée une division dans le workflow, après laquelle une seule branche est active. Cette étape permet d’ajouter des chemins de traitement conditionnels dans le processus. Vous ajoutez des étapes de processus à chaque branche selon vos besoins.

NOTE

Voir Étape de la division OU

Branchement à l’aide de la division OU

Division OU - Configuration

Pour configurer la division :

Modifiez les propriétés de la division OU :
- Commun
  - Spécifiez le nom de la division.
- Branches (x)
  - Ajouter une branche : ajoutez d’autres branches à l’étape.
  - Sélectionner l’expression de routage : pour évaluer la branche active, sélectionnez l’expression de routage. Les valeurs possibles sont les suivantes : Définition de règle, Script externe et Script ECMA.
  - Cliquer pour ajouter une expression : ajoutez une expression pour évaluer la branche active si vous sélectionnez Définition de règle comme expression de routage.
  - Chemin du script : chemin d’accès à un fichier contenant le script pour évaluer la branche active si vous sélectionnez Script externe comme expression de routage.
  - Script : ajoutez le script dans la zone pour évaluer la branche active si vous sélectionnez Script ECMA comme expression de routage.
  - Itinéraire par défaut : la branche par défaut est suivie, en cas de branches multiples. Vous ne pouvez spécifier qu’une seule branche par défaut.
NOTE
Les branches sont évaluées une par une en fonction de l’expression de routage.

Les branches sont évaluées de haut en bas.

Le premier script qui renvoie la valeur true est exécuté.

Si aucune branche ne renvoie la valeur true, le workflow ne progresse pas.
NOTE
Consultez la section Définir une règle pour une division OU.
Ajoutez des étapes de workflow aux branches, le cas échéant.

Programme et étapes de sélection des participants

Étape du participant

L’Étape du participant vous permet d’attribuer la responsabilité d’une action spécifique. Pour que le workflow se poursuive, l’utilisateur ou l’utilisatrice doit valider manuellement l’étape. Ce workflow permet qu’une personne agisse sur un workflow. Par exemple, une étape de révision.

Notez également que l’utilisatrice ou l’utilisateur doit disposer des autorisations nécessaires lors de l’attribution d’une action. Celle-ci doit avoir accès à la page qui est la payload du workflow.

Étape du participant - Configuration

Pour configurer l’étape, modifiez et utilisez les onglets suivants :

Commun
Utilisateur/Groupe

NOTE

L’initiateur ou l’initiatrice du workflow est toujours averti dans les situations suivantes :

fin du workflow (terminé)
abandon du workflow (arrêté).

NOTE

Certaines propriétés doivent être configurées pour activer les notifications par e-mail. Vous pouvez également personnaliser le modèle d’e-mail ou ajouter un modèle d’e-mail pour une autre langue. Pour configurer les notifications par e-mail dans AEM, consultez la section Configurer les notifications par e-mail.

Étape du participant de la boîte de dialogue

Utilisez l’Étape des participants de la boîte de dialogue pour collecter des informations auprès de l’utilisateur ou utilisatrice auquel l’élément de travail a été attribué. Cette étape est utile pour collecter de petites quantités de données utilisées plus loin dans le workflow.

Une fois l’étape terminée, la boîte de dialogue Terminer l’élément de travail contient les champs définis dans votre boîte de dialogue. Les données collectées dans les champs sont stockées dans les nœuds de la charge utile du workflow. Les étapes suivantes du workflow peuvent alors lire la valeur dans le référentiel.

Pour configurer l’étape, indiquez le groupe ou l’utilisateur ou utilisatrice affecté à l’élément de travail, ainsi que le chemin d’accès à la boîte de dialogue.

Étape des participants de la boîte de dialogue - Configuration

Pour configurer l’étape, modifiez et utilisez les onglets suivants :

Commun
Utilisateur/Groupe
Boîte de dialogue
- Chemin de la boîte de dialogue : chemin du nœud de la boîte de dialogue que vous créez.

Étape des participants de la boîte de dialogue - Créer une boîte de dialogue

Pour créer une boîte de dialogue, vous devez :

Déterminer l’emplacement où les données obtenues seront stockées dans la payload.
Définir la boîte de dialogue ; notamment les champs utilisés pour collecter (et enregistrer) les données.

Étape des participants de la boîte de dialogue - Stockage des données dans la payload

Vous pouvez stocker des données de widget dans la payload du workflow ou dans les métadonnées de l’élément de travail. Le format de la propriété name du nœud de widget détermine l’endroit où les données sont stockées.

Stockage des données avec le payload
- Pour stocker des données de widget en tant que propriété du payload de workflow, utilisez le format suivant pour la propriété de nom du nœud de widget :
  ./jcr:content/nodename
- Les données sont stockées dans la propriété nodename du nœud de payload. Si le nœud ne contient pas cette propriété, la propriété est créée.
- Lors du stockage avec la payload, les utilisations suivantes de la boîte de dialogue avec la même payload remplacent la valeur de la propriété.
Stockage des données avec l’élément de travail
- Pour stocker des données de widget en tant que propriété de métadonnées d’élément de travail, utilisez le format suivant pour la valeur de la propriété de nom :
  nodename
- Les données sont stockées dans la propriété nodename des metadata de l’élément de travail. Les données sont conservées si la boîte de dialogue est ensuite utilisée avec la même payload.

Étape des participants de la boîte de dialogue - Définition de boîte de dialogue

Structure de boîte de dialogue

Les boîtes de dialogue des étapes des participants de la boîte de dialogue sont similaires aux boîtes de dialogue que vous créez pour la création de composants. Elles sont stockées sous :

/apps/myapp/workflow/dialogs

Les boîtes de dialogue de l’IU tactile standard présentent la structure de nœud suivante :
newComponent (cq:Component) |- cq:dialog (nt:unstructured) |- content |- layout |- items |- column |- items |- component0 |- component1 |- ...
NOTE
Voir Création et configuration d’une boîte de dialogue.
Propriété Chemin de la boîte de dialogue

L’étape de participant de la boîte de dialogue possède la propriété Chemin de la boîte de dialogue (ainsi que les propriétés d’une étape de participant). La valeur de la propriété Chemin de la boîte de dialogue est le chemin du nœud dialog de la boîte de dialogue.

Par exemple, la boîte de dialogue se trouve dans un composant nommé EmailWatch qui est stocké dans le nœud :

/apps/myapp/workflows/dialogs

Pour l’IU compatible avec les écrans tactiles, la valeur suivante est utilisée pour la propriété Chemin de la boîte de dialogue :

/apps/myapp/workflow/dialogs/EmailWatch/cq:dialog

Exemple de définition de boîte de dialogue

Le fragment de code XML ci-après représente une boîte de dialogue qui stocke une valeur de Stringchaîne dans le nœud watchEmail du contenu du payload. Le nœud de titre représente le composant TextField :

jcr:primaryType="nt:unstructured"
    jcr:title="Watcher Email Address Dialog"
    sling:resourceType="cq/gui/components/authoring/dialog">
    <content jcr:primaryType="nt:unstructured"
        sling:resourceType="granite/ui/components/foundation/container">
        <layout jcr:primaryType="nt:unstructured"
            margin="false"
            sling:resourceType="granite/ui/components/foundation/layouts/fixedcolumns"
        />
        <items jcr:primaryType="nt:unstructured">
            <column jcr:primaryType="nt:unstructured"
                sling:resourceType="granite/ui/components/foundation/container">
                <items jcr:primaryType="nt:unstructured">
                    <title jcr:primaryType="nt:unstructured"
                        fieldLabel="Notification Email Address"
                        name="./jcr:content/watchEmails"
                        sling:resourceType="granite/ui/components/foundation/form/textfield"
                    />
                </items>
            </column>
        </items>
    </content>
</cq:dialog>

Dans l’interface utilisateur tactile, cet exemple donne lieu à une boîte de dialogue telle que :

chlimage_1-70

Étape du participant dynamique

Le composant Étape du participant dynamique est similaire à l’étape du participant, à la différence que la sélection du participant ou de la participante s’effectue automtiquement au moment de l’exécution.

Pour configurer l’étape, sélectionnez un Programme de sélection des participants qui identifie les participants auxquels affecter l’élément de travail, ainsi qu’une boîte de dialogue.

Étape du participant dynamique - Configuration

Pour configurer l’étape, modifiez et utilisez les onglets suivants :

Commun
Programme de sélection des participants
- Programme de sélection des participants : nom du programme de sélection des participants que vous créez.
- Arguments : tous les arguments requis.
- E-mail : indique si une notification par e-mail doit être envoyée à l’utilisateur ou à l’utilisatrice.
Boîte de dialogue
- Chemin de la boîte de dialogue : chemin d’accès au nœud de la boîte de dialogue que vous créez (comme avec Étape de participant de la boîte de dialogue).

Étape du participant dynamique - Développement du programme de sélection des participants

Vous créez le programme de sélection des participants. Par conséquent, vous pouvez utiliser n’importe quel critère ou logique de sélection. Par exemple, votre programme de sélection des participants peut sélectionner l’utilisateur ou l’utilisatrice (au sein d’un groupe) qui a le moins d’éléments de travail. Vous pouvez créer un nombre illimité de programmes de sélection des participants à utiliser avec différentes instances de l’Étape du participant dynamique dans vos modèles de workflow.

Créez un service OSGi ou un ECMAScript qui sélectionne les utilisateurs auxquels affecter l’élément de travail.

ECMAscript

Les scripts doivent intégrer une fonction nommée getParticipant qui renvoie un ID utilisateur comme valeur de String. Stockez vos scripts personnalisés, par exemple, dans le dossier /apps/myapp/workflow/scripts ou dans un sous-dossier.

Un exemple de script est inclus dans une instance AEM standard :

/libs/workflow/scripts/initiator-participant-chooser.ecma

CAUTION
Vous ne devez rien modifier dans le chemin /libs.
Cela est dû au fait que le contenu de /libs sera écrasé la prochaine fois que vous mettrez à niveau votre instance (et éventuellement lors de l’application d’un correctif ou d’un pack de fonctionnalités).

Ce script choisit l’initiateur de workflow en tant que participant :
function getParticipant() { return workItem.getWorkflow().getInitiator(); }
NOTE
Le composant Programme de sélection des participants de l’initiateur de workflow étend l’étape de participant dynamique et utilise ce script comme mise en œuvre de l’étape.
Service OSGi

Les services doivent mettre en œuvre l’interface com.day.cq.workflow.exec.ParticipantStepChooser. L’interface définit les membres suivants :
- Le champ SERVICE_PROPERTY_LABEL : utilisez-le pour spécifier le nom du programme de sélection des participants. Le nom s’affiche dans la liste des programmes de sélection des participants disponibles dans les propriétés d’Étape de participant dynamique.
- La méthode getParticipant renvoie l’ID du principal de sécurité résolu dynamiquement en tant que valeur de String.
CAUTION
La méthode getParticipant renvoie l’ID de principal de sécurité résolu dynamiquement. Cet ID peut être un ID de groupe ou un ID utilisateur.
Cependant, un ID de groupe ne peut être utilisé que pour une étape du participant lorsqu’une liste de participants est renvoyée. Pour une étape du participant dynamique, une liste vide est renvoyée et elle ne peut pas être utilisée pour la délégation.

Pour rendre votre implémentation disponible pour les composants d’étape du participant dynamique, ajoutez votre classe Java™ à un lot OSGi qui exporte le service et déployez le lot vers le serveur AEM.

NOTE
Le programme de sélection aléatoire des participants est un exemple de service qui sélectionne un utilisateur aléatoire (com.day.cq.workflow.impl.process.RandomParticipantChooser). L’exemple de composant d’étape Sélection aléatoire de participant étend l’étape du participant dynamique et utilise ce service comme implémentation de l’étape.

Étape du participant dynamique – Exemple de service de sélection de participant

La classe Java™ suivante met en œuvre l’interface ParticipantStepChooser. La classe renvoie le nom du participant qui a initié le workflow. Le code utilise la même logique que l’exemple de script (initiator-participant-chooser.ecma).

L’annotation @Property définit la valeur du champ SERVICE_PROPERTY_LABEL sur Workflow Initiator Participant Chooser.

package com.adobe.example;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Properties;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;
import org.osgi.framework.Constants;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.adobe.granite.workflow.WorkflowException;
import com.adobe.granite.workflow.WorkflowSession;
import com.adobe.granite.workflow.exec.ParticipantStepChooser;
import com.adobe.granite.workflow.exec.WorkItem;
import com.adobe.granite.workflow.metadata.MetaDataMap;

@Component
@Service
@Properties({
        @Property(name = Constants.SERVICE_DESCRIPTION, value = "An example implementation of a dynamic participant chooser."),
        @Property(name = ParticipantStepChooser.SERVICE_PROPERTY_LABEL, value = "Workflow Initiator Participant Chooser (service)") })
public class InitiatorParticipantChooser implements ParticipantStepChooser {

 private Logger logger = LoggerFactory.getLogger(this.getClass());

 public String getParticipant(WorkItem arg0, WorkflowSession arg1,
   MetaDataMap arg2) throws WorkflowException {

  String initiator = arg0.getWorkflow().getInitiator();
  logger.info("Assigning Dynamic Participant Step work item to {}",initiator);

  return initiator;
 }
}

Dans la boîte de dialogue des propriétés d’Étape de participant dynamique, la liste Programme de sélection des participants inclut l’élément Workflow Initiator Participant Chooser (script), qui représente ce service.

Lorsque le modèle de workflow est démarré, le journal indique l’ID de l’utilisateur qui a initié le workflow et qui se voit attribuer l’élément de travail. Dans cet exemple, l’utilisateur admin a lancé le workflow.

13.09.2015 15:48:53.037 *INFO* [10.176.129.223 [1347565733037] POST /etc/workflow/instances HTTP/1.1] com.adobe.example.InitiatorParticipantChooser Assigning Dynamic Participant Step work item to admin

Étape du participant au formulaire

L’étape de participant du formulaire présente un formulaire lorsque l’élément de travail est ouvert. Lorsque les utilisateurs remplissent et envoient le formulaire, les données de champ sont stockées dans les nœuds de la payload du workflow.

Pour configurer l’étape, vous spécifiez le groupe, l’utilisateur ou l’utilisatrice auquel affecter l’élément de travail et le chemin d’accès au formulaire.

CAUTION

Cette section traite de la section Formulaires des composants de base pour la création de pages.

Étape du participant au formulaire – Configuration

Pour configurer l’étape, modifiez et utilisez les onglets suivants :

Commun
Utilisateur/Groupe
Formulaire
- Chemin du formulaire : chemin du formulaire que vous créez.

Étape du participant au formulaire – Création du formulaire

Créez un formulaire à utiliser avec une étape de participant du formulaire de façon normale. Toutefois, les formulaires d’une étape du participant au formulaire doivent présenter les configurations suivantes :

Le composant Début de formulaire doit avoir la propriété Type d’action définie sur Edit Workflow Controlled Resource(s).
Le composant Début de formulaire doit présenter une valeur pour la propriété Form Identifier.
Les composants de formulaire doivent présenter la propriété Nom de l’élément définie sur le chemin du nœud dans lequel les données de champs sont stockées. Le chemin doit pouvoir localiser un nœud dans le contenu de la charge utile du workflow. La valeur utilise le format suivant :

./jcr:content/path_to_node
Le formulaire doit inclure un composant Bouton d’envoi du workflow. Vous ne configurez aucune propriété du composant.

Les exigences de votre workflow déterminent où stocker les données de champ. Par exemple, les données de champ peuvent être utilisées pour configurer les propriétés du contenu de la page. La valeur suivante d’une propriété Nom de l’élément stocke les données de champs comme valeur de la propriété redirectTarget du nœud jcr:content :

./jcr:content/redirectTarget

Dans l’exemple suivant, les données de champs sont utilisées en tant que contenu d’un composant Texte sur la page du payload :

./jcr:content/par/text_3/text

Le premier exemple peut être utilisé pour toute page dont le rendu est effectué par le composant cq:Page. Le second exemple peut uniquement être utilisé lorsque la page du payload inclut un composant Texte possédant l’ID text_3.

Le formulaire peut se trouver n’importe où dans le référentiel, mais les utilisateurs et utilisatrices du workflow doivent être autorisé(e)s à lire le formulaire.

Programme de sélection aléatoire des participants

L’étape Programme de sélection aléatoire des participants est un programme de sélection des participants qui attribue l’élément de travail généré à un utilisateur qui est choisi de manière aléatoire à partir d’une liste.

wf-31

Programme de sélection aléatoire des participants - Configuration

Pour configurer l’étape, modifiez et utilisez les onglets suivants :

Commun
Arguments
- Participants : indique la liste des utilisateurs et utilisatrices pouvant être sélectionné(e)s. Pour ajouter un utilisateur ou une utilisatrice à la liste, cliquez sur Ajouter un élément et saisissez le chemin d’accueil du nœud utilisateur ou l’ID utilisateur. L’ordre des utilisateurs et utilisatrices n’affecte pas la probabilité d’être affecté à une tâche.

Programme de sélection des participants à l’initiateur de workflow

L’étape du programme de sélection des participants à l’initiateur de workflow est un programme de sélection des participants qui affecte la tâche générée à l’utilisateur ou utilisatrice qui a lancé le workflow. Il n’existe aucune autre propriété à configurer, à part les propriétés courantes.

Programme de sélection des participants à l’initiateur de workflow - Configuration

Pour configurer l’étape, effectuez les modifications à l’aide des onglets suivants :

Commun

Étape du processus

Une étape du processus exécute un ECMAScript ou appelle un service OSGi pour effectuer un traitement automatique.

wf-32

Étape du processus - Configuration

Pour configurer l’étape, modifiez et utilisez les onglets suivants :

Commun
Processus
- Processus : implémentation du processus à exécuter. Utilisez le menu déroulant pour sélectionner ECMAScript ou Service OSGi. Pour obtenir des informations sur :
  - Pour les ECMAScripts standard et les services OSGi, voir Processus intégrés pour les étapes du processus.
  - Concernant la création de ECMAScripts pour une étape de processus, voir Implémentation d’une étape de processus avec un ECMAScript.
  - Concernant la création de services OSGi pour une étape de processus, voir Implémentation d’une étape de processus avec une classe Java™.
- Avance du gestionnaire : sélectionnez cette option pour avancer automatiquement le workflow à l’étape suivante après l’exécution. Si cette option n’est pas sélectionnée, le script de mise en œuvre doit gérer l’avancement du workflow.
- Arguments : arguments à transmettre au processus.

Définition d’une variable

Vous pouvez utiliser l’étape « Définir une variable » pour définir la valeur d’une variable et l’ordre de définition des valeurs. La variable est définie dans l’ordre dans lequel les mappages de variables sont répertoriés à l’étape Définir une variable.

Ajout d’un mappage pour définir une variable

Définition d’une variable - Configuration

Pour configurer l’étape, modifiez et utilisez les onglets suivants :

Commun
Mappage
- Sélectionner la variable : utilisez cette option pour sélectionner une variable afin de définir sa valeur.
- Sélectionner un mode de mappage : pour définir la valeur de la variable, sélectionnez un mode de mappage. En fonction du type de données de la variable, vous pouvez définir la valeur d’une variable à l’aide de l’une des options suivantes :
  - Littéral : utilisez cette option lorsque vous connaissez la valeur exacte à spécifier.
  - Expression : utilisez l’option lorsque la valeur à utiliser est calculée en fonction d’une expression. L’expression est créée dans l’éditeur d’expressions fourni.
  - Notation de point JSON : l’option permet d’extraire une valeur d’une variable de type JSON ou FDM.
  - XPATH : l’option permet d’extraire une valeur d’une variable de type XML.
  - Relatif à la charge : utilisez l’option lorsque la valeur à enregistrer dans la variable est disponible à un chemin d’accès relatif à la charge utile.
  - Chemin d’accès absolu : utilisez l’option lorsque la valeur à enregistrer dans la variable est disponible à un chemin d’accès absolu.
- Spécifier la valeur : pour mapper la variable, spécifiez une valeur. La valeur que vous indiquez dans ce champ dépend du mode de mappage.
- Ajouter un mappage : utilisez cette option pour ajouter d’autres mappages afin de définir une valeur pour la variable.

recommendation-more-help