Gestionar trabajos

Iniciar un trabajo

Antes de seguir los pasos a continuación, debes crear un proceso.

1. Ve a Automatizaciones > Trabajos en la carpeta en la que reside el proceso.
2. Haz clic en Iniciar. Se mostrará la ventana Iniciar trabajo.
3. En el menú desplegable Nombre del proceso, selecciona un proceso que se haya implementado previamente en la carpeta actual.
4. Configura los campos necesarios tal como se describe en las siguientes secciones.
5. Haz clic en Iniciar. La ventana Iniciar trabajo se cierra y, si hay tiempos de ejecución disponibles en la carpeta actualmente activa, la tarea se iniciará en un Robot según la configuración que hayas establecido. El Estado de la tarea se muestra en tiempo real en la página Trabajos.

Establecer la prioridad del trabajo

En el menú desplegable Prioridad de tareas, selecciona la prioridad de la tarea que se ejecutará si quieres que sea diferente de la prioridad establecida en el nivel de proceso. Este campo se rellena automáticamente con la prioridad heredada del paquete.

Seleccionar el runtime de ejecución

Desde el menú desplegable Tipo de runtime, selecciona el tipo de runtime utilizado para ejecutar el trabajo.

El número de tiempos de ejecución disponibles y conectados se muestra debajo del menú desplegable.

• _ Disponible: el número de tiempos de ejecución disponibles, calculado como el número total de tiempos de ejecución menos el número de trabajos en ejecución.

• _ Conectado: el número total de tiempos de ejecución, calculado como la suma de los tiempos de ejecución en todas las máquinas conectadas a Orchestrator que está asociado a la carpeta activa.

  Tipo de runtime	Descripción
  Producción (desatendida)	El trabajo se ejecuta en modo desatendido consumiendo un tiempo de ejecución Unattended.
  Pruebas	El trabajo se ejecuta en modo desatendido consumiendo un tiempo de ejecución de Pruebas.
  No producción	El trabajo se ejecuta en modo desatendido consumiendo un tiempo de ejecución NonProduction.
  Cloud - Serverless Testing	El trabajo se ejecuta en modo desatendido, en una máquina robot sin servidor que se configuró para ejecutarse en un entorno de prueba. La cantidad de unidades de robot necesarias es específica de los entornos de prueba y depende del tamaño de la máquina robotizada sin servidor y los minutos que tarda en ejecutarse. Consulta Unidades de robots - Consumo para obtener más información.
  Cloud - Serverless	El trabajo se ejecuta en modo unattended, en una máquina del robot sin servidor, configurada para ejecutarse en un entorno de producción. La cantidad de robot units necesaria es específica al entorno de producción, y depende del tamaño de la máquina del robot sin servidor y del número de minutos que tarde en ejecutar un trabajo. Consulta Unidades de robots - Consumo para obtener más información.
  Cloud - VM Testing	El trabajo se ejecuta en modo desatendido, en una máquina virtual en la nube que se configuró para ejecutarse en un entorno de prueba o no productivo. La ejecución de la máquina virtual consume las unidades de robot para los entornos de prueba. Consulta Unidades de robots - Consumo para obtener más información.
  Cloud - VM	El trabajo se ejecuta en modo unattended, en una Cloud VM configurada para ejecutarse en un entorno de producción. La ejecución de la máquina virtual consume las robot units para entornos de producción. Consulta Unidades de robots - Consumo para obtener más información.

Ejemplo: digamos que tienes 2 tiempos de ejecución de no producción y 1 tiempo de ejecución Desatendido en la plantilla de máquina A, y 3 tiempos de ejecución de NonProduction y 2 tiempos de ejecución Desatendidos en la plantilla de máquina B. Ambos están asociados a una carpeta. En cada plantilla, conectas una máquina de host. El estado del tiempo de ejecución resultante es el siguiente:

• Desatendido: 3 Available, 3 Connected
• NonProduction: 5 Available, 5 Connected

Un trabajo en ejecución que ocupa un tiempo de ejecución resta 1 al número de tiempos de ejecución disponibles para ese tipo.

Nota:

En tiempo de publicación, Orchestrator elige entre los tiempos de ejecución del espacio de trabajo personal disponibles para ejecutar el trabajo. La precedencia de tiempos de ejecución es la siguiente:

• Producción (desatendida)
• No producción

