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

In Studio, go to Home > Orchestration Process to open the template, which contains the default UiPath.Persistence.Activities and UiPath.System.Activities dependencies in a Flowchart workflow type.

The template's project.json file has the supportsPersistence: true parameter, indicating that process execution resumes upon task completion.

The requiresUserInteraction: false parameter indicates this workflow does not contain user interaction activities, similar to a Background Process.

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

A process may be turned into an Orchestration Process from the Project Settings window by setting the Supports Persistence toggle to Yes.

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.

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

• All variables used in the scope of a long-running activity must be serializable. Types of variables listed in this page are serializable: Text, True or False, Number, Array, Date and Time. Data Table and GenericValue variables.

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

• Please take into consideration that some properties of objects generated by long-running activities cannot be evaluated in the Locals panel.

• 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:

  The Delay and Retry Scope activities are not supported and do not work properly when used in the Main workflow of an Orchestration Process. In such cases, they should be placed inside a No Persist Scope activity.