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 qué tipo de proyecto quieres iniciar, y la actividad adapta 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.

• 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 : selecciona la carpeta de Orchestrator donde se implementa la automatización desde la que deseas iniciar dentro de tu flujo de trabajo. Solo las carpetas a las que puedes acceder se muestran en el menú desplegable. Si no seleccionas una opción, se utiliza tu espacio de trabajo personal.
  • Nombre del proceso : selecciona el proceso asociado a la automatización que deseas 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 : si el proceso seleccionado requiere argumentos de entrada, puedes configurarlos utilizando este campo.

    Para recuperar la lista más reciente de argumentos de proceso cuando utilizas la opción Asignador de datos , selecciona Actualizar argumentos en la parte derecha del campo.

    Importante:

    Para obtener la mejor experiencia, asegúrate de utilizar la última versión de Studio (2025.0.161). 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"
    }

• 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 SignalR de Orchestrator 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 como Activado para lanzar una excepción y la ejecución del flujo de trabajo se detiene cuando el trabajo de Orchestrator falla.

  • Datos del trabajo : muestra el objeto del trabajo iniciado. Generado automáticamente.

  • Argumentos de salida:muestra la lista de argumentos de salida para el proceso, tal y como se definieron durante la creación del proceso.

    Si seleccionas el proceso de una lista de procesos, el objeto de salida contiene todas las propiedades de salida del proceso seleccionado.

    Si proporcionaste el proceso utilizando una expresión, o si tu modo de ejecución devuelve valores, debes configurar los argumentos de entrada y salida utilizando la opción Usar nombres estáticos .

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.