Criação de um cronômetro em tempo real

Visão geral

Para observar a comunicação instantânea entre o UiPath Apps e o UiPath Robot, você precisaria:

• Crie um projeto no UiPath Studio composto por:

  • Main.Xaml — o fluxo de trabalho principal usado para executar os gatilhos

  • Vários fluxos de trabalho acionados por aplicativo: usados para operações aritméticas básicas. Esses fluxos de trabalho devem ser configurados como pontos de entrada.

    Operação aritmética	fluxo de trabalho do Studio
    adição	Sum.xaml
    Subtração	Subtract.xaml
    Multiplicação	Multiply.xaml
    Divisão	Divide.xaml

  • O fluxo de trabalho do gatilho - esse fluxo de trabalho está disponível como um modelo, mas você também pode criá-lo e personalizá-lo de acordo com suas necessidades de negócios

• Crie um aplicativo no UiPath Apps que consista em:

  • Dois controles de entrada - onde você insere seus números

  • Controles de quatro botões - configurados com a regra Fluxo de trabalho disparador para vincular o botão a uma operação aritmética específica, que é representada por um fluxo de trabalho do Studio

  • Controles de quatro caixas de texto - para onde o resultado das operações aritméticas é enviado

Como criar o projeto do UiPath Studio

Observação: certifique-se de que você está usando as versões 2023.4 e superiores do UiPath Studio e as versões 2023.4 e superiores do UiPath Robot.

Se possível, recomendamos configurar o projeto do Studio para Iniciar como um processo de segundo plano. Isso é útil para ter o mesmo aplicativo sendo executado simultaneamente em várias janelas do navegador, sem gerar erros.

Construindo o fluxo de trabalho de gatilho (modelo)

1. Abra o UiPath Studio e crie um novo processo.
   1. Selecione o Idioma.
   2. Selecione Windows como a compatibilidade.
2. Certifique-se de ter as seguintes versões do pacote de atividades:

   • UiPath.WorkflowEvents.Activities 2.0

   • UiPath.System.Activities 23.4+

3. Comece com o modelo chamado Comunicação Apps-Workflow/ No painel Projeto , adicione um novo fluxo de trabalho. Ele conterá as atividades que habilitam o canal de comunicação entre o UiPath Apps e o UiPath Robot: as atividades Apps Request Trigger e Handle Apps Request .

   Se você usar o modelo de comunicação Apps-Workflow , pule para Criação dos fluxos de trabalho da calculadora.

4. Adicione a atividade Apps Request Trigger . Esta deve ser a primeira atividade no fluxo de trabalho.

   Quando você adiciona a atividade Apps Request Trigger ao seu fluxo de trabalho, o argumento TriggerEventArgs é criado automaticamente. Use-o na atividade Handle Apps Request para acessar dados da carga de resposta recebida após a execução do fluxo de trabalho.

5. Adicione uma atividade If para capturar o caso de perda de conexão com o cliente do Apps. Quando o usuário fecha o cliente do Apps, todos os gatilhos devem ser interrompidos.
   1. No campo Condição , escreva a seguinte expressão: ConditionTriggerEventArgs.ConnectionWithAppLost = true
   2. Na seção Then , adicione a atividade Stop Local Triggers .
   3. Na seção Else , adicione a atividade Handle Apps Request .
   4. Nos campos Argumentos da atividade Handle Apps Request , use o argumento TriggerEventArgs que foi criado automaticamente pela atividade Apps Request Trigger . Esse argumento contém a carga do fluxo de trabalho recebida da atividade Apps Request Trigger e a passa para a atividade Handle Apps Request . Ao executar o fluxo de trabalho, a atividade Handle Apps Request usa as informações na carga para invocar o fluxo de trabalho e, então, envia de volta os resultados da saída do fluxo de trabalho quando o fluxo de trabalho é concluído.
      Observação:

      A atividade Handle Apps Request deve ser usada dentro da seção Else da condição para conexão perdida. Isso garante que a atividade será invocada durante uma conexão ativa entre o UiPath Apps e o UiPath Robot. Portanto, quando a conexão for perdida, a execução do processo será encerrada.

Criação dos fluxos de trabalho da calculadora

1. Crie uma pasta em seu projeto e dê o nome de "Calculator". É aqui que você armazena os fluxos de trabalho da calculadora.
2. Dentro da pasta, crie um fluxo de trabalho para cada operação aritmética:

   Operação aritmética	fluxo de trabalho do Studio
   adição	Sum.xaml
   Subtração	Subtract.xaml
   Multiplicação	Multiply.xaml
   Divisão	Divide.xaml

