Create External Task

UiPath.Persistence.Activities.ExternalTask.CreateExternalTask

Description

Crée une action externe avec les données, le titre de la tâche, la priorité de la tâche et le catalogue de tâches donnés.

Compatibilité du projet

Windows - Héritage | Windows | Multiplate-forme

Windows, Windows - Configuration héritée

Module Designer

• TitreTâche : le titre de l'action que vous souhaitez créer. Ce champ ne prend en charge que les chaînes et les variables String .
• PrioritéTâche : permet de sélectionner le niveau de priorité de l'action. Par défaut, cette propriété est définie sur TaskPriority.Medium Les options suivantes sont disponibles : TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critique.
• TaskCatalog - An optional business classification of task items. This field supports strings and String variables only.
• TaskData - A collection of business data, in the form Dictionary<String,Argument>, that you want to store in a given action. Modifying Out and In/Out arguments maps them back to the workflow after the action is completed. This field supports Dictionary<String,Argument> objects only.
• ObjetTâche(Sortie) : l'objet de tâche renvoyé par Orchestrator en tant qu'objet ExternalTaskData après la création de l'action. Cet objet peut être transmis à l'activité Wait for External Task and Resume afin de suspendre l'exécution du workflow jusqu'à ce que l'action soit terminée.

Panneau propriétés

Commun