Por ejemplo, si no existe un tiempo de ejecución de Production, Orchestrator utiliza un tiempo de ejecución de NonProduction disponible. Si no existe ninguno, fallará el trabajo.

Si el runtime seleccionado deja de estar disponible entre ejecuciones de trabajo, la próxima ejecución de trabajo falla, ya que Orchestrator no busca la siguiente disponible.

Configura el destino de ejecución

Configura tu objetivo de ejecución estableciendo las siguientes opciones como desees en la pestaña Objetivo de ejecución .

Asignar dinámicamente

La asignación dinámica sin ninguna selección de cuenta y máquina te permite ejecutar un proceso en primer plano varias veces con la cuenta y la máquina que estén disponibles primero. Los procesos en segundo plano se ejecutan en cualquier cuenta, independientemente de si esta está ocupada o no, siempre y cuando tengas tiempos de ejecución suficientes.

Con esta opción se puede ejecutar un proceso hasta 10 000 veces en un solo trabajo.

Cuenta

Puedes elegir uno de estos enfoques:

• Especificar una cuenta significa que el proceso se ejecuta bajo esa cuenta específica de usuario o robot.
• Especificar tanto la cuenta como la máquina significa que el trabajo se lanza en ese mismo par cuenta-máquina. Solo se pueden seleccionar los pares cuenta-máquina válidos.
• Si no se especifica ninguna cuenta, Orchestrator asignará la cuenta de forma dinámica.

Máquina

Puedes elegir uno de estos enfoques:

• Especificar un objeto de la máquina significa que el proceso se ejecuta en una de las máquinas host adjuntas a la plantilla de la máquina seleccionada. Selecciona una máquina anfitriona específica del grupo de máquinas anfitrionas conectadas en el campo Máquinas conectadas.
• Especificar tanto la cuenta como la máquina significa que el trabajo se lanza en ese mismo par cuenta-máquina. Solo se pueden seleccionar los pares cuenta-máquina válidos.
• Si no se especifica ninguna máquina, Orchestrator asigna la máquina host de forma dinámica.

Asegúrate de que los tiempos de ejecución que coinciden con el tipo de trabajo se asignan a la plantilla de máquina asociada. Solo se muestran las máquinas del host conectadas asociadas a la carpeta activa.

Selecciona una asignación de cuenta-máquina válida

Elige qué par cuenta-máquina específico ejecutará el trabajo.

Puedes hacer clic en Agregar asignación de cuenta-máquina si deseas que tu trabajo se ejecute en varios de estos pares. Al hacerlo, se crea un trabajo Pendiente para cada par de cuenta-máquina.

Nota: Esto solo funciona si se selecciona la opción Habilitar asignación de usuario-máquina en la pestaña General de tu configuración de tenant.

Mantener la asignación de cuenta/máquina en la reanudación del trabajo

Este campo permite configurar si los diferentes fragmentos de un trabajo de larga duración se ejecutan en el mismo par cuenta-máquina.

Por defecto, un trabajo suspendido lo reanuda cualquier Robot disponible en cualquier máquina disponible.

En función de tus requisitos de licencia o recursos, tienes la opción de reanudar un trabajo en la misma máquina y en el mismo contexto de cuenta que inició el trabajo.

Digamos que necesitas una licencia SAP para ejecutar un trabajo. En lugar de instalar una licencia SAP en cada máquina disponible (lo que aumenta los costes), se puede instalar en una sola máquina y utilizarla para iniciar y reanudar el trabajo. La misma estrategia puede aplicarse a las licencias de usuario. Puedes asignar una sola licencia de usuario y utilizarla para ejecutar el trabajo.

Programar la finalización de la ejecución del trabajo

En ocasiones, la ejecución del proceso puede ser defectuosa, provocando que el trabajo permanezca en estado pendiente. Activar la alternancia te permite (haz clic para ampliar):

• Selecciona Detener en el menú desplegable: esto intenta detener la ejecución de forma correcta una vez transcurrido el intervalo de tiempo definido desde que el trabajo se encuentra en estado pendiente (establece el tiempo en un mínimo de 1 minuto y un máximo de 10 días, 23 horas y 59 minutos).
  
  

  

  
  
• Selecciona Cancelar en el menú desplegable: esto intenta detener la ejecución de forma correcta una vez transcurrido el intervalo de tiempo definido desde que el trabajo se encuentra en estado pendiente (establece el tiempo en un mínimo de 1 minuto y un máximo de 10 días, 23 horas y 59 minutos).
  
  

  

  
  