3. Em todos os fluxos de trabalho criados anteriormente, defina os seguintes argumentos:

   Argument name	Direction	Tipo de argumento
   number1	Em	Int32
   number2	Em	Int32
   Resultado	Out	Int32 Double - para a divisão

   Os argumentos "number1" e "number2" são os dados que seu usuário do Apps insere.

   O argumento "result" é a saída recebida após a execução do fluxo de trabalho.

4. Em todos os fluxos de trabalho criados anteriormente, adicione a atividade Assign . Configure-o da seguinte maneira:

   Fluxo de Trabalho	Salvar no campo	Valor a ser salvo no campo
   Sum.xaml	Resultado	number1 + number2
   Subtract.xaml	Resultado	number1 - number2
   Multiply.xaml	Resultado	number1 * number2
   Divide.xaml	Resultado	Cint(Math.Truncate(Decimal.Divide(number1,number2)))

5. Salve seus fluxos de trabalho.
6. Marque os fluxos de trabalho da calculadora como pontos de entrada: clique com o botão direito do mouse em cada fluxo de trabalho e, então, selecione a opção Habilitar ponto de entrada . Fazer isso garante que seus XAMLs sejam exibidos em seu aplicativo.

Como criar o fluxo de trabalho principal

Observação:

Se você usar o modelo de comunicação Apps-Workflow , pule esta etapa.

No arquivo Main.xaml, basta adicionar a atividade Run Local Triggers e, em seguida, salvar o arquivo.

Gerenciamento do projeto no Orchestrator

1. No Studio, publique seu pacote de projeto em uma pasta do Orchestrator.
   Observação:

   Se você publicar o projeto em um espaço de trabalho pessoal, o processo correspondente será criado automaticamente. Pule para Criação do projeto do Apps.

2. Em seu tenant do Orchestrator, acesse a pasta na qual você publicou o pacote do Studio.
3. Navegue até Automação > Processose clique em Adicionar processo.
4. No menu suspenso Nome da origem do pacote , selecione o projeto do Studio.
5. No menu suspenso Ponto de entrada , selecione Main.xaml.
6. Nas próximas páginas, configure seu processo como desejado e clique em Criar. Seu projeto do Studio agora está disponível como um processo do Orchestrator.

Criação do projeto do Apps

Observação: certifique-se de que você está usando o UiPath Apps com a opção Expressões do VB habilitada.

Adicionando os controles

1. Na página inicial do UiPath Apps > guia Compilar , clique em Criar novo app.
2. Insira o Nome do seu aplicativo. Por exemplo, "Calculador em tempo real".
3. Para Linguagem de expressão, selecione VB.
4. Na Página principal, adicione os seguintes controles com as seguintes propriedades Gerais :

   Controle	Propriedade geral: valor	Description
   1. Rótulo	Texto: "Calculador em tempo real"	Adiciona um título ao seu aplicativo.
   2. Caixa de texto (Número) — renomeie-a como "number1"	Etiqueta: "Primeiro número" Texto da dica: "Insira o primeiro número inteiro"	Permite que os usuários insiram seus dados.
   3. Caixa de texto (Número) - renomeie-a como "number2"	Rótulo: "Second number" Texto da dica: "Insira o segundo número inteiro"	Permite que os usuários insiram seus dados.
   4. Botão - renomeá-lo para "sum"	Texto: "Sum"	Dispara a execução do arquivo Sum.xaml.
   5. Caixa de texto — renomeada como "sum_result"	NA	Gera a resposta do arquivo Sum.xaml.
   6. Botão - renomeá-lo para "subtrair"	Texto: "Subtrair"	Dispara a execução do arquivo Subtract.xaml.
   7. Caixa de texto — renomeie-a como "subtract_result"	NA	Gera a resposta do arquivo Subtract.xaml.
   8. Botão - renomeie-o como "multiply"	Texto: "MultiPath"	Dispara a execução do arquivo Multiply.xaml.
   9. Caixa de texto — renomeie-a como "multiply_result"	NA	Gera a resposta do arquivo Multiply.xaml.
   10. Botão: renomeá-lo como "Divide"	Texto: "Dividir"	Dispara a execução do arquivo Divide.xaml.
   11. Caixa de texto — renomeie-a como "divide_result"	NA	Gera a resposta do arquivo Dividir.xaml.

Adicionando o processo

Adicione o processo como um recurso para associar os fluxos de trabalho do Studio aos controles do Apps.

