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 do gatilho , 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 usar as versões do UiPath Studio 2023.4 e superiores e as versões do UiPath Robot 2023.4 e superiores.

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. Começar com o modelo chamado Comunicação do Apps-Fluxo de trabalho/ 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: Apps Request Trigger e atividades Handle Apps Request .

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

4. Adicione a atividade Apps Request Trigger . Essa 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 da 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 de 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, em seguida, envia de volta os resultados da saída do fluxo de trabalho quando o fluxo de trabalho for concluído.
      Observação:

      A atividade Handle Apps Request deve ser usada dentro da seção Else da condição de conexão perdida. Isso garante que a atividade seja 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, em seguida, selecione a opção Ativar 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 essa etapa.

No arquivo Main.xaml, basta adicionar a atividade Run Local Triggers e 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 uma área 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 > Processos e clique em Adicionar processo.
4. No menu suspenso Nome de origem do pacote , selecione o projeto do Studio.
5. No menu suspenso Ponto de entrada , selecione Main.xaml.
6. Na próxima página, configure seu processo como desejar 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 usar o UiPath Apps com a opção Expressões de VB habilitada.

Adicionando os controles

1. Na página inicial do UiPath Apps > guia Criar , clique em Criar novo aplicativo.

2. Insira o Nome para seu aplicativo. Por exemplo, "Calcular em tempo real".

3. Para Linguagem de expressão, selecione VB.

4. Na PáginaPrincipal, 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"	Rótulo: "Primeiro número" Texto de 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: "Segundo número" Texto de 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. Uma lista de tenants para a conta atual é exibida. Escolha uma que hospede os processos que necessita e clique em Avançar.
3. No painel à esquerda, 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 "Calculadora".

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 de 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. No lado direito, no painel Eventos , clique em Criar regra. O assistente Configurar regra é aberto.

3. Procure a regra TriggerWorkflow e selecione-a.

4. No campo Arquivo do 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, em seguida, 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 "sintonizar" para abrir o editor de expressão e escreva 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 "sintonizar" para abrir o editor de expressão e escreva a seguinte expressão VB: MainPage.number2.Value

      Observação:

      "number1" e "number2" na expressão fazem referência aos controles da 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 ser definido , clique no ícone "sintonizar" para abrir o editor de expressão e faça referência ao controle de resultado. 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 "sintonizar" para abrir o editor de expressão e faça referência ao resultado do fluxo de trabalho. Por exemplo, para a operação de soma, escreva a seguinte expressão 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 aplicativo para execução, você precisa publicá-lo no feed do tenant do Orchestrator e, em seguida, implantá-lo.

1. No 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 Implantar aplicativo é aberto.
4. No menu suspenso Aplicativo , selecione o aplicativo publicado anteriormente.
5. Clique em Implantar. Agora seu aplicativo está disponível na pasta do Orchestrator para execução.

Executando seu aplicativo

Você está pronto para executar seu aplicativo.

1. No UiPath Assistant, no painel Início , pesquise seu aplicativo na categoria Apps .
2. Clique em Executar. Você é solicitado a conceder acesso ao Assistant 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.