• Selecciona Detener en el menú desplegable y habilita la opción Programar «cancelación» automática, si el trabajo no se detiene: esto intenta terminar la ejecución correctamente después de que haya pasado el intervalo de tiempo definido desde que el trabajo se encuentra en estado pendiente. Luego intenta terminarlo de forma forzada una vez pasado el intervalo de tiempo definido desde que el trabajo está atascado en un estado deteniendo (establece el tiempo en un mínimo de 1 minuto y un máximo de 10 días, 23 horas y 59 minutos).
  
  

  

  
  

Generar una alerta si el trabajo está atascado en pendiente

Al activar la alternancia, se activan las alertas sobre los trabajos que permanecen en el estado pendiente o reanudado más tiempo que la duración especificada.

La duración configurable es como mínimo de un minuto y como máximo de once días.

Si el trabajo supera la duración configurada, una ventana emergente de alerta de gravedad de «Error» te informa con el texto siguiente:

"N trabajos para el #proceso {process_number} han estado pendientes o se han reanudado durante más de X horas e Y minutos.", donde:

• N: es el número de trabajos que desencadenaron la alerta
• {process_number}: el identificador del proceso

• X: el número de horas configurado que el trabajo ha excedido mientras mostraba un estado pendiente o reanudado. Los días se convierten a horas.

• Y: el número de minutos configurado que superó el trabajo con el estado pendiente o reanudado.

Genere una alerta si el trabajo comenzó y no se ha completado

Al activar la alternancia, se activan alertas sobre trabajos que no se completan en la duración especificada.

La duración configurable es como mínimo de un minuto y como máximo de once días.

Si el trabajo supera la duración configurada, una ventana emergente de alerta de gravedad de «Error» te informa con el texto siguiente:

"El trabajo para el n.º de proceso {process_number} se ha ejecutado durante más de X horas e Y minutos", donde:

• {process_number}: el identificador del proceso

• X: el número de horas configurado que el trabajo ha excedido mientras intentaba completarse. Los días se convierten a horas.

• Y es el número de minutos configurado que ha superado el trabajo al intentar completarse.

Orchestrator impide que se inicien trabajos con configuraciones no válidas. Si se intenta iniciar un trabajo con una configuración no válida, aparecerá un mensaje de error descriptivo que te indicará cómo ajustar la configuración.

Iniciar un trabajo utilizando asignación dinámica es decir, no se ha especificado ninguna máquina o cuenta, con una configuración de carpetas incompatibles da lugar a un error. Asegúrate de corregir la configuración, de lo contrario, los trabajos quedan pendientes indefinidamente. Por ejemplo, intentar ejecutar un trabajo en segundo plano de .NET Framework 4.6.1 cuando solo hay plantillas multiplataforma en la carpeta no funciona, ya que los trabajos quedan pendientes hasta que se arregla la configuración.

Adición de argumentos

En la pestaña Argumentos, proporciona argumentos de entrada para el proceso seleccionado. Esta pestaña se rellena automáticamente con todos los argumentos de entrada aceptados por el proceso seleccionado, y los valores correspondientes heredados del paquete.

Iniciar un trabajo mediante un desencadenador API

Puedes iniciar un trabajo a través de un desencadenador de API desde la aplicación de terceros que prefieras. Sigue los siguientes pasos:

