Processus d'orchestration

Les workflows de longue durée sont des projets maîtres qui prennent en charge l'orchestration des services, l'intervention humaine et les transactions de longue durée dans des environnements sans surveillance.

L'intervention humaine entre en jeu lorsque certains processus nécessitent des contributions humaines pour gérer les exceptions, les approbations ou la validation avant de passer à l'étape suivante de l'activité. Dans cette situation, l'exécution du processus est suspendue, libérant les robots jusqu'à la fin de la tâche humaine.

Fragmentation des workflows

Un workflow de longue durée contient UiPath.Persistence.Activities et peut être combiné avec Invoquer le processus et des activités d'interaction non utilisateur, orchestrant les tâches humaines avec les tâches de robot.Il s'exécute dans la session 0, garantissant ainsi une exécution rapide. Veuillez noter que le débogage d'un processus d'orchestration s'effectue dans une session utilisateur.

Les workflows de longue durée peuvent orchestrer :

• Processes d'arrière-plan qui peuvent contenir des activités effectuant des appels d'API et s'exécutant dans la session 0. Ils peuvent être invoqués à l'aide de l'activité Invoquer le processus.
• Interface utilisateur : un processus avec des activités d'interaction utilisateur appelées via Démarrer la tâche depuis l'activité Orchestrator et s'exécutant dans une session utilisateur.
• L'humain dans la boucle : l'utilisateur interagit via des tâches qui nécessitent que des formulaires soient remplis dans Orchestrator. Cela implique l'utilisation de l'activité Créer une tâche de formulaire associée à Attendre la tâche de formulaire et reprendre.

Modèle de processus d'orchestration

Dans Studio, accédez à Accueil > Processus d'orchestration pour ouvrir le modèle qui contient les dépendances par défaut UiPath.Persistence.Activities et UiPath.System.Activities dans un type de workflow Flowchart.

Le fichier project.json du modèle contient le supportsPersistence: true paramètre indiquant que l'exécution du processus reprend à la fin de la tâche.

Le requiresUserInteraction: false paramètre indique que ce workflow ne contient pas d'activités d'interaction utilisateur, comme un processus en arrière-plan.

Il n'est pas recommandé de modifier manuellement les paramètres dans le fichier project.json.

Un processus peut être transformé en processus d’orchestration depuis la fenêtre Paramètres du projet en configurant l'option Prend en charge la persistance sur Oui.

Extraits de code pour les processus d'orchestration

Pour vous aider à commencer, le panneau Extraits de code (Snippets) contient un certain nombre d'extraits de code du workflow que vous pouvez utiliser pour créer un Processus d'orchestration (Orchestration Process).

Création d'un processus d'orchestration

Suivez les étapes ci-dessous pour associer les activités faisant partie du pack UiPath.Persistence.Activities et créer votre propre Processus d'orchestration (Orchestration Process) :

1. Utilisez l'activité Ajouter un élément de file d'attente et Obtenir une référence pour ajouter un élément de file d'attente avec in, in/out ou out des paramètres et obtenir l'objet Élément de file d'attente correspondant. Lorsque l’élément de la file d’attente est traité, les arguments fournis dans la propriété ItemInformation sont réattribués aux variables de workflow mappées si cette activité est associée à l’activité Attendre l’élément de la file d’attente et reprendre.

   

2. L’activité Attendre l’élément de la file d’attente et reprendre doit être associée à l’activité Ajouter un élément de la file d’attente et obtenir une référence.Le workflow entre dans l'état suspendu, libérant le robot à cette activité en attendant l'achèvement d'un élément de la file d'attente spécifique avant de passer à l'étape suivante du processus.

   

3. L'activité Démarrer la tâche et obtenir une référence invoque un autre processus en fournissant des arguments de type in, in/out ou out.Après l'exécution, les arguments modifiés sont ensuite mappés de nouveau aux variables de workflow si cette activité est associée à l'activité Attendre la tâche et reprendre.

   

4. L'activité Attendre la tâche et reprendre doit être associée à Démarrer la tâche et obtenir la référence en fournissant la Job Object donnée comme sortie de cette dernière activité.Cela suspend temporairement le processus actuel et attend que la tâche de référence se termine, reprenant le processus une fois que la tâche de référence a mis à jour son statut de terminé.

   