1. Em seu aplicativo, expanda o menu suspenso Adicionar controle e selecione Processo.
2. É exibida uma lista de tenants para a conta atual. Escolha uma que hospede os processos que necessita e clique em Avançar.
3. No painel do lado esquerdo, expanda a pasta do Orchestrator na qual você criou seu processo, selecione o processo e, então, clique em Adicionar. Por exemplo, selecione o processo "Calculator".

   Após você adicionar o processo ao aplicativo, ele exibe o fluxo de trabalho principal e os fluxos de trabalho marcados como pontos de entrada, juntamente com seus argumentos de entrada e saída, conforme definido no projeto do Studio.

Como adicionar regras aos controles de botão

Ao adicionar a regra TriggerWorkflow a cada controle Botão , você instrui o aplicativo a executar um fluxo de trabalho específico sempre que o usuário do Apps clicar no botão.

Repita as seguintes etapas para cada controle de botão:

1. Selecione o controle de botão.
2. À direita, no painel Eventos , clique em Criar regra. O Assistente de Configuração de regra é aberto.
3. Procure a regra TriggerWorkflow e selecione-a.
4. No campo Arquivo de fluxo de trabalho , expanda o processo adicionado anteriormente ("Calculadora") e selecione o fluxo de trabalho correspondente (arquivo .xaml). Por exemplo, o botão de soma deve fazer referência ao arquivo "calculator_Sum_xaml".
5. Clique no campo Substituição de entrada e expanda o fluxo de trabalho selecionado anteriormente.
   1. Clique duas vezes em "number1" para selecioná-lo como o primeiro argumento de entrada.
   2. Para o campo Inserir valor , clique no ícone "ajuste" para abrir o editor de expressãoe escrever a seguinte expressão VB:
      MainPage.number1.Value
   3. Clique duas vezes em "número2" para selecionar como o segundo argumento de entrada.
   4. Para o campo Inserir valor , clique no ícone "ajuste" para abrir o editor de expressãoe escrever a seguinte expressão VB:
      MainPage.number2.Value
   Observação: "number1" e "number2" na expressão fazem referência aos controles de Caixa de texto (número) , que foram renomeados para "number1" e "number2" respectivamente. Ao definir o valor desses controles como os valores para os argumentos de entrada, você passa as entradas do usuário do Apps para o fluxo de trabalho do Studio.

   
6. Expanda o campo Quando concluído e adicione a regra Definir valor .
   1. Para o campo Item a definir , clique no ícone "ajuste" para abrir o editor de expressãoe fazer referência ao controle de resultados. Por exemplo, para o resultado da soma, escreva a seguinte expressão VB:
      MainPage.sum_result.Value
   2. Para o campo Valor , clique no ícone de "ajuste" para abrir o editor de expressãoe fazer referência ao resultado do fluxo de trabalho. Por exemplo, para a operação de soma, escreva a seguinte expressão do VB:
      Processes.Calculator.calculator_Sum_xaml.result.ToString
   Observação: adicionar a regra Definir valor no campo Quando concluído garante que o valor usado para vincular o resultado do fluxo de trabalho ao controle de resultado correspondente esteja correto, pois usa os valores retornados como saída após a conclusão da execução do fluxo de trabalho.

   
7. Repita as etapas anteriores para os botões restantes:

   Controle do botão	Arquivo do fluxo de trabalho
   Subtrair	calculator_Subtract_xaml
   Multiplicação	calculator_Multiply_xaml
   Divisão	calculator_Divide_xaml

Publicação e implantação de seu aplicativo no Orchestrator

Para preparar seu app para execução, você precisa publicá-lo no feed de tenant do Orchestrator e, em seguida, implantá-lo.

1. Em Apps, clique em Publicar na barra de navegação superior.
2. Mude para o Orchestrator e navegue até a pasta desejada.
3. Vá para Automações > Apps e clique em Implantar Aplicativo. O assistente de Implantação de aplicativo é aberto.
4. No menu suspenso Aplicativo , selecione o aplicativo publicado anteriormente.
5. Clique em Implantar. Agora seu aplicativo está disponível em sua pasta do Orchestrator para execução.

Executando seu aplicativo

Você está pronto para executar seu aplicativo.

1. No UiPath Assistant, no painel Início , procure seu aplicativo na categoria Aplicativos .
2. Clique em Executar. Você receberá uma solicitação para conceder acesso ao Assistente do UiPath Robot.
3. Insira dois números.
4. Clique em um botão para a operação aritmética desejada.

O primeiro cálculo leva mais tempo porque é a primeira instanciação do trabalho. Depois disso, o trabalho continua em execução e retorna instantaneamente os resultados. Ao fechar a sessão do Apps, o trabalho termina.