1. Crea un desencadenador de API basado en el proceso que deseas ejecutar. Esto genera la URL necesaria para iniciar el trabajo. Para ello, sigue las instrucciones del tema Crear un desencadenador de API.
2. Crea un token de acceso personal dedicado y concédele acceso a los recursos necesarios. Esto se realiza a nivel de organización, desde la página Preferencias > Token de acceso personal. Una vez guardado, asegúrate de copiar el token de acceso personal en el momento, ya que no volverá a aparecer.
3. Pega el token de acceso personal en el campo de token al portador para autorizar tu solicitud.
4. Obtén la URL del trabajo haciendo clic en la opción Copiar la URL completa de Slug situada junto al tenant deseado en la lista de desencadenadores y, a continuación, pégala en tu herramienta.
5. Configura tus argumentos según sea necesario.

   Puedes introducir argumentos como los siguientes:

   Parámetros de la cadena de consulta

   En trabajos con hw-process de Slug y con los argumentos files y folders, el cURL que puedes utilizar en la línea de comandos tendrá el siguiente aspecto:

   curl --location --request POST 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process?argument1=files&argument2=folders' \
   --header 'Cookie: __cf_bm=_5E_r3oulk6zLCr6.CUij.RFN4lCeTgYMR31gradWtI-1697542233-0-AdP+xhO+SE5PQ6wnoEum5qRu4wzUgGgOrezRhHrR4dcVvhsvl9yV/V3KAFhi/TmomqMtmxc426WT83lDMoL1seQ='

   Datos del formulario

   En trabajos con hw-process de Slug y con los argumentos files y folders, el cURL que puedes utilizar en la línea de comandos tendrá el siguiente aspecto:

   curl --location 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process' \
   --header 'Cookie: __cf_bm=_5E_r3oulk6zLCr6.CUij.RFN4lCeTgYMR31gradWtI-1697542233-0-AdP+xhO+SE5PQ6wnoEum5qRu4wzUgGgOrezRhHrR4dcVvhsvl9yV/V3KAFhi/TmomqMtmxc426WT83lDMoL1seQ=' \
   --form 'argument1="files"' \
   --form 'argument2="folders"'

   Texto del cuerpo JSON

   En trabajos con hw-process de Slug y con los argumentos files y folders, el cURL que puedes utilizar en la línea de comandos tendrá el siguiente aspecto:

   curl --location 'https://cloud.uipath.com/{organizationName}/{tenantName}/orchestrator_/t/6ea73196-ca89-446c-81e1-5279bdd36dc2/hw-process' \
   --header 'Content-Type: application/json' \
   --data '{
       "argument1" : "files",
       "argument2" : "folders"
   }
   '

   Los argumentos también pueden introducirse mediante una combinación de los métodos mencionados.

6. Ejecuta el trabajo.

   En función del modo de llamada que hayas seleccionado en la definición del desencadenador, el trabajo se ejecutará del siguiente modo:

   • Sondeo asíncrono

   • Enviar y olvidar asíncrono

   • Sincronización (sondeo largo)

   Ten en cuenta que el modo de llamada puede anularse en la cadena de consulta o en el cuerpo utilizando el parámetro $callMode.

   Para obtener más detalles sobre estas opciones, consulta la sección Explicación de los modos de llamada.

Limitación de tasa

El número de solicitudes que se pueden realizar al punto final de estado está limitado a 10 por cada 10 segundos para cada trabajo iniciado.

Límite de trabajos pendientes

El número máximo de trabajos pendientes iniciados a través de desencadenadores de API es 100. Esto puede cambiarse utilizando el parámetro Desencadenadores - Desencadenadores de API - Límite máximo de trabajos pendientes, que tiene un valor por defecto de 10.

Detener un trabajo

Haz clic en el botón Más acciones correspondiente y, a continuación, en Detener. El proyecto de automatización se ejecuta hasta que encuentra un la actividad Debe detenerse. Durante este tiempo, el trabajo está Detenido. Si se encuentra la actividad, se detiene la ejecución y el estado final del trabajo es Exitoso. Si no se encuentra una actividad Debe detenerse, la ejecución del trabajo no se detiene hasta que llega al final del proyecto. En este caso, el estado final también es Exitoso.

Nota:

• Los trabajos iniciados desde Orchestrator solo pueden detenerse desde Orchestrator.
• Un trabajo iniciado desde el Assistant puede detenerse tanto en Orchestrator, desde la página Trabajos, como utilizando el Assistant UiPath®.
• Una vez que se ha detenido un trabajo, se pierden las programaciones de finalización del trabajo y es necesario volver a configurar las opciones de Programar la finalización de la ejecución del trabajo al reiniciarlo.

Reanudar una tarea

Haz clic en el botón Más acciones correspondiente y, a continuación, en Reanudar.

Cancelar un trabajo

Haz clic en el botón Más acciones y luego en Eliminar. El proyecto de automatización se detiene a la fuerza, el trabajo se marca como detenidoy se muestra "Trabajo cancelado" en la ventana de detalles del trabajo.

Nota:

• Un trabajo iniciado desde Orchestrator puede cancelarse tanto en Orchestrator, en la página Trabajos, como con UiPath Assistant.
• Los trabajos iniciados desde Assistant pueden cancelarse tanto en Orchestrator, en la página Trabajos, como con UiPath Assistant.
• Una vez eliminado un trabajo, se pierden las programaciones de finalización del trabajo y es necesario volver a configurar las opciones de Programar la finalización de la ejecución del trabajo al reiniciarlo.

