Tutorial: Extrair dados de e-mails automatizados e movê-los para um aplicativo da área de trabalho.

Neste tutorial, criaremos uma automação que facilita a extração de dados específicos de blocos de texto que seguem um determinado formato. Vamos imaginar que você trabalha em um banco e recebe várias notificações por e-mail relacionadas a novos depósitos bancários. Você deve abrir cada e-mail, copiar manualmente os valores, colá-los em um aplicativo de banco e depois mover cada e-mail processado para uma pasta do Outlook. Os e-mails são automatizados, todos eles seguem um modelo e o mesmo texto sempre aparece próximo aos valores de que você precisa no corpo do e-mail. Por exemplo:

!!!This is an automated message, please do not respond.
A new deposit transaction can be submitted:
Cash in: $10
On Us Check: $20
Not On Us Check: $15
Thank you.

The default Project Notebook contains formulas that can extract only the needed amounts. We will manually edit the Project Notebook to extract the values from one email, as described in Step 2: Set up a project and get the necessary files, and then configure our automation to extract the same values from all similar emails.

A automação executa as seguintes tarefas para cada e-mail em uma pasta de pesquisa do Outlook que contém os e-mails automatizados não lidos mais recentes relacionados a depósitos bancários:

1. Copia o corpo do e-mail e cola os dados no Notebook do Projeto, onde dados específicos são extraídos usando fórmulas do Excel para manipulação de texto.
2. Insere os dados em cada campo de um aplicativo da área de trabalho e envia os dados.
3. Marca o e-mail como lido e o move para uma pasta do Outlook de e-mails processados.

We will create a project and start by adding a Use Desktop Outlook App activity to indicate the Outlook account to use. We will then add a For Each Email activity, and then, to indicate the automation must be executed for each email, we will place all subsequent activities inside For Each Email. We will add a Write Cell activity to copy the body of each email to a specific cell in the Project Notebook. We will then add the UI automation activities needed to enter the data in our desktop application, and finally activities to mark the email as read and move the email.

1. Etapa 1: Criar duas pastas no Outlook.

   Para este exemplo, usaremos e-mails com o assunto New Deposit Available e um corpo conforme mencionado anteriormente.

   Para criar uma pasta de pesquisa para e-mails não lidos de hoje que tenham o assunto especificado:

   1. Abra o Outlook, clique em Pastas de pesquisa no painel Pasta e selecione Criar uma pasta de pesquisa personalizada na lista.

   2. Na janela Nova pasta de pesquisa , selecione Criar uma pasta de pesquisa personalizada > Escolher.

   3. Na janela Pasta de pesquisa personalizada, insira Today's deposits na caixa Nome e selecione Critérios.

   4. Na guia Mensagens da janela Critérios da pasta de pesquisa:

      • No menus suspensos ao lado de Tempo, selecione recebido e Hoje.
      • Na caixa Pesquisar palavra(s), insira New Deposit Available.
      • No menu suspenso Em, selecione Somente campo de assunto.

   5. Na guia Mais opções selecione Somente itens que são e, em seguida, não lidos no menu suspenso adjacente.

   6. Clique em OK três vezes para fechar as janelas e salvar a pasta.

   7. Crie uma pasta em sua caixa de entrada chamada ProcessedDeposits. Essa é a pasta para a qual os e-mails serão movidos após serem processados.

   8. Envie alguns e-mails para a conta de e-mail que você usa na automação com o assunto especificado e um corpo que siga o modelo especificado, mas insira valores diferentes em cada e-mail.

   9. Após enviá-los, certifique-se de que eles apareçam na pasta de pesquisa Today's deposits.

2. Etapa 2: Configurar um projeto e obter os arquivos necessários.

   1. Create a new blank project using the default settings.

   2. Abra o Notebook do Projeto desse projeto e copie o corpo de um e-mail para a célula B4 na planilha Text, depois insira manualmente o texto à esquerda de cada um dos três valores nas células D5:D7, Cash in: na célula D5, On Us Check: na célula D6, Not On Us Check: na célula D7. Como não há texto à direita dos valores, as células E5:E7 devem estar vazias. As fórmulas já nas células F5:F7 devem extrair os valores, como você pode ver na imagem abaixo.

      

      Salve e feche o Notebook do Projeto.

   3. Download and extract the archive with the automation project in this tutorial using the button at the bottom of this page. Double-click the file DoubleUI.exe to open the DoubleUI application.

