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 execução longa contém UiPath.Persistence.Activities e pode ser combinado com as atividades ·Invoke Process e non-user interaction, orquestrando tarefas humanas com tarefas de 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 realizando chamadas de API e executando na Sessão 0. Eles podem ser invocados usando a atividade·Invoke Process.
• UI: um processo com atividades de interação do usuário chamado através da atividade Start Job do Orchestrator e em execução em uma sessão de usuário.
• Human in the Loop: o usuário interage por meio de tarefas que exigem o preenchimento de formulários no Orchestrator. Implica o uso de atividade Create Form Task emparelhada com Aguarde a tarefa de formulário e continue.

Modelo do processo de orquestração

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

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 parâmetros in, in/out ou out e obter o objeto do item da fila. 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 os argumentos do tipo in, in/out ou 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 atividade final. 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 Criar tarefa de formulário para criar uma tarefa com visualização em formulário para interações humanas dentro de um fluxo de trabalho. Esses formulários com o contexto de fluxo de trabalho relevante são apresentados aos usuários para tomada de decisões e outros cenários. 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 Form Designer não mantém o foco, e você pode interagir com o Studio quando a janela 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 Create Form Task 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á-la em uma data e hora especificada.
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 execução longa (atividades Wait e Resume) que são parte do pacote UiPath.Persistence.Activities podem ser usadas apenas em um entry point do processo de orquestração, 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.

• 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 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.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 estejam entre as atividades Wait e Resume, como Wait for Job and Resume, Wait for Queue Item and Resume e Wait for Form Task and Resume.
• Considere que algumas propriedades dos objetos gerados pelas atividades de execução prolongada 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.

  Observação: as atividades Delay e Retry Scope não são suportadas e não funcionam corretamente quando usadas no fluxo de trabalho principal de um processo de orquestração. Em tais casos, elas devem ser colocadas dentro de uma atividade No Persistence Scope .