Executar Trabalho

UiPath.Activities.System.Jobs.RunJob

Description

Use a atividade Run Job para iniciar facilmente outras automações, como fluxos de trabalho de RPA ou processos de agentes. Essa atividade única consolida as atividades existentes que iniciam automações a partir do seu fluxo de trabalho. É possível selecionar que tipo de projeto você deseja iniciar e a atividade adapta seu comportamento com base na sua seleção.

Importante:

• A automação selecionada deve existir na sua pasta do Orchestrator antes da configuração desta atividade.

• Após atualizar uma automação, certifique-se de republicá-la e reimplantar o processo correspondente na pasta do Orchestrator.

Compatibilidade do projeto

Windows | Multiplataforma

Windows, configuração multiplataforma

• Propriedades do corpo da atividade:
  • Caminho da pasta do Orchestrator— Selecione a pasta do Orchestrator onde a automação que você deseja iniciar a partir do seu fluxo de trabalho está implantada. No menu suspenso, serão exibidas apenas as pastas que você pode acessar. Se você não selecionar uma opção, seu Espaço de trabalho pessoal será usado.
  • Nome do processo— Selecione o processo associado à automação que você deseja executar. Todos os tipos de processos são exibidos: RPA, agentes, orquestração por agentes. Se o processo que você precisa não estiver listado, selecione Gerenciar processos a serem redirecionados para sua pasta no Orchestrator, onde você pode adicionar o processo ausente.

  • Argumentos de entrada— Se o processo selecionado exigir argumentos de entrada, você pode configurá-los usando este campo.

    Para recuperar a lista mais recente de argumentos do processo ao usar a opção Mapeador de dados , selecione Atualizar argumentos no lado direito do campo.

    Importante:

    Para uma melhor experiência, certifique-se de usar a versão mais recente do Studio (2025.0.161). Versões do Studio anteriores à 2025.0.161 usam a janela Editor de Expressão .

    O fragmento de código a seguir mostra como fornecer valores para os argumentos de entrada do agente usando VB.NET e 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"
    }

• Painel de propriedades:
  • Modo de execução —Selecione como a atividade aguarda a conclusão do trabalho. As seguintes opções estão disponíveis:
    • Não aguardar —a atividade inicia o trabalho e permite que o fluxo de trabalho continue sem esperar a conclusão do trabalho.
    • Aguarde a conclusão do trabalho —opção padrão. A atividade pausa o fluxo de trabalho até que o trabalho iniciado seja concluído ou o tempo limite seja atingido. Se a conclusão do trabalho for bem-sucedida, a atividade retornará as saídas e o fluxo de trabalho será retomado.
      Observação: esse modo de execução utiliza a capacidade do Orchestrator SignalR para reconhecer a conclusão do trabalho em tempo real. Ela pode ser habilitada nas Configurações do Orchestrator no nível do tenant. Se o SignalR estiver desabilitado, este modo de execução assumirá como padrão a pesquisa de 30 segundos.
    • Suspender a execução até a conclusão do trabalho —a atividade pausa o fluxo de trabalho e aguarda a saída com persistência.
  • Tempo limite— Define o tempo máximo de espera pela conclusão do trabalho. O valor padrão é 600.000 milissegundos (10 minutos).
  • Continuar com erro— Especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (true, false). O valor padrão é falso. Como resultado, se o campo não estiver configurado e ocorrer um erro, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  • Falha quando o trabalho falha —essa propriedade fica disponível apenas quando o modo de execução é Aguardar conclusão do trabalho ou Suspender a execução até a conclusão do trabalho.

    Especifica se a atividade deve gerar uma exceção quando o trabalho do Orchestrator executado for concluído com um status Com falha . O valor padrão é Off. Defina como Ativado para gerar uma exceção; a execução do fluxo de trabalho será interrompida quando o trabalho do Orchestrator falhar.

  • Dados do trabalho— Exibe o objeto do trabalho iniciado. Gerado automaticamente.

  • Argumentos de saída—Exibe a lista de argumentos de saída para o processo, conforme definidos durante a criação do processo.

    Se você selecionar o processo em uma lista de processos, o objeto de saída conterá todas as propriedades de saída do processo selecionado.

    Se você forneceu o processo usando uma expressão ou se seu modo de execução retorna valores, você deve configurar os argumentos de entrada e saída usando a opção Usar nomes estáticos .

Limitação conhecida

Quando um Processo com Agente gera uma exceção, o Maestro mantém o trabalho do Orchestrator em um estado Em execução , esperando que a exceção seja tratada dentro do Maestro.

Como resultado:

• A atividade Run Job não detecta a falha.
• Quando configurado como Aguardar a conclusão do trabalho, será:
  • Tempo esgotado, ou
  • Trava indefinidamente no modo de persistência, já que o trabalho nunca chega a ser bem-sucedido.

Para evitar esse comportamento, use as seguintes recomendações com base no modo de execução da atividade Run Job :

• Para Aguardar conclusão do trabalho, aplique um Tempo limite que corresponda à duração esperada do Processo com agente. Sem ele, o fluxo de trabalho permanece preso, esperando por uma alteração de status de trabalho que nunca ocorre.
• Use Suspender a execução até a conclusão do trabalho, pois esse modo funciona melhor quando seu fluxo de trabalho precisa receber saídas. O processo retoma automaticamente quando o processo com agente é concluído.