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

O Notebook do Projeto padrão contém fórmulas que conseguem extrair apenas os valores necessários. Editaremos manualmente o Notebook do Projeto para extrair os valores de um e-mail, conforme descrito na Etapa 2: configurar um projeto e obter os arquivos necessários e, depois, configuraremos nossa automação para extrair os mesmos valores de todos os e-mails semelhantes.

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:

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.
Insere os dados em cada campo de um aplicativo da área de trabalho e envia os dados.
Marca o e-mail como lido e o move para uma pasta do Outlook de e-mails processados.

Criaremos um projeto e começaremos adicionando uma atividade Use Desktop Outlook App para indicar a conta do Outlook a ser usada. Em seguida, adicionaremos uma atividade For Each Email e, então, para indicar que a automação deve ser executada para cada e-mail, colocaremos todas as atividades subsequentes dentro de For Each Email. Adicionaremos uma atividade Write Cell para copiar o corpo de cada e-mail em uma célula específica no Notebook do Projeto. Em seguida, adicionaremos as atividades UI automation necessárias para inserir os dados em nosso aplicativo da área de trabalho e, finalmente, atividades para marcar o e-mail como lido e mover o e-mail .

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.
Etapa 2: Configurar um projeto e obter os arquivos necessários.
1. Crie um novo projeto em branco usando as configurações padrão .
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. Baixe e extraia o arquivo com o projeto de automação neste tutorial usando o botão na parte inferior desta página. Clique duas vezes no arquivo DoubleUI.exe para abrir o aplicativo DoubleUI.exe.
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".
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:
  - Clique no Mais do lado direito do campo O que escrever, selecione E-mail atual > Corpo para indicar que queremos copiar o corpo do e-mail atual na iteração.
  - Clique no Mais do lado direito do campo Onde escrever e selecione Notebook do Projeto (Notas) > Indicar no Excel para abrir o arquivo no Excel. No arquivo, selecione a planilha Text, depois a célula B4, e clique em Confirmar na guia UiPath na faixa de opções do Excel. Você indicou que deseja colar o corpo do e-mail na célula B4 da planilha Text do Notebook do Projeto.
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.
  - Clique no Mais do lado direito do campo Digite isto e selecione Excel > Indicar no Excel. No arquivo do Excel, selecione a célula F4 (o valor de Cash In) e clique em Confirmar na guia UiPath da faixa de opções do Excel. O campo Digite isto exibe sua seleção como [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 de atividades, selecione a guia App/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.
Etapa 6: Marcar o e-mail como lido, depois movê-lo para uma pasta do Outlook.
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:
  - Clique no Mais do lado direito do campo E-mail e selecione E-mail atual para indicar que deseja marcar o e-mail atual na iteração.
  - No menu suspenso Marcar como, selecione Lida.
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:
  - Clique no Mais do lado direito do campo E-mail e selecione E-mail atual para indicar que deseja mover o e-mail atual na iteração.
  - Clique no Mais do 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.
Baixe o exemplo