Crear Tarea Externa

UiPath.Persistence.Activities.ExternalTask.CreateExternalTask

Descripción

Crea una acción externa con los datos, el título de la tarea, la prioridad de la tarea y el catálogo de tareas dados.

Compatibilidad de proyectos

Windows - Heredado | Windows | Multiplataforma

Windows, Windows: configuración heredada

Panel del Diseñador

• 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.
• ObjetoDeLaTarea(Salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto ExternalTaskData después de crear la acción. Este objeto puede pasarse a la actividad Esperar tarea externa y reanudar para suspender la ejecución del flujo de trabajo hasta que se complete la acción.

Panel de propiedades

Común

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

  Nota:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

• Nombre para mostrar: el nombre para mostrar de la actividad.

• LímiteDeTiempoEnMilisegundos: especifica la cantidad de tiempo (en milisegundos) que se debe esperar a que se ejecute la actividad antes de mostrar un error. El valor predeterminado es 30000 milisegundos (30 segundos).

Entrada

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

• Etiquetas : el robot añade las etiquetas introducidas a la acción, lo que permite futuros filtrados. Este campo solo admite valores de cadena y tiene restricciones de nombre.

  Nota:

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

• Ruta de la carpeta de Orchestrator : la ruta a una carpeta de Orchestrator diferente a la que opera el proceso actual, donde quieres crear la tarea. Para obtener más información sobre Carpetas de Orchestrator, ve aquí. Para las carpetas clásicas , esta propiedad solo se puede utilizar con robots flotantes y solo si el usuario actual tiene los privilegios de tarea correctos en la carpeta de destino. Para las carpetas modernas , no se admite la anulación de la ruta de la carpeta. Este campo solo admite cadenas y variables String .

  Nota:

  La propiedad RutaDeLaCarpeta debe utilizarse solo si la tarea debe crearse o consultarse desde una carpeta diferente a la actual. Si el usuario que realiza esta acción no tiene los permisos necesarios para la carpeta de destino, la creación de la tarea falla y arroja un error crítico. Puedes ver más información sobre los permisos de carpeta aquí.

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

  Nota:

  Asegúrate de que el catálogo de acciones existe antes de la creación de la acción. De lo contrario, la creación de la acción falla con el siguiente mensaje de error: "No existe ningún catálogo de tareas con el nombre [action_catalog_name] Código de error: 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.

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Salida

• ObjetoDeLaTarea(Salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto ExternalTaskData después de crear la acción. Este objeto puede pasarse a la actividad Esperar tarea externa y reanudar para suspender la ejecución del flujo de trabajo hasta que se complete la acción.

Configuración multiplataforma

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

  Nota:

  Asegúrate de que el catálogo de acciones existe antes de la creación de la acción. De lo contrario, la creación de la acción falla con el siguiente mensaje de error: "No existe ningún catálogo de tareas con el nombre [action_catalog_name] Código de error: 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.

• ObjetoDeLaTarea(Salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto ExternalTaskData después de crear la acción. Este objeto puede pasarse a la actividad Esperar tarea externa y reanudar para suspender la ejecución del flujo de trabajo hasta que se complete la acción.

Opciones avanzadas

Común

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

  Nota:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

• LímiteDeTiempoEnMilisegundos: especifica la cantidad de tiempo (en milisegundos) que se debe esperar a que se ejecute la actividad antes de mostrar un error. El valor predeterminado es 30000 milisegundos (30 segundos).

Entrada

• Etiquetas : el robot añade las etiquetas introducidas a la acción, lo que permite futuros filtrados. Este campo solo admite valores de cadena y tiene restricciones de nombre.

  Nota:

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

• Ruta de la carpeta de Orchestrator : la ruta a una carpeta de Orchestrator diferente a la que opera el proceso actual, donde quieres crear la tarea. Para obtener más información sobre Carpetas de Orchestrator, ve aquí. Para las carpetas clásicas , esta propiedad solo se puede utilizar con robots flotantes y solo si el usuario actual tiene los privilegios de tarea correctos en la carpeta de destino. Para las carpetas modernas , no se admite la anulación de la ruta de la carpeta. Este campo solo admite cadenas y variables String .

  Nota:

  La propiedad RutaDeLaCarpeta debe utilizarse solo si la tarea debe crearse o consultarse desde una carpeta diferente a la actual. Si el usuario que realiza esta acción no tiene los permisos necesarios para la carpeta de destino, la creación de la tarea falla y arroja un error crítico. Puedes ver más información sobre los permisos de carpeta aquí.

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

Crear acciones externas

Para crear una acción externa, elija entre los siguientes procedimientos:

1. Add a Create External Task activity into your workflow and provide information for the following property fields:
   • Título de tarea
   • Prioridad de tarea
   • Datos de tareas (recopilación)
   • 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. Crear acción externa utilizando API.

Sincronizar acciones externas con herramientas de terceros

Para sincronizar acciones externas con otros sistemas externos, debes crear primero un objeto correspondiente dentro del sistema externo y luego recuperar la tarea o el lote de tareas creada por el sistema de terceros mediante una llamada a la API.

1. Crear un objeto dentro de un sistema externo, como por ejemplo:
   • Crea una incidencia en Jira.
   • Crea un contacto en 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.

Recuperar acciones externas

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.

Las siguientes capturas de pantalla muestran los parámetros y respuestas de la API en Swagger. Para acceder a tu tenant dentro de Swagger, sigue el procedimiento Acceder a tu archivo Swagger .

Completar acciones externas

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.

Consulta el procedimiento Completar tarea externa de la guía de la API de Orchestrator para obtener más información.

Ejemplo de flujo de trabajo

Para ver un ejemplo o una referencia futura, consulta el proyecto de ejemplo