Referenciar um processo do Orchestrator

Um dos principais diferenciais do UiPath Apps é a capacidade de conectar um aplicativo facilmente a uma automação de RPA. O aplicativo pode ser usado como front-end para fornecer entradas para o processo ou como uma tela visual para exibir saídas para os usuários.

Observação: você pode conectar processos do Orchestrator independente ao Apps no Automation Suite.

Nota: Ao enviar um DataTable de um processo para um segundo processo usando Apps, a ordem das colunas em uma linha pode não ser a mesma.

Referenciar um processo do Orchestrator

Assim que um processo tiver sido publicado no Orchestrator, você poderá fazer referência àquele processo a partir de um aplicativo.

No exemplo abaixo, mostraremos como fazer referência a um processo existente em um aplicativo.

A partir de um aplicativo no App Studio, clique no sinal de “+”, ao lado do título do aplicativo.
Clique em Processo para abrir a caixa de diálogo de referência do processo.

Clique no sinal de "+" ao lado do título do aplicativo e, em seguida, clique em Processo para abrir a caixa de diálogo Referência do processo.
Uma lista das instâncias do Orchestrator em relação à conta atual do Automation Cloud será mostrada. Escolha uma que hospede os processos que necessita e clique em Avançar.

Os processos são armazenados no aplicativo chamado "Orchestrator". Você provavelmente recebeu um nome do Orchestrator ou credenciais para acessá-lo. Então, escolha um Orchestrator usando uma dessas opções em uma lista de Orchestrators disponíveis ou inserindo as credenciais fornecidas pelo administrador.
Uma lista dos processos, organizados por pastas, é mostrada em relação ao tenant selecionado no momento. Clique no ícone >, ao lado de qualquer pasta para enumerar os processos na respectiva pasta.
Ao destacar um processo, será mostrado para você a descrição do processo, bem como as entradas ou saídas relacionadas a ele.
Marque a caixa de seleção ao lado do processo que deseja usar no seu aplicativo e clique no botão Selecionar. A caixa de diálogo para seleção de processos relaciona todos os processos de um tenant específico do Orchestrator, organizado por pastas.

Observação:s as permissões do processo são gerenciadas no Orchestrator. Se você não consegue ver um processo no Apps Studio, certifique-se de que possui as permissões do Orchestrator para tal processo.
Importante:
Se seu processo estiver usando um objeto *.NET complexo em sua entrada ou saída (p.ex., DataTable), o App Studio não saberá quais os campos daquele objeto são usados por padrão. Você consegue especificar isso de duas maneiras:
- Execute o processo, antes de adicioná-lo ao aplicativo. Se um processo usa um objeto, o Apps confirmará o Histórico de Trabalho do objeto, a fim de detectar automaticamente os campos/esquema de tal objeto.
- Especifique os campos do objeto manualmente para a entrada/saída do processo. Se o processo não tiver histórico de trabalho, então, depois de ter sido adicionado ao aplicativo, você deve especificar os campos manualmente, a fim de usá-los no aplicativo.
— Os parâmetros adicionados manualmente a um processo, serão removidos se o processo for atualizado.

O processo agora foi adicionado ao App.

Vinculação de Entradas/saídas do processo aos Controles na tela do Apps

A maioria dos processos de RPA tomam as entradas e/ou exibem as saídas. Após desenvolver a interface gráfica de nosso aplicativo, queremos conectar os controles a essas entradas e saídas.

No exemplo abaixo, mostramos como vincular a entrada a uma caixa de texto e, em seguida, exibimos a saída como um rótulo. Este aplicativo foi desenvolvido para ajudar um caixa bancário a aceitar um depósito em dinheiro. O que queremos é enviar o valor da caixa de texto Cash In como entrada e, depois, exibir a saída do ID da transação resultante quando o processo for concluído.

Clique na caixa de texto que queremos usar como a entrada do processo (neste caso, a caixa de texto da Entrada).
Queremos vincular o valor desta caixa de texto à entrada do processo, para clicarmos na Value Binding property, na guia Geral do painel Propriedade.
Podemos encontrar a entrada do processo rapidamente, procurando pelo CashIn. O painel de recursos encontra o valor e podemos clicar duas vezes nele ou arrastá-lo e soltá-lo para que se torne a vinculação do valor.
Podemos usar a mesma série de passos para vincular a saída do ID da transação do processo ao rótulo.

Agora que as entradas e saídas do processo foram associadas à interface gráfica, a última coisa que precisamos fazer é escolher quando executar o processo.

Iniciando um processo

Como discutido na seção Eventos e regras, você pode personalizar como e quando um processo será iniciado em seu aplicativo.

No exemplo abaixo, mostramos como iniciar um processo quando um botão for clicado, mas isso poderia ter sido feito de qualquer evento.

Clique no botão “Enviar depósito” e mude para a guia Eventos, no painel de propriedades.
Clique em Criar regra para abrir o construtor de regras.
Escolha a regra Iniciar processo.
Clique na caixa de texto “Qual processo iniciar” e escolha o processo Caixa de banco no painel de recursos.

Observação: por padrão, os processos são executados no modo Attended. Se desejar executar o processo de modo não assistido, basta clicar no botão de rádio tipo Não assistido.

Com isso, você conclui seu trabalho! Se você visualizar o aplicativo, verá que, quando o botão “Enviar depósito” for clicado, o processo do Caixa do banco executará no robô local, passando o valor da caixa de texto ”Depósito” como uma entrada e, depois, exibindo o ID da transação como um rótulo, na parte inferior do aplicativo.

Importante: diferentes usuários não podem consumir mais de 100 processos Unattended para um determinado Orchestrator em todos os aplicativos que eles utilizam durante o ciclo de vida de suas contas. No caso de um On-Premise Orchestrator, o limite de processos Unattended exclusivos é de 100 para todos os usuários.

Resultado Interino do Processo

Para usar uma atividade do UiPath Studio, o seguinte ambiente deve ser configurado:

UiPath Studio v2022.4+ com UiPath Robot v2020.10+
Pacote UiPath.WorkflowEvents.Activities instalado no menu Gerenciar pacotes no UiPath Studio.

Send Interim Result

Você pode usar esta atividade para exibir um valor de saída específico enquanto um fluxo de trabalho ainda está em execução.

Para usar essa atividade, abra o UiPath Studio, arraste e solte a atividade Send Interim Result no fluxo de trabalho RPA e preencha os campos Argument name e Argument value .

Para obter mais informações sobre a atividade Send Interim Result, consulte a página dedicada no guia UiPath Activities.

Nesta página