Invocar Processo

UiPath.Core.Activities.InvokeProcess

Description

Executa um processo UiPath que está disponível para a máquina local. Pode ser usado para executar pacotes locais, bem como processos no Orchestrator, se houver uma conexão 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 à 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.

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. Este campo é compatível apenas com valores String, com / como separador para indicar subpastas. Por exemplo, "Finanças/Contas a pagar".
• Invocar por — especifique se deve invocar o processo pelo nome do processo, conforme configurado no Orchestrator, ou pelo nome do pacote. Observe que usar o nome do pacote é suportado, mas obsoleto.

• Nome do processo / Nomedo pacote — o nome do processo ou pacote que você deseja invocar. O menu suspenso exibe os processos ou pacotes disponíveis na pasta conectada do Orchestrator. 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 de 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 adequadamente.

• Ponto de entrada — se o 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. O caminho deve ser relativo ao pacote raiz. Por padrão, esse campo é deixado vazio e usa o ponto de entrada configurado no Orchestrator.

• Argumentos - Opção padrão. Abre o dicionário de argumentos, no qual você pode 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 no lado direito do campo.

• Variável de argumentos - Ativada pela opção Usar uma expressão do campo Argumentos . Você pode usar uma variável predefinida ou pode criar uma nova usando expressões VB ou solicitando que o Autopilot gere 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 o tempo para aguardar que o fluxo de trabalho invocado seja executado antes de gerar um erro e o fluxo de trabalho ser 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 gerado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.

  Nota: Se esta atividade estiver incluída no Try Catch e o valor da propriedade ContinueOnError 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 automaticamente registrada 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 — especifique 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. No Windows - projetos legados, o robô identifica o processo a ser invocado por seu nome do pacote.

• Ponto de entrada — se o 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. O caminho deve ser relativo ao pacote raiz. Por padrão, esse campo é deixado vazio e usa o Main.xaml como ponto de entrada.

• Editar argumentos - Abre a lista de argumentos, na qual 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: 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 — especifica o tempo para aguardar que o fluxo de trabalho invocado seja executado antes de gerar um erro e o fluxo de trabalho ser 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. Esse campo aceita valores de String.

Registro

• Entrada de registro — especifique o tipo de informação a ser automaticamente registrada 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 — especifique 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 o 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. O caminho deve ser relativo ao pacote raiz. Por padrão, esse campo é deixado 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.