Processo de Orquestração

Os fluxos de trabalho de execução prolongada são os projetos mestre que são compatíveis com a orquestração de serviços, a intervenção humana e outras transações de execução prolongada em ambientes não assistidos.

A intervenção humana é necessária quando alguns processos exigem entradas humanas para gerenciar exceções, aprovações ou validação antes de prosseguir para a próxima etapa da atividade. Nesta situação, a execução do processo é suspensa, liberando os Robôs até que a tarefa humana seja concluída.

Fragmentação do fluxo de trabalho

Um fluxo de trabalho de longa duração contém UiPath.Persistence.Activities e pode ser combinado com Invoke Process e atividades de interação não usuário, orquestrando tarefas humanas com tarefas do robô.Ele é executado na Sessão 0, garantindo assim uma execução rápida. Observe que a depuração de um Processo de Orquestração é feito em uma sessão de usuário.

Os fluxos de trabalho de execução prolongada podem orquestrar:

• Processos em segundo plano que podem conter atividades que realizam chamadas de API e são executadas na Sessão 0. Eles podem ser invocados usando a atividade Invoke Process.
• Interface gráfica: um processo com atividades de interação do usuário chamado por meio da atividade Iniciar Trabalho a partir do Orchestrator e executado em uma sessão do usuário.
• Interação humana: o usuário interage por meio de tarefas que exigem o preenchimento de formulários no Orchestrator. Implica o uso da atividade Create Form Task emparelhada com Wait for Form Task and Resume.

Modelo do processo de orquestração

No Studio, acesse Início > Processo de Orquestração para abrir o modelo, que contém as dependências padrão UiPath.Persistence.Activities e UiPath.System.Activities em um tipo de fluxo de trabalho Fluxograma.

O arquivo project.json do modelo tem o parâmetro supportsPersistence: true, indicando que a execução do processo será retomada na conclusão da tarefa.

O parâmetro requiresUserInteraction: false indica que esse fluxo de trabalho não contém atividades de interação do usuário, semelhante a um Processo em segundo plano.

Não é recomendável modificar manualmente os parâmetros no arquivo project.json.

Um processo pode ser transformado em um Processo de Orquestração na janela Configurações do Projeto, definindo o botão de alternância Suporte à Persistência para Sim.

Fragmentos para processos de orquestração

Para começar, o painel Fragmentos contém vários fragmentos de fluxo de trabalho que você pode usar para criar um Processo de Orquestração.

Como criar um processo de orquestração

Siga as etapas abaixo para emparelhar as atividades que fazem parte do pacote UiPath.Persistence.Activities e criar seu próprio Processo de Orquestração:

1. Use a atividade Add Queue Item and Get Reference para adicionar um Item da Fila com os parâmetros in, in/out ou out e obter o objeto Item da Fila correspondente.Quando o item da fila for processado, os argumentos fornecidos na propriedade ItemInformation serão atribuídos de volta às variáveis de fluxo de trabalho mapeadas, se essa atividade estiver emparelhada com a atividade Wait for Queue Item and Resume.

   

2. A atividade Wait for Queue Item and Resume deve ser emparelhada com a atividade Add Queue Item and Get Reference. O fluxo de trabalho entra no estado suspenso, liberando o Robô nesta atividade que está aguardando a conclusão de um item da fila específico antes de prosseguir para a próxima etapa do processo.

   

3. A atividade Start Job and Get Reference invoca outro processo fornecendo argumentos do tipo in, in/outou out.Após a execução, os argumentos modificados serão mapeados de volta para as variáveis do fluxo de trabalho, se essa atividade estiver emparelhada com a atividade Wait for Job and Resume.

   

4. A atividade Wait for Job and Resume deve ser emparelhada com Start Job and Get Reference, fornecendo o Job Object determinado como saída da última atividade.Isso suspende temporariamente o processo atual e aguarda o trabalho de referência ser concluído, retomando o processo após a atualização do status do trabalho de referência ser concluída.

   

