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.

Observação:

When sending a DataTable from one process to a second process using Apps, the columns order in a row may not be same.

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.

1. Em um aplicativo no App Studio, clique no botão Adicionar qualquer ícone na parte superior da tela.

2. Select Process to open the process reference dialog.

   

3. A list of tenants for the current account is displayed. Choose the one that hosts the processes you need and click Next.

   

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

5. Ao destacar um processo, será mostrado para você a descrição do processo, bem como as entradas ou saídas relacionadas a ele.

6. Check the checkbox next to the process you want to use in your app and click the Add button. The process selection dialog lists all the processes for a given Orchestrator tenant, organized by folder.

   

   Observação:

   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 usar um objeto, o Apps verificará o Histórico de trabalhos do objeto, a fim de detectar automaticamente o esquema/campos desse 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.

1. Clique na caixa de texto que queremos usar como a entrada do processo (neste caso, a caixa de texto da Entrada).

2. Queremos vincular o valor desta caixa de texto à entrada do processo, para clicarmos na Value Binding property, na guia Geral do painel Propriedade.

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

   

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

1. Clique no botão “Enviar depósito” e mude para a guia Eventos, no painel de propriedades.

2. Clique em Criar regra para abrir o construtor de regras.

   

3. Escolha a regra Iniciar processo.

   

4. 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 de modo assistido. 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:

• Usuários distintos não podem consumir mais de 100 processos independentes exclusivos para um determinado Orchestrator em todos os aplicativos que usam durante a vida útil da conta se os aplicativos forem públicos.
• No caso de um Orchestrator local, isso é limitado a 100 processos independentes exclusivos para todos os usuários.
• No caso de um Orchestrator da nuvem e aplicativos não públicos, esse limite de 100 não se aplica.

Resultado Interino do Processo

To use a UiPath Studio Activity, the following environment must be set up:

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

To use this actitivity, open UiPath Studio, drag and drop the Send Interim Result activity into the RPA workflow and fill in the Argument name and Argument value fields.

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