Invocar Processo

UiPath.Core.Activities.InvokeProcess

Description

Executa um processo da 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 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 à v20.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.

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Windows, configuração multiplataforma

• Caminho da pasta do Orchestrator — 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, "Finanças/ContasAPagar".
• Invocar por — especifique se deve invocar o processo pelo nome do processo conforme configurado no Orchestrator ou pelo nome do pacote. Observe que o uso do nome do pacote é compatível, mas está obsoleto.
• Nome do processo/ Nome do pacote — o nome do processo ou pacote que você deseja invocar. O menu suspenso exibe os processos ou pacotes disponíveis na pasta do Orchestrator conectada. Esse campo é compatível apenas com variáveis String ou String. Para gerenciar a lista de processos disponíveis, selecione Gerenciar processos no lado direito do campo.
  Observação:

  Alternar entre as opções Nome do processo e Nome do pacote não atualiza o nome automaticamente. Se o nome do seu processo for diferente do nome do pacote, certifique-se de atualizá-lo corretamente.

• Ponto de entrada — se seu processo tiver vários pontos de entrada, especifique o caminho do arquivo de fluxo de trabalho a ser executado assim que o processo for iniciado. Esse caminho deve ser relativo ao pacote raiz. Por padrão, este campo fica vazio e usa o ponto de entrada configurado no Orchestrator.
• Argumentos - Opção padrão. Abre o dicionário de argumentos, onde é possível ver os argumentos do processo invocado. Você também pode definir uma variável para conter um dicionário de argumentos selecionando Usar uma expressão no lado direito do campo. Isso converte o campo Argumentos em variável Argumentos. Para recuperar a lista mais recente de argumentos de processo, selecione Atualizar argumentos no lado direito do campo. Para abrir a lista de argumentos e editar seus atributos, selecione a caixa de campo Argumentos .
• Variável de argumentos - Ativada pela opção Usar uma expressão do campo Argumentos . É possível usar uma variável predefinida ou criar uma nova usando expressões VB ou solicitando ao Autopilot para gerar uma para você. Use essa variável para manter o dicionário de argumentos para o fluxo de trabalho invocado. Volte para a opção Argumentos selecionando Usar Nomes estáticos no lado direito do campo.

Propriedades adicionais

Comum

• Tempo limite — especifica a quantidade de tempo para aguardar para que o fluxo de trabalho invocado seja executado antes que um erro seja gerado e o fluxo de trabalho seja anulado. Este campo é compatível apenas com variáveis TimeSpan . Por padrão, esse campo fica vazio.
• 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 esta 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.

Execução

• 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

Registro

• Entrada de registro — especifique o tipo de informação a ser registrada automaticamente ao entrar no recurso invocado.
• Saída de registro — especifique 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 pela Entrada de registro e Saída de registro.

Windows - Configuração legada

Painel do Designer

Você pode encontrar as seguintes propriedades no corpo da atividade:

• Nome do pacote — o nome do pacote usado para criar o processo que você deseja invocar. Em projetos Windows - Legado, o robô identifica o processo a ser invocado pelo nome do seu pacote.

• Ponto de entrada — se seu processo tiver vários pontos de entrada, especifique o caminho do arquivo de fluxo de trabalho a ser executado assim que o processo for iniciado. Esse caminho deve ser relativo ao pacote raiz. Por padrão, este campo fica vazio e usa o Main.xaml como ponto de entrada.

• Editar argumentos - Abre a lista de argumentos, onde você pode ver e gerenciar os argumentos do processo invocado.

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:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

• DisplayName - O nome de exibição da atividade.
• Tempo limite — especifica a quantidade de tempo para aguardar para que o fluxo de trabalho invocado seja executado antes que um erro seja gerado e o fluxo de trabalho seja anulado. Este campo é compatível apenas com variáveis TimeSpan . Por padrão, esse campo fica vazio.

Entrada

• Argumentos — uma coleção 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ável de argumentos — as variáveis de argumento transmitidas para o processo invocado.
• Nome do processo — o nome do processo que você deseja invocar. Este campo aceita valores de String.

Registro

• Entrada de registro — especifique o tipo de informação a ser registrada automaticamente ao entrar no recurso invocado.
• Saída de registro — especifique 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 pela Entrada de registro e Saída de registro.

Diversos

• Ponto de entrada — se seu processo tiver vários pontos de entrada, especifique o caminho do arquivo de fluxo de trabalho a ser executado assim que o processo for iniciado. Esse caminho deve ser relativo ao pacote raiz. Por padrão, este campo fica vazio e usa o Main.xaml como ponto de entrada.

• 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, "Finanças/ContasAPagar".
• 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.