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, 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 . 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.