• ContinuerSurErreur (ContinueOnError) : spécifie si l’automatisation doit se poursuivre même lorsque l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (Vrai (True), Faux (False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l’exécution du projet se poursuit même en cas d’erreur.

Remarque :

Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

• NomAffichage (DisplayName) - Nom affiché de l'activité.
• TimeoutMS - Spécifie la durée (en millisecondes) d'attente d'exécution de l'activité avant la génération d'un message d'erreur. La valeur par défaut est 30 000 millisecondes (30 secondes).

Entrée

• External Tag - A tag that can be used to identify the external system which is the source for the data in the given action. This field supports strings and String variables only.
• Libellés : le robot ajoute les libellés saisis à l'action, ce qui permet un filtrage futur. Ce champ prend uniquement en charge les valeurs de chaîne et comporte des restrictions d'affectation de noms.

Remarque :

Pour permettre la labellisation automatique des actions via les activités de Persistance, le compte Robot exécutant le workflow a besoin des autorisations Consultation, Création et Supprimer par rapport aux balises.

• Chemin d'accès au dossier Orchestrator : le chemin d'accès à un dossier Orchestrator différent de celui dans lequel fonctionne le processus actuel, où vous souhaitez créer la tâche. Pour en savoir plus sur les dossiers Orchestrator, rendez-vous ici. Pour les dossiers classiques , cette propriété ne peut être utilisée qu'avec des Robots flottants et uniquement si l'utilisateur actuel dispose des privilèges de tâche corrects dans le dossier cible. Le remplacement du chemin d'accès au dossier n'est pas pris en charge pour les dossiers modernes. Ce champ ne prend en charge que les chaînes et les variables String .

Remarque :

La propriété CheminDossier doit être utilisée uniquement si la tâche doit être créée ou interrogée à partir d'un dossier différent de celui en cours. Si l'utilisateur effectuant cette action ne dispose pas des autorisations requises pour le dossier cible, la création de la tâche échoue et génère une erreur critique. Vous pouvez afficher plus d'informations sur les autorisations de dossier ici.

• TaskCatalog - An optional business classification of task items. This field supports strings and String variables only.

Remarque :

Assurez-vous que le catalogue d'actions existe avant la création de l'action. Sinon, la création de l'action échoue avec le message d'erreur suivant : « Aucun catalogue de tâches n'existe avec le nom [action_catalog_name] Code d'erreur : 2451 ».

• TaskData - A collection of business data, in the form Dictionary<String,Argument>, that you want to store in a given action. Modifying Out and In/Out arguments maps them back to the workflow after the action is completed. This field supports Dictionary<String,Argument> objects only.
• PrioritéTâche : permet de sélectionner le niveau de priorité de l'action. Par défaut, cette propriété est définie sur TaskPriority.Medium Les options suivantes sont disponibles : TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critique.
• TitreTâche : le titre de l'action que vous souhaitez créer. Ce champ ne prend en charge que les chaînes et les variables String .

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).

Sortie

• ObjetTâche(Sortie) : l'objet de tâche renvoyé par Orchestrator en tant qu'objet ExternalTaskData après la création de l'action. Cet objet peut être transmis à l'activité Wait for External Task and Resume afin de suspendre l'exécution du workflow jusqu'à ce que l'action soit terminée.

Configuration multiplateforme

• TitreTâche : le titre de l'action que vous souhaitez créer. Ce champ ne prend en charge que les chaînes et les variables String .
• PrioritéTâche : permet de sélectionner le niveau de priorité de l'action. Par défaut, cette propriété est définie sur TaskPriority.Medium Les options suivantes sont disponibles : TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critique.
• TaskCatalog - An optional business classification of task items. This field supports strings and String variables only.

Remarque :

Assurez-vous que le catalogue d'actions existe avant la création de l'action. Sinon, la création de l'action échoue avec le message d'erreur suivant : « Aucun catalogue de tâches n'existe avec le nom [action_catalog_name] Code d'erreur : 2451 ».

• TaskData - A collection of business data, in the form Dictionary<String,Argument>, that you want to store in a given action. Modifying Out and In/Out arguments maps them back to the workflow after the action is completed. This field supports Dictionary<String,Argument> objects only.
• ObjetTâche(Sortie) : l'objet de tâche renvoyé par Orchestrator en tant qu'objet ExternalTaskData après la création de l'action. Cet objet peut être transmis à l'activité Wait for External Task and Resume afin de suspendre l'exécution du workflow jusqu'à ce que l'action soit terminée.

Options avancées

Commun

• ContinuerSurErreur (ContinueOnError) : spécifie si l’automatisation doit se poursuivre même lorsque l’activité génère une erreur. Ce champ prend uniquement en charge les valeurs booléennes (Vrai (True), Faux (False). La valeur par défaut est False. Par conséquent, si le champ est vide et qu’une erreur est générée, l’exécution du projet s’arrête. Si le champ indique au contraire True, l’exécution du projet se poursuit même en cas d’erreur.

Remarque :

Si cette activité est incluse dans Tenter de capturer (Try Catch) et que la valeur de la propriété Poursuite sur erreur (ContinueOnError) est True, aucune erreur n'est détectée lors de l'exécution du projet.

• TimeoutMS - Spécifie la durée (en millisecondes) d'attente d'exécution de l'activité avant la génération d'un message d'erreur. La valeur par défaut est 30 000 millisecondes (30 secondes).

Entrée

• Libellés : le robot ajoute les libellés saisis à l'action, ce qui permet un filtrage futur. Ce champ prend uniquement en charge les valeurs de chaîne et comporte des restrictions d'affectation de noms.

Remarque :

Pour permettre la labellisation automatique des actions via les activités de Persistance, le compte Robot exécutant le workflow a besoin des autorisations Consultation, Création et Supprimer par rapport aux balises.

• Chemin d'accès au dossier Orchestrator : le chemin d'accès à un dossier Orchestrator différent de celui dans lequel fonctionne le processus actuel, où vous souhaitez créer la tâche. Pour en savoir plus sur les dossiers Orchestrator, rendez-vous ici. Pour les dossiers classiques , cette propriété ne peut être utilisée qu'avec des Robots flottants et uniquement si l'utilisateur actuel dispose des privilèges de tâche corrects dans le dossier cible. Le remplacement du chemin d'accès au dossier n'est pas pris en charge pour les dossiers modernes. Ce champ ne prend en charge que les chaînes et les variables String .

Remarque :

La propriété CheminDossier doit être utilisée uniquement si la tâche doit être créée ou interrogée à partir d'un dossier différent de celui en cours. Si l'utilisateur effectuant cette action ne dispose pas des autorisations requises pour le dossier cible, la création de la tâche échoue et génère une erreur critique. Vous pouvez afficher plus d'informations sur les autorisations de dossier ici.

• Référence : balise que vous pouvez utiliser pour identifier le système externe qui constitue la source des données de l'action donnée. Ce champ ne prend en charge que les chaînes et les variables String .

Création d'actions externes

Pour créer une action externe, choisissez l'une des procédures suivantes :

1. Ajoutez une activité Créer une tâche externe à votre workflow et fournissez des informations pour les champs de propriété suivants :
   • Titre de la tâche
   • Priorité de la tâche
   • Données de tâche (collection)
   • Balise externe : spécifiez une balise pour identifier de façon unique les lots de tâches externes que vous souhaitez récupérer à partir d'un système tiers. Vous pouvez utiliser cette balise pour synchroniser des tâches externes avec un système externe. Vous pouvez également utiliser cette balise pour effectuer des tâches en fonction des actions qu'un utilisateur effectue dans le système tiers.
2. Créez une action externe à l’aide d’API.

Synchronisation des actions externes avec des outils tiers

Pour synchroniser les actions externes avec d'autres systèmes externes, vous devez d'abord créer un objet correspondant dans le système externe, puis récupérer la tâche, ou le lot de tâches, créé par le système tiers, à l'aide d'un appel API.

1. Créez un objet à l'intérieur d'un système externe, tel que :
   • Créer un problème dans Jira.
   • Créez un contact dans Salesforce.
2. Appelez l'API suivante dans Swagger : GET /odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders.

Par exemple : GET <ORCH_URL>/odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders?$filter=(Type eq 'ExternalTask') and (IsDeleted eq false) and (ExternalTag eq 'JiraTasks') and (Status ne 'Completed')&$count=true.

Récupération des actions externes

Appelez l'API suivante pour récupérer des informations sur une tâche externe, à l'aide de l' ID de la tâche et de l' ID de l'unité d'organisation (ID du dossier Orchestrator) : GET /tasks/GenericTasks/GetTaskDataById. Vous pouvez utiliser les détails récupérés pour créer une tâche similaire dans un système tiers.

Les captures d'écran ci-dessous affichent les paramètres et les réponses de l'API dans Swagger. Pour accéder à votre locataire dans Swagger, suivez la procédure Accès à votre fichier Swagger .

Terminer les actions externes

Appelez l'API suivante pour effectuer une tâche externe à l'aide de l' ID de tâche et de l' ID d'unité d'organisation (ID du dossier Orchestrator) : POST /tasks/GenericTasks/CompleteTask.

Consultez la procédure Terminer la tâche externe du guide de l’API Orchestrator pour plus de détails.

Exemple de workflow

Pour obtenir un exemple ou une référence future, consultez l' exemple de projet