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.
• Variables and arguments are not supported for workflow file names in Windows and cross-platform projects. Disregarding this notice triggers an "Expressions are currently not supported" error notification.
• 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

• Workflow file name - The file path of the .xaml file to be invoked. The file path is relative to the current project folder. This field accepts only strings or string variables. String variables are not supported in Windows and cross-platform projects. All strings must be placed between quotes. To open the workflow in a different tab of the same project, select Open workflow at the right side of the field.

• Arguments - Default option. Opens the arguments dictionary, where you can see the arguments of the invoked workflow. You can also define a variable to hold a dictionary of arguments by selecting Use an expression at the right side of the field. This converts the Arguments field to Arguments variable. To retrieve the latest list of workflow arguments, select Refresh arguments at the right side of the field.

• Arguments variable - Activated by the Use an expression option from the Arguments field. You can use a predefined variable, or you can create a new one either by using VB expressions or prompting the Autopilot to generate one for you. Use this variable to hold the dictionary of arguments for the invoked workflow. Switch back to the Arguments option by selecting Use Static Names at the right side of the field. To open the arguments list and edit their attributes, select the Arguments field box.

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