5. Utilisez l'activité Créer une tâche de formulaire pour créer une tâche avec une visualisation basée sur un formulaire pour les interactions humaines au sein d'un workflow.Ces formulaires avec le contexte de workflow pertinent sont présentés aux utilisateurs pour la prise de décision et d'autres scénarios. Pour activer le concepteur de formulaires dans cette activité, vous devez installer le package UiPath.FormActivityLibrary.

   Remarque :

   Lorsque vous utilisez une version Studio à partir de la version 2021.4 avec les versions de UiPath.Persistence.Activities et UiPath.FormActivityLibrary antérieures à 1.2.1, la fenêtre Concepteur de formulaires (Form Designer) ne maintient pas le ciblage, et vous pouvez interagir avec Studio alors que la fenêtre du concepteur est ouverte. Pour éviter ce problème, assurez-vous de mettre à jour les paquets vers la dernière version.

   

6. L'activité Attendre la tâche de formulaire et reprendre doit être associée à Créer une tâche de formulaire en fournissant Task Object comme entrée pour suspendre le workflow jusqu'à ce que cette tâche particulière soit terminée par l'utilisateur final.

   

7. Utilisez l'activité Reprendre après le délai (Resume After Delay) pour suspendre l'exécution du workflow et le reprendre à une date et une heure spécifiées.

8. Exécutez le workflow à partir de Studio. Chaque fois que le Robot exécute une activité de longue durée, Studio entre dans l'état de lecture seule avec l'option Reprendre (Resume) activée dans le ruban. Pour continuer, effectuez la tâche, l'élément de file d'attente ou l'exécution sous-jacent, puis cliquez sur Reprendre (Resume).

Meilleures pratiques

• Les activités de longue durée (activités Attendre et Reprendre (Wait and Resume)) faisant partie du paquet UiPath.Persistence.Activities ne peuvent être utilisées que dans un point d'entrée de Processus d'orchestration (Orchestration Process), le fichier marqué comme Main.xaml.
• Les composants réutilisables construits à partir d'un processus d'orchestration ne peuvent être référencés que dans un autre processus d'orchestration.
• Si un workflow longue durée est associé au traitement de la file d'attente et que le workflow est dans l'état Suspendu (Suspended), l'élément de la file d'attente restera quand même dans un état En cours (Progress) après 24 heures, et ce jusqu'à ce que le workflow définisse le statut de la transaction sur Reprise (Resume). Les identificateurs d'élément de file d'attente feront partie du contexte de workflow persistant s'ils sont inclus dans la même étendue des activités Attente (Wait) et Reprise (Resume).
• Les points de persistance (activités Wait and Resume) ne doivent pas être utilisés dans le corps d'une activité For Each car ils suspendent le flux de travail après l'exécution de la première itération et ce n'est peut-être pas le comportement souhaité. Vous pouvez également essayer d'utiliser des boucles avec des activités de persistance, par exemple l'activité Parallel For Each (Parallel For Each). Veuillez noter que, par défaut, le nombre maximum de déclencheurs de reprise par tâche est limité à 1 000.
• Les activités Retard (Delay) et Étendue de nouvelle tentative (Retry Scope) ne sont pas prises en charge et ne fonctionnent pas correctement lorsqu'elles sont utilisées dans le workflow principal d'un processus d'orchestration. Dans de tels cas, elles doivent être placées dans une activité Étendue sans persistance (No Persist Scope).
• Les workflows d'exécution longue peuvent être repris dans n’importe quel robot disponible du même type que celui qui a suspendu une tâche (par exemple, unattended ou non-production) faisant partie du même environnement ou dossier, de sorte que les ressources locales requises pour l’exécution doivent également être disponibles après les points de persistance.
• Toutes les variables utilisées dans l'étendue d'une activité de longue durée doivent être sérialisables. Les types de variable répertoriés dans cette page sont sérialisables : Text, Vrai ou Faux, Nombre, Array, Date et heure.Variables Data Table et GenericValue.
• Les variables utilisées dans les étendues qui ne contiennent pas d'activités de longue durée ne sont pas soumises à l'exigence de sérialisation, car le workflow n'est pas suspendu dans leur étendue. Les types de donnée non sérialisables peuvent être utilisés dans des étendues de sequence distinctes dans le même workflow ou en invoquant d’autres fichiers à condition qu’ils se trouvent entre les activités Attendre et Reprendre, telles que Attendre la tâche et reprendre, Attendre l’élément de la file d’attente et reprendre et Attendre la tâche de formulaire et reprendre.
• Prenez en compte que certaines propriétés d'objets générées par des activités de longue durée ne peuvent pas être évaluées dans le panneau Variables locales (Locals).
• Implémenter un lot approprié dans les workflows qui devraient contenir un nombre élevé d’actions par tâche. Veuillez noter qu’il y a une limite par défaut de 1 000 actions (ou autres déclencheurs de tâches) qu’un emploi peut attendre à la fois.