Invocar Processo

UiPath.Core.Activities.InvokeProcess

Description

Executa um processo do UiPath que está disponível para a máquina local. Pode ser usado para executar pacotes locais, bem como processos no Orchestrator, se uma conexão estiver disponível.

Para obter mais informações sobre como encontrar a lista de processos disponíveis em uma máquina, acesse aqui

A atividade Invoke Process é executada no modo Síncrono, o que significa que o processo pai aguarda o processo filho ser concluído antes de retomar a execução.

Os logs gerados pelos processos filho contêm apenas o resultado da execução e erros e são gravados no mesmo lugar que os do pai. Eles podem ser diferenciados pelo campo ProcessName nos logs locais e pela Process coluna no Orchestrator.

Ao usar a atividade Invoke Process , mesmo que o projeto contenha vários processos, um único trabalho é criado para executá-los, em oposição à atividade Run Parallel Process , que cria trabalhos separados para cada processo no projeto.

Se houver vários processos adicionados, a versão ativa na pasta atual é a que será usada.

Observação:

• Dados não serializáveis não podem ser passados entre fluxos de trabalho (por exemplo, NavegadorDaUI, ElementoDaUI etc.).

Se um processo filho for invocado mas não for localizado, um erro é registrado contendo o nome do processo filho, o caminho em que o Robô buscou e detalhes adicionais como WindowsIdentity e machineName.

Observação: ao usar uma versão do UiPath.System.Activities superior à versão 20.4, a atividade Invoke Process é compatível com vários pontos de entrada. Se um fluxo de trabalho for criado com esta versão e, em seguida, o pacote UiPath.System.Activities sofrer downgrade para uma versão mais antiga que só é compatível com um único ponto de entrada, as atividades Invoke Process no fluxo de trabalho sofrerão erros de validação e deverão ser manualmente substituídas para funcionar.

Observação: esta atividade é compatível apenas com o Studio versão 19.6 ou superior.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows, configuração multiplataforma

• CaminhoDaPasta — o caminho da pasta do Orchestrator em que o processo especificado está localizado, caso seja diferente da pasta em que o processo está sendo executado. Esse campo é compatível apenas com valores string, com / como separador para indicar subpastas. Por exemplo, "Finance/Accounts Payable".
  Observação: o parâmetro Folder Path não funciona para processos executados por robôs em pastas clássicas. Apenas robôs em pastas modernas têm a capacidade de passar dados para fora de sua pasta.
• Nome do processo — o nome do processo que você deseja executar. Este campo é compatível apenas com strings e variáveis String. O Nome do processo deve conter o nome do Pacote, pois ele está sendo usado pelo Robô.

Opções avançadas

• 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 é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.
• Tempo limite — especifica a quantidade de tempo (em milissegundos) para aguardar que a atividade seja executada antes de gerar um erro. Deixar esta propriedade vazia ocasiona uma espera por tempo infinito antes de gerar uma exceção. Por padrão, essa propriedade fica vazia.
• Entrada de registro — especifica o tipo de informação a ser registrada automaticamente ao entrar no recurso invocado.
• Saída de registro — especifica o tipo de informação a ser automaticamente registrada ao sair do recurso invocado.
• Nível — especifica o nível de log aplicado às mensagens geradas pelas opções LogEntry e LogExit.
• Caminho do ponto de entrada — o caminho do arquivo de fluxo de trabalho que é executado no início do processo, relativo à raiz do pacote. Se deixado vazio, o ponto de entrada padrão é Main.xaml. Este campo é compatível apenas com strings e variáveis String.

• Sessão de destino — especifica a sessão em que o processo filho é iniciado:

  • Atual — o processo filho é aberto na mesma sessão que o processo pai.
  • Padrão do processo — o processo filho usa as Configurações do Processo.
  • Principal — o processo filho é iniciado na sessão principal, independentemente de onde o processo pai for executado.
  • Picture in Picture — o processo filho é iniciado na sessão Picture in Picture, independentemente de onde o processo pai for executado

Windows - Configuração legada

Painel de Propriedades

Comum

• 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 é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  Observação: se essa atividade estiver incluída na atividade Try Catch e o valor da propriedade ContinuarComErro for True, nenhum erro será capturado quando o projeto for executado.
• NomeDeExibição - o nome de exibição da atividade.

• Tempo limite (milissegundos) — especifica a quantidade de tempo (em milissegundos) para aguardar que a atividade seja executada antes de gerar um erro. Deixar esta propriedade vazia ocasiona uma espera por tempo infinito antes de gerar uma exceção. Por padrão, essa propriedade fica vazia.

  Observação: ao usar robôs 2021.10 e anteriores, as exceções de negócios não são suportadas em um fluxo de trabalho isolado, todas as exceções retornam como exceções do sistema.

Entrada

• Argumentos — uma lista de argumentos IN que podem ser passados para o processo que você deseja executar do Orchestrator. Se um argumento tiver um tipo desconhecido, ele será convertido para JSON.
• VariávelDeArgumentos — as variáveis de argumento transmitidas para o processo invocado.
• Nome do processo — o nome do processo que você deseja executar. Este campo é compatível apenas com strings e variáveis String. O Nome do processo deve conter o nome do Pacote, pois ele está sendo usado pelo Robô.

Registro

• Entrada de registro — especifica o tipo de informação a ser registrada automaticamente ao entrar no recurso invocado.
• Saída de registro — especifica o tipo de informação a ser automaticamente registrada ao sair do recurso invocado.
• NívelDeRegistro — especifica o nível de registro em log aplicado às mensagens geradas pelas opções EntradaDeRegistro e SaídaDeRegistro.

Diversos

• Ponto de entrada — o caminho do arquivo de fluxo de trabalho que é executado no início do processo, relativo à raiz do pacote. Se deixado vazio, o ponto de entrada padrão é Main.xaml. Este campo é compatível apenas com strings e variáveis String.
• CaminhoDaPasta — o caminho da pasta do Orchestrator em que o processo especificado está localizado, caso seja diferente da pasta em que o processo está sendo executado. Esse campo é compatível apenas com valores string, com / como separador para indicar subpastas. Por exemplo, "Finance/Accounts Payable".
  Observação: o parâmetro Folder Path não funciona para processos executados por robôs em pastas clássicas. Apenas robôs em pastas modernas têm a capacidade de passar dados para fora de sua pasta.
• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

• Sessão de destino — especifica a sessão em que o processo filho é iniciado:

  • Atual — o processo filho é aberto na mesma sessão que o processo pai.
  • Padrão do processo — o processo filho usa as Configurações do Processo.
  • Principal — o processo filho é iniciado na sessão principal, independentemente de onde o processo pai for executado.
  • Picture in Picture — o processo filho é iniciado na sessão Picture in Picture, independentemente de onde o processo pai for executado
• Pacote de uso — indica se o processo deve ser identificado pelo nome do seu pacote (opção selecionada) ou nome do processo (opção não selecionada). Por padrão, essa opção fica desmarcada.