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 Invoke Process et des activités d'interaction non-utilisateur, en orchestrant des tâches manuelles avec des tâches Robot. Il s'exécute dans la session 0, garantissant ainsi une exécution rapide. Notez que le débogage d'un processus d'orchestration s'effectue dans une session utilisateur.

Les workflows de longue durée peuvent orchestrer :

Des processus d'arrière-plan qui peuvent contenir des activités effectuant des appels d'API et s'exécutant dans la Session 0. Vous pouvez les invoquer à l'aide de l'activité Invoke Process.
IU : processus avec des activités d'interaction utilisateur appelé via l'option Démarrer l'exécution (Start Job) depuis une activité d'Orchestrator, et s'exécutant dans une session utilisateur.
Intervention humaine : l'utilisateur interagit via des tâches qui nécessitent le remplissage de formulaires Orchestrator. Cela implique le couplage de l'activité Create Form Task avec Wait for Form Task and Resume.

Modèle de processus d'orchestration

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

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

Le paramètre requiresUserInteraction: false indique que le workflow ne contient pas d'activités d'interaction utilisateur, à la manière d'un Processus d'arrière-plan (Background Process).

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) :

Utilisez l'activité Add Queue Item and Get Reference pour ajouter un élément de file d'attente avec les paramètres in, in/out ou out et obtenir l'objet d'élément de file d'attente correspondant. Lorsque l'élément de file d'attente est traité, les arguments fournis dans la propriété ItemInformation sont affectés de nouveau aux variables de flux de travail mappées si cette activité est associée à Wait for Queue Item and Resume.
L'activité Wait for Queue Item and Resume doit être couplée avec l'activité Add Queue Item and Get Reference. Le workflow entre dans l'état suspendu, libérant ainsi le Robot au niveau de cette activité lors d'une fin d'élément de file d'attente spécifique avant de passer à l'étape suivante du processus.
L'activité Start Job and Get Reference appelle 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 vers les variables de flux de travail si cette activité est associée à l'activité Wait for Job and Resume.
L'activité Wait for Job and Resume doit être associée à Start Job and Get Reference en fournissant le Job Object fourni en sortie de cette dernière activité. Cela suspend temporairement le processus en cours et attend la fin du travail de référence, reprenant le processus une fois que le travail de référence met à jour l'état pour se terminer.
Utilisez l'activité Create Form Task pour créer une tâche avec visualisation basée sur formulaire pour les interactions humaines dans un workflow. Ces formulaires contenant le contexte de workflow pertinent sont présentés aux utilisateurs pour la prise de décisions et autres scénarios. Pour activer le concepteur de formulaires dans cette activité, vous devez installer le paquet UiPath.FormActivityLibrary.

Remarque : lors de l'utilisation d'une version de Studio commençant par 2021.4 avec des versions UiPath.Persistence.Activities et UiPath.FormActivityLibrary antérieures à 1.2.1, la fenêtre du Concepteur de formulaires ne conserve pas le focus et vous pouvez interagir avec Studio lorsque la fenêtre du concepteur est ouverte. Pour éviter ce problème, assurez-vous de mettre à jour les packages vers la dernière version.
L'activité Wait for Form Task and Resume doit être couplée avec Create Form Task en fournissant Task Object comme entrée pour suspendre le workflow jusqu'à ce que l'utilisateur final termine cette tâche spécifique.
Utilisez l'activité Resume After Delay pour suspendre l'exécution du workflow et le reprendre à une date et heure spécifiées.
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é.

Alternativement, essayez d’utiliser des boucles avec des activités de persistance, par exemple, l'activité Parallèle pour chaque. Veuillez noter que par défaut, le nombre maximum de déclencheurs de reprise par tâche est limité à 1 000.
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 le cadre d'une activité de longue durée doivent être sérialisables. Les types de variables répertoriés dans cette page sont sérialisables : Texte, Vrai ou Faux, Nombre, Tableau, Date et heure. Table de données (Data Table) et Variables 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ées non sérialisables peuvent être utilisés dans des étendues de séquence distinctes dans le même workflow ou en appelant d'autres fichiers, tant qu'ils se trouvent entre les activités Wait et Resume, par exemple Wait for Job and Resume, Wait for Queue Item and Resume et Wait for Form Task and Resume.
Veuillez noter que certaines propriétés des objets générés par des activités de longue durée ne peuvent pas être évaluées dans le panneau Variables locales.
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.

Remarque : 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).