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 un filtrado futuro. 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 lacarpeta de Orchestrator : la ruta de una carpeta de Orchestrator diferente a la que opera el proceso actual, donde quieres crear la tarea. Para obtener más información sobre las carpetas de Orchestrator, haz clic aquí. Para las carpetas clásicas , esta propiedad solo se puede usar 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 sustitución de la ruta de la carpeta. Este campo solo admite cadenas y variables String .

Nota: la propiedad RutaDeCarpeta solo debe utilizarse si la tarea debe crearse o consultarse desde una carpeta distinta 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 tareas 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úrese de que el catálogo de acciones exista antes de la creación de la acción. De lo contrario, la creación de acciones fallará 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 .

Nota: Asegúrese de que el catálogo de acciones exista antes de la creación de la acción. De lo contrario, la creación de acciones fallará 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> .
• 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 un filtrado futuro. 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 lacarpeta de Orchestrator : la ruta de una carpeta de Orchestrator diferente a la que opera el proceso actual, donde quieres crear la tarea. Para obtener más información sobre las carpetas de Orchestrator, haz clic aquí. Para las carpetas clásicas , esta propiedad solo se puede usar 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 sustitución de la ruta de la carpeta. Este campo solo admite cadenas y variables String .

Nota: la propiedad RutaDeCarpeta solo debe utilizarse si la tarea debe crearse o consultarse desde una carpeta distinta 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 tareas falla y arroja un error crítico. Puedes ver más información sobre los permisos de carpeta aquí.

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

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 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.
2. Crea Actionsexternas con 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:

   • Crear una incidencia en Jira.
   • Crea un contacto en Salesforce.
2. 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 capturas de pantalla a continuación muestran los parámetros de la API y las respuestas en Swagger. Para acceder a tu tenant dentro de Swagger, sigue el procedimiento Acceder a tu archivo de 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.

Ejemplo de flujo de trabajo

Para ver un ejemplo o referencia en el futuro, consulte el proyecto de muestra