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 : el título de la acción que quieres crear. Este campo solo admite cadenas y variables String .
Prioridad de tarea: te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium . Están disponibles las siguientes opciones: TaskPriority.Low, TaskPriority.Medium, TaskPriority.H High, TaskPriority.Crítica.
TaskCatalog : una clasificación empresarial opcional de elementos de tareas. Este campo solo admite cadenas y variables String .
TaskData : una colección de datos empresariales, en el formulario Dictionary<String,Argument>, que quieres almacenar en una acción determinada. La modificación de los argumentos Out y In/Out los asigna de nuevo al flujo de trabajo después de que se complete la acción. Este campo solo admite objetos Dictionary<String,Argument> .
ObjetoDeTarea (salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto ExternalTaskData después de crear las Actions . Este objeto se puede pasar a la actividad Esperar tarea externa y reanudar para suspender la ejecución del flujo de trabajo hasta que se completen las Actions .

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 Boolean (Verdadero, Falso). El valor predeterminado es Falso. Por lo tanto, si el campo está vacío y se produce un error, se detiene la ejecución del proyecto. Si el valor es Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Nota: si se incluye esta actividad en Intentar capturar y el valor de la propiedad ContinuarEnCasoDeError es Verdadero, no se detectará error cuando el proyecto se ejecute.

NombreParaMostrar: el nombre de la actividad para ser mostrado.
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

Etiqueta externa : una etiqueta que se puede utilizar para identificar el sistema externo que es el origen de los datos de una acción determinada. Este campo solo admite cadenas y variables String .
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: Para permitir el etiquetado de acciones automáticas a través de actividades de Persistencia, la cuenta del robot que ejecuta el flujo de trabajo necesita permisos Ver, Creary Eliminar en etiquetas.

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 solo debe utilizarse 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 : una clasificación empresarial opcional de elementos de tareas. Este campo solo admite cadenas y variables String .

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 : una colección de datos empresariales, en el formulario Dictionary<String,Argument>, que quieres almacenar en una acción determinada. La modificación de los argumentos Out y In/Out los asigna de nuevo al flujo de trabajo después de que se complete la acción. Este campo solo admite objetos Dictionary<String,Argument> .
Prioridad de tarea: te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium . Están disponibles las siguientes opciones: TaskPriority.Low, TaskPriority.Medium, TaskPriority.H High, TaskPriority.Crítica.
TaskTitle : 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

ObjetoDeTarea (salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto ExternalTaskData después de crear las Actions . Este objeto se puede pasar a la actividad Esperar tarea externa y reanudar para suspender la ejecución del flujo de trabajo hasta que se completen las Actions .

Configuración multiplataforma

TaskTitle : el título de la acción que quieres crear. Este campo solo admite cadenas y variables String .
Prioridad de tarea: te permite seleccionar el nivel de prioridad de la acción. De forma predeterminada, esta propiedad está establecida en TaskPriority.Medium . Están disponibles las siguientes opciones: TaskPriority.Low, TaskPriority.Medium, TaskPriority.H High, TaskPriority.Crítica.
TaskCatalog : una clasificación empresarial opcional de elementos de tareas. Este campo solo admite cadenas y variables String .

TaskData : una colección de datos empresariales, en el formulario Dictionary<String,Argument>, que quieres almacenar en una acción determinada. La modificación de los argumentos Out y In/Out los asigna de nuevo al flujo de trabajo después de que se complete la acción. Este campo solo admite objetos Dictionary<String,Argument> .
ObjetoDeTarea (salida) : el objeto de la tarea que se devuelve desde Orchestrator como un objeto ExternalTaskData después de crear las Actions . Este objeto se puede pasar a la actividad Esperar tarea externa y reanudar para suspender la ejecución del flujo de trabajo hasta que se completen las Actions .

Opciones avanzadas

Común

ContinuarEnCasoDeError: especifica si la automatización debe continuar incluso cuando la actividad arroja un error. Este campo solo admite valores Boolean (Verdadero, Falso). El valor predeterminado es Falso. Por lo tanto, si el campo está vacío y se produce un error, se detiene la ejecución del proyecto. Si el valor es Verdadero, la ejecución del proyecto continúa independientemente de cualquier error.

Nota: si se incluye esta actividad en Intentar capturar y el valor de la propiedad ContinuarEnCasoDeError es Verdadero, no se detectará error cuando el proyecto se ejecute.

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.

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 .

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

Crear acciones externas

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

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 lotes de tareas externas que quieres recuperar de un sistema de terceros. Puede utilizar esta etiqueta para sincronizar tareas externas con un sistema externo. Además, puede usar esta etiqueta para completar tareas según las acciones que realiza un usuario en el sistema de terceros.
Crear acción externa mediante 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.

Crear un objeto dentro de un sistema externo, como por ejemplo:
- Crea una incidencia en Jira.
- Crea un contacto en Salesforce.
Llame 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 tarea y el ID de unidad de organización (el ID de la carpeta de Orchestrator): GET /tasks/GenericTasks/GetTaskDataById. Puede utilizar los detalles recuperados para crear una tarea similar en un sistema de terceros.

Las siguientes capturas de pantalla muestran los parámetros y las 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

Llame a la siguiente API para completar una tarea externa, utilizando el ID de tarea y el ID de unidad de organización (el ID de la carpeta de Orchestrator): POST /tasks/GenericTasks/CompleteTask.

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