Ejecutar trabajo

UiPath.Activities.System.Jobs.RunJob

Descripción

Utiliza la actividad Ejecutar trabajo para iniciar fácilmente otras automatizaciones como flujos de trabajo RPA o procesos de agente. Esta actividad única consolida las actividades existentes que inician automatizaciones desde tu flujo de trabajo. Puedes seleccionar el tipo de proyecto que deseas iniciar y la actividad adaptará su comportamiento en función de tu selección.

Importante:

• La automatización seleccionada debe existir en tu carpeta de Orchestrator antes de configurar esta actividad. Esto no se aplica cuando se utiliza un recurso de solución.
• Después de actualizar una automatización, asegúrate de volver a publicarla y de volver a implementar el proceso correspondiente en la carpeta de Orchestrator.

Compatibilidad de proyectos

Windows | Multiplataforma

Windows, configuración multiplataforma

• Propiedades del cuerpo de la actividad:

  • Ruta de la carpeta de Orchestrator : la carpeta de Orchestrator donde se implementa la automatización que quieres iniciar. Solo las carpetas a las que puedes acceder se muestran en el menú desplegable. La disponibilidad de esta propiedad depende del contexto:
    • Fuera de una solución : la propiedad está siempre disponible. Si no seleccionas una carpeta, se utiliza tu espacio de trabajo personal.
    • Dentro de una solución, Nombre del proceso establecido en un recurso de solución : la propiedad es visible pero de solo lectura y no se tiene en cuenta.
    • Dentro de una solución, Nombre del proceso establecido en una variable : la propiedad está disponible para que selecciones la carpeta de destino de Orchestrator.
  • Nombre del proceso : selecciona el proceso asociado a la automatización que quieres ejecutar. Se muestran todos los tipos de procesos: RPA, agentes, orquestación agéntica. Si el proceso que necesitas no aparece en la lista, selecciona Gestionar procesos para ser redirigido a tu carpeta en Orchestrator, donde puedes añadir el proceso que falta.
  • Argumentos de entrada : configura los argumentos para pasar al proceso seleccionado. Hay tres modos de entrada disponibles a través del icono junto a la propiedad:

    • Usar esquema (predeterminado): importa automáticamente el esquema de argumentos del proceso y genera un tipo de datos personalizado que se puede editar con el asignador de datos. La propiedad Argumentos de salida se muestra por separado. Para recuperar la última lista de argumentos de proceso, selecciona Actualizar a la derecha de la propiedad.

      Importante:

      Para obtener la mejor experiencia, asegúrate de utilizar la última versión de Studio. Las versiones de Studio anteriores a 2025.0.161 utilizan la ventana Editor de expresiones . El siguiente fragmento de código te muestra cómo proporcionar valores a los argumentos de entrada del agente utilizando VB.NET y C#:

      'VB.NET
      New Email_Rewriter_Input() With {
      .feedback = "sample feedback",
      .originalEmail = "sample email content"
      }
      

      //C#
      new Email_Rewriter_Input {
      feedback = "sample feedback",
      originalEmail = "sample email content"
      }
      

    • Usar argumentos : un widget de argumentos en el que cada entrada tiene un nombre, un valor y una dirección (dentro/fuera). Tanto los argumentos de entrada como los de salida se configuran aquí. La propiedad Argumentos de salida está oculta en este modo: los valores de salida se reciben a través de entradas con Dirección establecida en Salida.

    • Usar objeto : acepta cualquier variable u expresión de objeto como entrada, que se serializa en JSON en tiempo de ejecución y se pasa al proceso. Las cadenas JSON se pasan tal cual. La propiedad Argumentos de salida aún se muestra por separado.

• Panel de propiedades:

  • Modo de ejecución : selecciona cómo espera la actividad a que se complete el trabajo. Las siguientes opciones están disponibles:
    • No esperar : la actividad inicia el trabajo y permite que el flujo de trabajo continúe sin esperar a que se complete el trabajo.
    • Esperar a que finalice el trabajo : opción predeterminada. La actividad detiene el flujo de trabajo hasta que finaliza el trabajo iniciado o se alcanza el tiempo de espera. Si la finalización del trabajo se realiza correctamente, la actividad devuelve las salidas y se reanuda el flujo de trabajo.
      Nota:

      Este modo de ejecución utiliza la capacidad de Orchestrator SignalR para reconocer la finalización del trabajo en tiempo real. Se puede habilitar en la configuración de Orchestrator en el nivel de tenant. Si SignalR está deshabilitado, este modo de ejecución se establecerá de forma predeterminada en un sondeo de 30 segundos.

    • Suspender la ejecución hasta la finalización del trabajo : la actividad detiene el flujo de trabajo y espera la salida con persistencia.
  • Tiempo de espera : establece el tiempo máximo de espera para completar el trabajo. El valor predeterminado es 600 000 milisegundos (10 minutos).
  • Continuar en caso de error : 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 no está configurado 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.
  • Fallar cuando el trabajo falla : esta propiedad solo está disponible cuando el modo de ejecución es Esperar a que finalice el trabajo o Suspender la ejecución hasta que finalice el trabajo. Especifica si la actividad debe lanzar una excepción cuando el trabajo de Orchestrator ejecutado se completa con un estado Defectuoso . El valor predeterminado es Desactivado. Establécelo en Activado para lanzar una excepción y detener la ejecución del flujo de trabajo cuando el trabajo de Orchestrator falle.
  • Datos del trabajo : muestra el objeto del trabajo iniciado. Generado automáticamente.
  • Argumentos de salida : muestra los argumentos de salida devueltos por el proceso al finalizar. Esta propiedad solo se muestra cuando se utiliza el modo de entrada Utilizar esquema o Utilizar objeto . Cuando se utiliza el modo Usar argumentos , los argumentos de salida se capturan a través de entradas con Dirección establecida en Salida en el widget Argumentos. Si seleccionas el proceso de una lista de procesos, el objeto de salida contiene todas las propiedades de salida del proceso seleccionado. Si proporcionas el proceso utilizando una expresión y el proceso devuelve valores, debes configurar los argumentos de entrada y salida utilizando la opción Usar argumentos .

Limitación conocida

Cuando un proceso agéntico lanza una excepción, Maestro mantiene el trabajo de Orchestrator en estado En ejecución , esperando que la excepción se gestione dentro de Maestro.

Como resultado:

• La actividad Ejecutar trabajo no detecta el fallo.
• Cuando se configura para Esperar a que finalice el trabajo, puede:
  • Tiempos de espera, o
  • Se bloquea indefinidamente en modo de persistencia, ya que el trabajo nunca llega a Correcto.

Para evitar este comportamiento, utiliza las siguientes recomendaciones basadas en el modo de ejecución de la actividad Ejecutar trabajo :

• Para Esperar a que finalice el trabajo, aplica un Tiempo de espera que coincida con la duración prevista del Proceso agéntico. Sin él, el flujo de trabajo permanece atascado, esperando un cambio de estado del trabajo que nunca ocurre.
• Utiliza Suspender la ejecución hasta la finalización del trabajo, ya que este modo funciona mejor cuando tu flujo de trabajo necesita recibir salidas. El proceso se reanuda automáticamente cuando se completa el proceso agéntico.