5. Use a atividade Create Form Task para criar uma tarefa com visualização baseada em formulário para interações humanas dentro de um fluxo de trabalho.Esses formulários com o contexto de fluxo de trabalho relevante serão apresentados para os usuários tomarem decisões e em outras situações. Para habilitar o Designer de Formulários nesta atividade, instale o pacote UiPath.FormActivityLibrary.

   Observação:

   Ao usar uma versão do Studio a partir da 2021.4 com versões de UiPath.Persistence.Activities e UiPath.FormActivityLibrary anteriores à 1.2.1, a janela Designer de Formulários não mantém o foco e você pode interagir com o Studio quando a janela do Designer estiver aberta. Para evitar esse problema, certifique-se de atualizar os pacotes para a versão mais recente.

   

6. A atividade Wait for Form Task and Resume deve ser emparelhada com Criate Form Task fornecendo Task Object como entrada para suspender o fluxo de trabalho até que essa tarefa específica seja concluída pelo usuário final.

   

7. Use a atividade Resume After Delay para suspender a execução do fluxo de trabalho e retomá-lo em uma data e hora especificados.

8. Execute o fluxo de trabalho do Studio. Sempre que o Robô executar uma atividade de execução prolongada, o Studio entra o estado de somente leitura com a opção Retomar habilitada na faixa de opções. Para continuar, conclua a tarefa, o item da fila ou o trabalho subjacente e clique em Retomar.

Melhores práticas

• Atividades de longa execução (atividades Wait e Resume) que são parte do pacote UiPath.Persistence.Activities podem ser usadas apenas em um ponto de entrada do Processo do Orchestration, o arquivo marcado como Main.xaml.
• Os componentes reutilizáveis criados de um Processo de Orquestração só podem ser referidos em outro processo desse tipo.
• Se um fluxo de trabalho de longa duração estiver conectado ao processamento de fila e o fluxo de trabalho estiver em um estado suspenso, o item da fila permanecerá em um estado em andamento mesmo após 24 horas, até que o fluxo de trabalho defina o status da transação ao retomar. Os identificadores de itens de fila farão parte do contexto de fluxo de trabalho persistente, se estiverem incluídos no mesmo escopo de atividades Wait e Resume.
• Os pontos de persistência (atividades Wait e Resume) não devem ser usados dentro do corpo de uma atividade For Each, pois eles suspendem o fluxo de trabalho após a execução da primeira iteração e isso pode não ser o comportamento desejado. Alternativamente, tente usar loops com atividades de persistência, por exemplo, a atividade Parallel For Each. Observe que por padrão, a quantidade máxima de gatilhos de retomada por trabalho é limitada a 1.000.
• As atividades Delay e Retry Scope não são compatíveis e não funcionam corretamente quando usadas no Fluxo de trabalho principal de um processo de orquestração.Nesses casos, eles devem ser colocados dentro de uma atividade No Persist Scope.
• Os fluxos de trabalho de execução prolongada podem ser retomados em qualquer Robô disponível do mesmo tipo que o que suspendeu um trabalho (por exemplo, não assistido ou de não produção) que faça parte do mesmo ambiente ou pasta. Portanto, os recursos locais necessários para a execução também devem ser disponibilizados após os pontos de persistência.
• Todas as variáveis usadas no escopo de uma atividade de execução prolongada devem ser serializáveis. Tipos de variáveis listadas nesta página que são serializáveis: Text, True ou False, Number, Array, Date e Time. Variáveis Data Table e GenericValue.
• As variáveis usadas em escopos que não contêm atividades de execução longa não estão sujeitas ao requisito de serialização, pois o fluxo de trabalho não fica suspenso em seu escopo.Os tipos de dados não serializáveis podem ser usados em escopos de sequência separados no mesmo fluxo de trabalho ou invocando outros arquivos, desde que eles estejam entre as atividades Wait and Resume, como Wait for Job and Resume, Wait for Queue Item and Resume e Wait for Form Task and Resume.
• Leve em consideração que algumas propriedades de objetos gerados por atividades de longa duração não podem ser avaliadas no painel Locais.
• Implemente um lote adequado em fluxos de trabalho que esperam uma quantidade elevada de ações por trabalho. Observe que há um limite padrão de 1.000 ações (ou outros gatilhos de trabalho) que um trabalho pode aguardar por um período.