Reiniciar una tarea

Esta característica te permite ejecutar una tarea rápidamente desde la lista de tareas, sin pasar del flujo de trabajo configuración. Puedes reiniciar cualquier tarea con un estado final: Detenida, Fallida o Éxito.

Nota:

• No se pueden reiniciar trabajos activados por agentes como UiPath Assistant o a través de sesiones de depuración remota de Studio.
• Al reiniciar un trabajo que tenía activas las opciones de Programar la finalización de la ejecución del trabajo, es necesario volver a reconfigurarlas.

Este procedimiento parte de la presunción de que previamente iniciaste una tarea que ya ha alcanzado un estado final.

1. Haz clic en el botón Más acciones correspondiente y, a continuación, en Reiniciar. Se mostrará la ventana Iniciar tarea con la configuración inicial de la tarea.
2. Realiza los cambios deseados.
3. Haz clic en Iniciar. La ventana Iniciar trabajos se cierra y se inicia la ejecución. El estado de cada trabajo se muestra en tiempo real en la página Trabajos.

Ver detalles del trabajo

Nota:

• Mientras el panel lateral está abierto, puedes hacer clic en cualquier trabajo de la lista para mostrar sus detalles particulares, para todas las pestañas incluidas en el panel. La cuadrícula de la lista de trabajos se puede desplazar horizontalmente, mientras que la columna Proceso permanece fija si es necesario para el tamaño y la resolución de tu pantalla. Ten en cuenta que puedes aumentar el tamaño de algunas columnas, lo que hará que se muestre una barra de desplazamiento para facilitar el acceso.

• Puedes hacer clic en el icono de expansión en la esquina superior derecha de cualquier pestaña para abrirla como una ventana de tamaño completo, con el nombre del proceso subyacente en las rutas de navegación. El botón Contraer en la misma esquina devuelve la ventana a su estado de panel lateral.

• Los detalles del trabajo no incluyen consideraciones de licencia para trabajos que fallan. Utiliza la funcionalidad de supervisión para obtener más información sobre las licencias.

Para ver los detalles sobre un trabajo específico, haz clic en el botón Detalles correspondiente. Esto muestra un panel lateral que incluye la sección Detalles del trabajo, que te proporciona información variada, como:

• el nombre del proceso subyacente
• el robot y la máquina en ejecución
• las razones del fallo en los trabajos
• razones por las que el trabajo no se inicia
• acciones que puedes tomar para solucionar cualquier incidencia y desencadenar el inicio del trabajo

Detalles del trabajo completado

Detalles del trabajo pendiente

En el contexto de un tenant de SAP, puedes utilizar el botón Volver a SAP para volver al proceso en SAP Build Process Automation.

Ver registros del trabajo

Para ver los registros de un trabajo específico, haz clic en el botón Detalles correspondiente. Esto muestra un panel lateral que incluye la sección Registros, con datos relativos al trabajo seleccionado.

Nota: Los registros generados para los trabajos iniciados a través de sesiones de depuración remotas no están disponibles en la página Registros de trabajo. Se encuentran en la página Registros globales.

Ver condiciones de reanudación del trabajo

Para ver los desencadenadores necesarios para la reanudación de un trabajo suspendido, haz clic en el botón Detalles correspondiente. Esto muestra un panel lateral que incluye la pestaña Reanudar condiciones, con detalles sobre las tareas de flujo de trabajo configuradas para el trabajo seleccionado.

Puedes hacer clic en la lista para acceder a los desencadenadores de los demás trabajos.

Ver la línea de tiempo del vídeo

Para ver una grabación de vídeo de una ejecución de trabajo, junto con los registros subyacentes, haz clic en el botón Detalles correspondiente. Esto muestra un panel lateral que incluye la pestaña Línea de tiempo del vídeo, con un panel de vídeo en la parte superior y una lista de registros en la parte inferior.

También puedes acceder a esta pestaña haciendo clic en Abrir grabación en la pestaña Registros del mismo panel.

Para obtener más información, consulta los temas dedicados a la grabación de vídeo.

Descargar medios de ejecución

Para descargar la grabación de un trabajo fallido, haz clic en Más opciones > Descargar grabación.Los medios de ejecución se descargan según tu configuración.