Invocar Arquivo de Fluxo de Trabalho

UiPath.Core.Activities.InvokeWorkflowFile

Description

Invoca de forma síncrona um fluxo de trabalho especificado, passando opcionalmente uma lista de argumentos de entrada a ele. Os argumentos podem ser importados de um fluxo de trabalho especificado com esta atividade usando o botão Importar Argumentos no corpo da atividade.

Observação:

• Importar argumentos de um fluxo de trabalho cria correspondências automáticas deles em variáveis existentes se compartilharem o mesmo nome e tipo de dados.
• Dados não serializáveis não podem ser passados entre fluxos de trabalho isolados (por exemplo, NavegadorDaUI, ElementoDaUI etc.).
• Políticas de antivírus que restringem o acesso do PowerShell podem impedir o uso de atividades relacionadas ao PowerShell. Por exemplo, você não pode usar as atividades Invoke Workflow File e Invoke Power Shell quando a regra com ID 6151 está habilitada no McAfee Endpoint Security.
• Depois de executar um fluxo de trabalho invocado que adiciona campos de log personalizados, os campos de log são restaurados para a configuração do fluxo de trabalho pai.

Importante:

• Passar argumentos IN para uma atividade Invoke Workflow File que não está isolada age como se uma referência fosse passada, o que significa que todas as alterações feitas no objeto dentro do fluxo de trabalho invocado alteram o objeto no fluxo de trabalho principal.
• Variáveis e argumentos não são compatíveis com nomes de arquivo de fluxo de trabalho no Windows e em projetos multiplataforma. Isso disparará uma notificação de erro Expressões não são suportadas atualmente.
• Ao invocar um fluxo de trabalho, certifique-se de que ele não contenha atividades de persistência. Elas só devem ser usadas no fluxo de trabalho principal.

O fluxo de trabalho que é referenciado na propriedade NomeDoArquivoDoFluxoDeTrabalho pode ser aberto no projeto atual usando o botão Abrir fluxo de trabalho no corpo da atividade.

Observação: todo arquivo .xaml invocado cujo título contém um ponto (.) tem todo o texto presente antes do ponto (incluindo o ponto) substituído por um caractere de sublinhado (_).

Compatibilidade do projeto

Windows - Legada | Windows | Multiplataforma

Configuração multiplataforma

• Nome do arquivo do fluxo de trabalho — o caminho do arquivo .xaml a ser invocado. O caminho do arquivo é relativo à pasta do projeto atual. O campo aceita apenas strings ou variáveis de string. Variáveis de string não são compatíveis com o Windows e projetos multiplataforma. Todas as strings devem ser colocadas entre aspas.
• Abrir fluxo de trabalho — abre o fluxo de trabalho invocado em uma guia diferente do mesmo projeto.

Opções avançadas

Opções

• Isolado — se esta caixa de seleção estiver marcada, o fluxo de trabalho invocado será executado em um processo separado do Windows. Isso ajuda a isolar um fluxo de trabalho defeituoso do fluxo de trabalho principal.

Registro

• Entrada de registro — qual tipo de informação registrar automaticamente ao entrar no recurso invocado.
• Saída de registro — qual tipo de informação registrar automaticamente ao sair do recurso invocado.
• NívelDeRegistro — o nível de registro em log aplicado às mensagens geradas pela Entrada de registro e Saída de registro.

Windows - Legada, Configuração do Windows

Painel do Designer

Você pode encontrar as opções a seguir no corpo da atividade.

Importação de argumentos

Clicar no botão Importar argumentos no corpo da atividade abre um painel Argumentos que conta com todos os argumentos do fluxo de trabalho referenciados na propriedade CaminhoDeArquivoDoFluxoDeTrabalho.

Este painel permite escolher quais argumentos você deseja importar do fluxo de trabalho invocado usando os controles direcionais ou o botão Excluir para reorganizar os argumentos. Clicar em OK salva as alterações.

Observação:

• Criar argumentos no painel faz com que eles sejam descartados, visto que não correspondem aos dados no fluxo de trabalho invocado.
• Os nomes de argumentos são sensíveis a letras maiúsculas e minúsculas no painel.

Após o painel ser fechado, um contador ao lado do botão mostra quantos argumentos foram selecionados para importação. O contador é codificado por cores, da seguinte forma:

• laranja — se há uma falta de correspondência entre os argumentos selecionados e os que existem no fluxo de trabalho invocado.
• cinza — se os argumentos selecionados foram encontrados no fluxo de trabalho invocado.

Abrir Fluxo de Trabalho

O botão Abrir fluxo de trabalho no corpo da atividade permite abrir o fluxo de trabalho invocado em uma guia diferente do mesmo projeto.

Painel de Propriedades

Comum

• NomeDeExibição - o nome de exibição da atividade.
• 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 o tempo que se deve aguardar para a atividade ser executada antes de gerar um erro. Este campo é compatível apenas com variáveis TimeSpan. Por padrão, esse campo fica vazio.

Entrada

• Argumentos — os parâmetros que podem ser passados para o aplicativo no momento da invocação.
• VariávelDeArgumentos — os parâmetros que podem ser passados dinamicamente para o fluxo de trabalho usando um dicionário.
• Isolado — se esta caixa de seleção estiver marcada, o fluxo de trabalho invocado será executado em um processo separado do Windows. Isso ajuda a isolar um fluxo de trabalho defeituoso do fluxo de trabalho principal.

• NomeDoArquivoDoFluxoDeTrabalho — o caminho de arquivo do arquivo .xaml a ser invocado. O caminho do arquivo é relativo à pasta do projeto atual. O campo aceita apenas strings ou variáveis de string. Variáveis de string não são compatíveis com o Windows e projetos multiplataforma. Todas as strings devem ser colocadas entre aspas.

  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.

Registro

• Entrada de registro — qual tipo de informação registrar automaticamente ao entrar no recurso invocado.
• Saída de registro — qual tipo de informação registrar automaticamente ao sair do recurso invocado.
• NívelDeRegistro — o nível de registro em log aplicado às mensagens geradas pela Entrada de registro e Saída de registro.

Diversos

• 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 fluxo de trabalho é iniciado. Apenas fluxos de trabalho isolados podem ser iniciados em uma sessão diferente que a do pai. Você pode escolher uma das seguintes opções:

  • Atual — o processo filho é aberto na mesma sessão que o processo pai.
  • 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

    Observação: ao configurar o Target Session para a atividade Invoke Workflow, o parâmetro Isolated deve estar habilitado.