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

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.
• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  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 :

  To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• 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.

• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.

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

• TaskTitle - The title of the action you want to create. This field supports strings and String variables only.

• TaskPriority - Enables you to select the priority level of the action. By default, this property is set to TaskPriority.Medium The following options are available: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.

• 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

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.

  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 :

  To allow automatic actions labeling through Persistence activities, the robot account executing the workflow needs View, Create, and Delete permissions on Tags.

• 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.

• Reference - A tag that you can use to identify the external system which is the source for the data in the given action. This field supports strings and String variables only.

Création d'actions externes

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

1. Add a Create External Task activity into your workflow and provide information for the following property fields:
   • Titre de la tâche
   • Priorité de la tâche
   • Données de tâche (collection)
   • External Tag - Specify a tag to uniquely identify batches of external tasks that you want to retrieve from a third-party system. You can use this tag to sync External Tasks with an external system. Also, you can use this tag to complete tasks based on the actions a user takes in the third party system.
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. Call the following API in Swagger: GET /odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders.

For example: 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

Call the following API to retrieve information about an external task, using the Task Id and the Organization Unit Id (the Id of the Orchestrator folder): GET /tasks/GenericTasks/GetTaskDataById. You can use the retrieved details to create a similar task in a third-party system.

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

Call the following API to complete an external task, using the Task Id and the Organization Unit Id (the Id of the Orchestrator folder): 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