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.

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. Desconsiderar esse aviso dispara uma notificação de erro "As expressões não são compatíveis no momento".
• 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

Windows, configuração multiplataforma

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

• Argumentos - Opção padrão. Abre o dicionário de argumentos, onde é possível ver os argumentos do fluxo de trabalho 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 fluxo de trabalho, selecione Atualizar argumentos no lado direito do campo.

• 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. Para abrir a lista de argumentos e editar seus atributos, selecione a caixa de campo Argumentos.

Observação:

• Se o valor da variável Arguments for nulo em runtime, a atividade retornará à propriedade Arguments.

• Alternar entre as propriedades de variável Argumentos e Argumentos revela o valor anterior.

• O valor da variável Arguments é perdido ao fechar o Editor de Expressão.

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.

Opções

• Sessão de destino (exclusivo para projetos do Windows) - 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; portanto, certifique-se de definir a propriedade Isolated como True. 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

• Isolado - selecione Verdadeiro para executar o fluxo de trabalho invocado em um processo separado do Windows. Isso ajuda a isolar um fluxo de trabalho defeituoso do fluxo de trabalho principal. Falso por padrão.

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 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 são suportadas. Todas as strings devem ser colocadas entre aspas.

• Importação de argumentos — abre um painel Argumentos que conta com todos os argumentos do fluxo de trabalho referenciados na propriedade Nome do arquivo do fluxo de trabalho .

  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 — permite que você abra o fluxo de trabalho invocado em uma guia diferente do mesmo projeto.

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

• 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 são suportadas. Todas as strings devem ser colocadas entre aspas.

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

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

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

• Sessão de destino (exclusivo para projetos do Windows) - 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; portanto, certifique-se de definir a propriedade Isolated como True. 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