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

• TítuloDeLaTarea : el título de la acción que quieres crear. Este campo solo admite cadenas y variables String .
• PrioridadDeLaTarea : te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium Las siguientes opciones están disponibles: 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

• ContinuarEnCasoDeError : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores booleanos (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está vacío y se produce un error, la ejecución del proyecto se detiene. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier 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.
• PrioridadDeLaTarea : te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium Las siguientes opciones están disponibles: TaskPriority.Low, TaskPriority.Medium, TaskPriority.High, TaskPriority.Critical.
• TítuloDeLaTarea : el título de la acción que quieres crear. Este campo solo admite cadenas y variables String .

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

• TítuloDeLaTarea : el título de la acción que quieres crear. Este campo solo admite cadenas y variables String .
• PrioridadDeLaTarea : te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium Las siguientes opciones están disponibles: 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

• ContinuarEnCasoDeError : especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores booleanos (Verdadero, Falso). El valor predeterminado es Falso. Como resultado, si el campo está vacío y se produce un error, la ejecución del proyecto se detiene. Si el valor se establece en Verdadero, la ejecución del proyecto continúa independientemente de cualquier 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í.

• Referencia : una etiqueta que puedes utilizar para identificar el sistema externo que es el origen de los datos en la acción dada. Este campo solo admite cadenas y variables String .

Crear acciones externas

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

1. Añade una actividad Crear tarea externa a tu flujo de trabajo y proporciona información para los siguientes campos de propiedad:
   • Título de tarea
   • Prioridad de tarea
   • Datos de tareas (recopilación)
   • Etiqueta externa : especifica una etiqueta para identificar de forma única los lotes de tareas externas que quieres recuperar de un sistema de terceros. Puedes utilizar esta etiqueta para sincronizar tareas externas con un sistema externo. Además, puedes utilizar esta etiqueta para completar tareas en función de las acciones que realiza un usuario en el sistema de terceros.
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. Llama a la siguiente API en Swagger: GET /odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders.

   Por ejemplo: 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

Llama a la siguiente API para recuperar información sobre una tarea externa, utilizando el ID de la tarea y el ID de la unidad de organización (el ID de la carpeta de Orchestrator): GET /tasks/GenericTasks/GetTaskDataById. Puedes utilizar los detalles recuperados para crear una tarea similar en un sistema de terceros.

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

Llama a la siguiente API para completar una tarea externa, utilizando el ID de la tarea y el ID de la unidad de organización (el ID de la carpeta de Orchestrator): 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