3. Etapa 3: Adicionar a conta do Outlook ao projeto e iterar pelas mensagens na pasta de pesquisa.

   1. No painel Atividades, selecione a guia E-mail e clique duas vezes em Use Desktop Outlook App. A atividade será adicionada ao painel Designer.

   2. Na atividade, a conta de e-mail padrão já está selecionada no campo Conta. Se você quiser usar uma conta diferente, selecione-a no menu suspenso.

      Na campo Referenciar como, deixe o valor padrão Outlook como o nome pelo qual se referir à conta na automação.

   3. No painel Atividades, arraste a atividade For Each Email e solte-a dentro da atividade Use Desktop Outlook App.

   4. Na atividade For Each Email, clique no Mais do lado direito do campo Nos e-mails de e selecione Outlook > [Search Folders] > [Today's deposits].

      Você indicou que deseja iterar pelos e-mails na pasta de pesquisa do Outlook "Today's deposits".

      

4. Etapa 4: Copie o corpo de e-mail em uma célula no Notebook do Projeto para extrair o texto.

   1. No painel Atividades, selecione a guia Excel, arraste a atividade Write Cell e solte-a dentro da atividade For Each File in Folder.

   2. Na atividade Write Cell:

      • Click Plus on the right side of the What to write field and then select CurrentMail > Body to indicate that you want to copy the body of the current mail in the iteration.

      • Click Plus on the right side of the Where to write field, and then select Project Notebook (Notes) > Indicate in Excel to open the file in Excel. In the file, select the Text sheet, and then the B4 cell, and click Confirm in the UiPath tab in the Excel ribbon. You have indicated that you want to paste the email body to cell B4 in the Text sheet of the Project Notebook.

        

5. Etapa 5: Adicionar o aplicativo da área de trabalho e as atividades a serem executadas nele.

   1. No painel Atividades, selecione a guia Aplicativo/Web, arraste uma atividade Use Aplication/Browser e solte-a dentro da atividade For Each Email, abaixo da atividade Write Cell. Uma atividade Use Application/Browser é adicionada ao painel Designer.

   2. Na atividade Use Application/Browser, clique em Indique o aplicativo e mova o cursor sobre o aplicativo DoubleUI. Quando a janela estiver destacada, clique em qualquer lugar em DoubleUI.

      A atividade Use Application/Browser é atualizada e uma captura de tela da janela aparece dentro da atividade.

   3. No painel de atividades, selecione a aba App/Web , arraste uma atividade Type Into e solte-a dentro da atividade Use Application/Browser. Uma atividade Type Into é adicionada na atividade Use Application/Browser.

   4. Dentro da atividade Type Into:

      • Clique em Indicar o destino na tela, mova o cursor sobre o campo Cash In no aplicativo DoubleUI.exe e, quando estiver destacado, clique no campo. O campo de texto é identificado como o destino e o rótulo Cash In próximo a ele é identificado como uma âncora. Clique em Confirmar na janela Opções de seleção para salvar a seleção. Uma imagem do destino e da âncora serão exibidas na atividade Type Into.

        Você indicou que deseja digitar no campo Cash In do aplicativo DoubleUI.exe.

      • Click Plus on the right side of the Type this field, and then select Excel > Indicate in Excel. In the Excel file, select the F4 cell (the Cash In value) and click Confirm in the UiPath tab of the Excel ribbon. The Type this field displays your selection as [Excel] Text!F5.

        Você indicou que deseja copiar o valor de Cash In do arquivo do Excel para o campo Cash In no aplicativo DoubleUI.exe.

   5. Repita as etapas 3-4 outras duas vezes para adicionar atividades Type Into para copiar os valores de On Us Check e Not On Us Check do arquivo do Excel (células F6 e F7, respectivamente) para os campos correspondentes no aplicativo DoubleUI.

   6. No painel Atividades, selecione a guia Aplicativo/Web , arraste uma atividade Click e solte-a dentro da atividade Use Application/Browser após a atividade Get Text. Uma atividade Click é adicionada na atividade Use Application/Browser.

   7. Na atividade Click, clique em Indicar o Destino na tela, mova o cursor sobre o botão Accept no aplicativo DoubleUI.exe e, quando estiver realçado, clique no botão. O botão Accept será identificado como o destino e o botão Cancel será identificado como uma âncora. Clique em Confirmar na janela Opções de seleção para salvar a seleção. Uma imagem do destino e da âncora serão exibidos na atividade Click.

      Você indicou que deseja clicar no botão Accept do aplicativo DoubleUI.exe.

      

6. Etapa 6: Marcar o e-mail como lido, depois movê-lo para uma pasta do Outlook.

   Baixe o exemplo

   1. No painel Atividades, selecione a guia E-mail, arraste uma atividade Mark Email as Read/Unread e solte-a dentro da atividade For Each Email abaixo da atividade Use Application/Browser. Uma atividade Mark Email as Read/Unread é adicionada ao painel Designer.

   2. Na atividade Mark Email As Read:

      • Click Plus on the right side of the Email field and then select CurrentMail to indicate that you want to mark the current mail in the iteration.
      • From the Mark as drop-down menu, select Read.

   3. No painel Atividades, arraste uma atividade Move Email dentro da atividade For Each Email abaixo da atividade Mark Email as Read/Unread. Uma atividade Move Email é adicionada ao painel Designer.

   4. Na atividade Move Email:

      • Click Plus on the right side of the Email field and then select CurrentMail to indicate that you want to move the current mail in the iteration.

      • Clique em Mais no lado direito do campo Mover para e selecione Outlook > [Inbox] > [ProcessedDeposits]. Você indicou que deseja mover o e-mail para a pasta ProcessedDeposits.

        

   5. Clique em Salvar na faixa de opções do StudioX para salvar a automação e, então, clique em Executar para executar a automação.

      Para cada e-mail na pasta de pesquisa do Outlook, o corpo é copiado para o Excel, os dados são extraídos e inseridos no aplicativo da área de trabalho DoubleUI e o e-mail é, então, marcado como lido e movido para uma pasta diferente.