Tutorial: Adicionando suas Próprias Fórmulas ao Project Notebook

O Notebook padrão disponível com todos os projetos de automação vem com uma série de fórmulas que podem ser facilmente incorporadas em suas automações quando selecionadas na pasta menu de campos de atividade. Neste tutorial, criaremos uma automação de conversão de moeda simples que demonstra como você pode adicionar uma fórmula própria ao Notebook e usá-la em seu projeto.

Começaremos adicionando manualmente uma fórmula para converter USD em EUR na célula C1 da planilha do Scratchpad no Notebook e, em seguida, criaremos uma automação que realiza as seguintes tarefas:

1. Recupera a taxa de câmbio do dólar americano para o euro em uma pesquisa na web e a adiciona na célula A1.
2. Solicita um valor em USD durante a execução do projeto e adiciona o valor na célula B1.
3. Exibe uma caixa de mensagem com o equivalente em EUR do valor em USD calculado na célula C1.

Para encerrar as coisas, iremos preparar a nossa automação preparada para o futuro contra quaisquer alterações no Project Notebook, nomeando as células usadas na automação e atualizando o projeto para usar as células nomeadas.

1. Configure um projeto e atualize o Notebook do projeto.

   1. Crie um novo projeto em branco usando as configurações padrão.
   2. Clique em Notebook na faixa de opções do StudioX para abrir o arquivo no Excel.
   3. No arquivo do Excel, selecione a planilha Scratchpad e, em seguida, insira a fórmula =A1*B1 na célula C1. Esta fórmula converte o valor em USD adicionado na célula B1 em EUR usando a taxa de câmbio adicionada na célula A1.
   4. Salve e feche o Notebook do Projeto.
   5. Este exemplo usa o Google Chrome, o que requer a instalação da extensão^UiPath® para Chrome. Para instalá-la, acesse Início (Exibição Backstage do StudioX) > Ferramentas e, em Extensões UiPath, clique em Chrome.

2. Obtenha a taxa de câmbio da Web.

   1. Abra o Google Chrome, navegue até google.com e pesquise usd to euro exchange rate.

   2. No StudioX, clique em no painel Designer, em seguida localize a atividade Use Application/Browser na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel do designer.

   3. Na atividade Use Application/Browser, clique em Indicate Application, mova o mouse para a página com os resultados da pesquisa para a taxa de câmbio e, quando a página do navegador estiver destacada em azul, clique em qualquer lugar dentro dela.

      Você indicou que deseja usar a página com os resultados da pesquisa em sua automação.

   4. Clicar dentro da atividade Use Application/Browser e localize a atividade Get Text na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel do designer.

   5. Na atividade Get Text:

      • Clique em Indicar destino na tela, em seguida mova o ponteiro do mouse sobre o valor em Euro na parte superior da página de resultados da pesquisa na web e, quando estiver destacado, clique no valor. O valor é identificado como o alvo e destacado em verde. Clique em Confirmar na janela Opções de Seleção para salvar a seleção. Uma imagem do alvo e de qualquer âncora identificada é exibida na atividade Get Text.

      • Clicar no lado direito do campo Salvar em e selecione Notebook > Indicar no Excel. No Excel, selecione a célula A1 e clique em Confirmar na guia UiPath da faixa de opções do Excel. Você indicou que deseja colar a taxa de câmbio na célula A1 na planilha do Scratchpad do Notebook.

        

3. Solicitar um valor em dólares americanos e exibir seu equivalente em euros.

   1. Clicar abaixo da atividade Get Text, em seguida, localize a atividade Write Cell na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel do designer.

   2. Na atividade Write Cell:

      • Clique no lado direito do campo What to write e selecione Ask when run.

      • Clicar no lado direito do campo Onde escrever e selecione Notebook > Indicar no Excel. No Excel, selecione a célula B1 e clique em Confirmar na guia UiPath da faixa de opções do Excel.

        Você indicou que deseja solicitar ao usuário um montante em USD durante a execução do projeto e que deseja colar este valor na célula B1 na folha de rascunho do Notebook.

   3. Clicar abaixo da atividade Write Text, em seguida, localize a atividade Message Box na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel do designer.

   4. Na atividade Message Box , clique em no lado direito do campo Mensagem e selecione Texto.

   5. Queremos exibir a mensagem "X USD é equivalente a Y EUR". Para conseguir isso, no Construtor de Texto:

      • Clicar no lado direito da caixa de texto e selecione Notebook (Notas) > Indicar no Excel. No Excel, selecione a célula C1 e clique Confirmar na guia UiPath na faixa de opções do Excel.

      • Insira o texto USD is the equivalent of

      • Clicar no lado direito da caixa de texto e selecione Notebook (Notas) > Indicar no Excel. No Excel, selecione a célula B1 e clique em Confirmar na guia UiPath na faixa de opções do Excel.

      • Insira o texto EUR.

        O texto deve se parecer com a imagem a seguir.

        

   6. Clique em Salvar no Construtor de Texto, em seguida clique em Salvar na faixa de opções do StudioX para salvar a automação e clique em Executar para executar a automação.

      

      A taxa de câmbio é obtida da pesquisa na web, o usuário é solicitado a inserir um valor, o valor é convertido de USD para EUR no Excel e uma mensagem é exibida com o resultado da conversão.

4. Otimizar sua automação nomeando as células no Notebook do Projeto.

   Sua automação agora está totalmente funcional, mas você pode melhorá-la ainda mais nomeando as células usadas nela e atualizando as atividades que fazem referência a elas. Nomear células tem as seguintes vantagens:

   • Ao configurar atividades, você pode selecionar células nomeadas diretamente do menu , sem ter que abrir o arquivo e indicar no Excel.

   • Identificar células por nome em vez de por referência significa que você não precisa se preocupar em atualizar atividades para apontar para as células corretas se as alterações no arquivo do Excel fizerem as células ser deslocadas.

     Para nomear as células e atualizar o projeto:

   1. Abra o Project Notebook no Excel e renomeie as seguintes células na planilha Scratchpad usando a Caixa de nome na extremidade esquerda da barra de fórmulas: para a célula A1, insira o nome ExchangeRate, para a célula B1, insira o nome USDValue e para a célula C1, insira o nome EURValue.
   2. Atualize as atividades no projeto para usar os nomes das células:
      • Na atividade Get Text, clique em no lado direito do campo Save to e, em seguida, selecione Project Notebook (Notes) > Scratchpad [Sheet] > ExchangeRate.
      • Na atividade Write Cell, clique em no lado direito do campo Where to write e, em seguida, selecione Project Notebook (Notes) > Scratchpad [Sheet] > USDValue.
      • Na atividade Message Box, clique em e, em seguida, selecione Texto e atualize as duas referências às células no Excel:

        • Exclua [Excel] Scratchpad!B1, então clique no lado direito da caixa de texto e selecione Notebook > Scratchpad > USDValue.

        • Exclua [Excel] Scratchpad!C1, então clique no lado direito da caixa de texto e selecione Notebook > Scratchpad > EURValue.

          O projeto atualizado deve se parecer com a imagem a seguir.

          

          Baixe o exemplo