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. Você pode selecionar que tipo de projeto deseja iniciar e a atividade adapta seu comportamento com base em sua seleção.

Importante:

• A automação selecionada deve existir na sua pasta do Orchestrator antes da configuração desta atividade. Isso não se aplica ao usar um recurso da solução.
• 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— A pasta do Orchestrator onde a automação que você deseja iniciar está implantada. No menu suspenso, serão exibidas apenas as pastas que você pode acessar. A disponibilidade dessa propriedade depende do contexto:
    • Fora de uma solução— a propriedade está sempre disponível. Se você não selecionar uma pasta, seu Espaço de trabalho pessoal será usado.
    • Dentro de uma solução, Nome do processo definido para um recurso da solução—A propriedade é visível, mas somente leitura e não é levada em consideração.
    • Dentro de uma solução, nome do processo definido como uma variável— a propriedade está disponível para você selecionar a pasta de destino do Orchestrator.
  • 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— Configure os argumentos para transmiti-los ao processo selecionado. Três modos de entrada estão disponíveis por meio do ícone ao lado da propriedade:

    • Usar esquema (padrão) — importa automaticamente o esquema de argumento do processo e gera um tipo de dados personalizado que é editável com o Mapeador de dados. A propriedade Argumentos de saída é mostrada separadamente. Para recuperar a lista mais recente de argumentos de processo, selecione Atualizar no lado direito da propriedade.

      Importante:

      Para obter a melhor experiência, certifique-se de que esteja usando a versão mais recente do Studio. As 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"
      }
      

    • Usar argumentos— Um widget de Argumentos em que cada entrada tem um Nome, Valor e Direção (In/Out). Os argumentos de entrada e saída são configurados aqui. A propriedade Argumentos de saída está oculta neste modo — os valores de saída são recebidos via entradas com Direção definida como Saída.

    • Usar Objeto— Aceita qualquer expressão de variável ou objeto como entrada, que seja serializada por JSON no runtime e passada para o processo. As strings JSON são passadas como estão. A propriedade Argumentos de saída ainda é mostrada separadamente.

• 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 retorna as saídas e o fluxo de trabalho retoma.
      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 é concluído com um status Com falha . O valor padrão é Desativado. Defina como Ativado para gerar uma exceção e interromper a execução do fluxo de trabalho quando o trabalho do Orchestrator falhar.
  • Dados do trabalho— Exibe o objeto do trabalho iniciado. Gerado automaticamente.
  • Argumentos de saída— Exibe os argumentos de saída retornados pelo processo após a conclusão. Essa propriedade é exibida apenas ao usar o modo de entrada Usar esquema ou Usar objeto . Ao usar o modo Usar argumentos , os argumentos de saída são capturados por meio de entradas com Direção definida como Saída no widget Argumentos. 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ê fornecer o processo usando uma expressão e o processo retornar valores, você deve configurar os argumentos de entrada e saída usando a opção Usar argumentos .

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.