- Notas de Versão
- Introdução
- Tutoriais
- Projetos de automação
- Criando automações
- Noções básicas de automação
- Repo. de Objetos
- Tutorial: Criando uma Tabela Pivot
- Tutorial: Iterando através das Linhas de uma Tabela
- Tutorial: Extrair dados de e-mails automatizados e movê-los para um aplicativo da área de trabalho.
- Tutorial: Filtrar dados no Excel
- Tutorial: Formatar células
- Tutorial: Adicionar informações sobre os arquivos de uma pasta para um arquivo do Excel
- Tutorial: Adicionando suas Próprias Fórmulas ao Project Notebook
- Automação do PowerPoint
- Tutorial: Trabalhar com arquivos e pastas
- Automação de dados
- Atividades comuns
- Automação do Google Workspace
- Automação do OneDrive e do SharePoint
Guia do usuário do StudioX
Tutorial: Trabalhar com arquivos e pastas
Neste tutorial, criaremos uma automação que salva os anexos de todos os e-mails de uma pasta de pesquisa do Outlook em uma pasta que contém a data de hoje no nome e cria um arquivo de texto no qual todos os nomes de arquivo são copiados. Primeiro, a automação verificará se a pasta na qual os arquivos serão salvos já existe e, se for a caso, perguntará ao usuário se a pasta deve ser excluída e recriada ou se o conteúdo deve ser movido para uma pasta diferente antes que os anexos sejam baixados.
Começaremos adicionando uma atividade File Exists para verificar se já existe a pasta na qual queremos baixar os anexos. Em seguida, adicionaremos uma atividade If e, dentro dela, adicionaremos uma atividade Create Folder para criar a pasta, se ela ainda não existir. Se a pasta existir, adicionaremos uma atividade Message Box para solicitar que o usuário selecione como proceder. Outra atividade If seguirá com dois conjuntos separados de atividades a serem executadas, dependendo da escolha do usuário: excluir a pasta e recriá-la ou mover a pasta existente para outro local. Em seguida, adicionaremos as atividades para salvar os anexos do Outlook e criaremos duas pastas dentro da pasta de destino, uma para criar o arquivo de texto com informações sobre os arquivos salvos e outra para mover os arquivos após adicionarmos as informações do arquivo no arquivo de texto. Para adicionar a data de hoje ao nome da pasta, usaremos uma fórmula integrada ao Notebook do Projeto.
-
Etapa 1: Criar uma pasta de pesquisa no Outlook.
- Abra o Outlook, clique em Pastas de pesquisa no painel Pasta e selecione Criar uma pasta de pesquisa personalizada na lista.
- Na janela Nova pasta de pesquisa , selecione Criar uma pasta de pesquisa personalizada > Escolher.
- Na janela Pasta de pesquisa personalizada, insira "Last week's attachments" na caixa Nome e selecione Critérios.
- Na guia Mensagens da janela Critérios de pasta de pesquisa, vá até os menus suspensos ao lado de Quando e selecione Recebidas e Semana passada.
- Na guia Mais opções, selecione Apenas itens com e, então, um ou mais anexos no menu suspenso adjacente.
- Clique em OK três vezes para fechar as janelas e salvar a pasta de pesquisa.
- Etapa 2: Configurar o projeto.
-
Etapa 3: Verificar se existe a pasta onde salvar os anexos.
- No painel Atividades, selecione a guia Arquivo e clique duas vezes em Pasta existe. Uma atividade Folder Exists é adicionada ao painel do designer.
-
Na atividade Folder Exists:
- Clique em Mais no lado direito do campo Caminho da pasta e selecione Texto. No Construtor de Texto, insira
C:\MailAttachments_
e, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell]. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD
. Clique em Salvar no Construtor de Texto. -
Clique em Mais no lado direito do campo Output e selecione Salvar para Uso Posterior. Dê ao valor o nome
Folder 'MailAttachments' Exists
e clique em OKVocê indicou que deseja verificar se existe uma pasta AnexosdeEmail com a data de hoje e que deseja que o resultado de saída dessa atividade seja salvo para uso posterior em sua automação.
- Clique em Mais no lado direito do campo Caminho da pasta e selecione Texto. No Construtor de Texto, insira
-
Etapa 4: adicione atividades a serem executadas quando a pasta existir e também quando não existir.
- No painel Atividades, selecione a guia Comum, arraste uma atividade If e solte-a abaixo da atividade Folder Exists. Uma atividade If é adicionada ao painel do designer.
-
Na atividade If:
- Clique em Show Else para adicionar a ramificação Else.
- Clique em Mais no lado direito do campo Condição e selecione Construtor de Condição.
-
No Construtor de Condição, adicione a condição "se a pasta existir":
- Clique em Mais no lado direito do campo à esquerda e selecione Usar Valor Salvo > 'AnexosdeEmail' para selecionar a saída da atividade Folder Exists como o valor a ser avaliado na condição.
-
No menu suspenso do meio, selecione é true e clique em Salvar.
As atividades adicionadas na atividade Then da atividade If serão executadas se a pasta existir e aquelas adicionadas à atividade Else serão executadas se a pasta não existir.
- No painel Atividades, selecione a guia Arquivo, arraste uma atividade Create Folder e solte-a dentro da ramificação Else da atividade If. Uma atividade Create Folder é adicionada ao painel Designer.
-
Na atividade Create Folder, clique em Mais no lado direito do campo Nome da pasta e selecione Texto. No Construtor de Texto, insira
C:\MailAttachments_
e, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell]. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD
. Clique em Salvar no Construtor de Texto.Você indicou que deseja criar uma pasta MailAttachments com a data de hoje no nome se a pasta ainda não existir.
- No painel de Atividades, selecione a guia Comum e arraste uma atividade Message Box solte-a dentro da ramificação Then da atividade If. Uma Caixa de Mensagem é adicionada ao painel do designer.
-
Clique em Mais no lado direito da atividade Message Box e selecione Texto. No Construtor de Texto, insira uma mensagem a ser exibida ao usuário, por exemplo:
An older MailAttachments_ folder already exists. Do you want to delete the old one and create a new one? If you choose "No", the old one will be moved to a backup folder and a new one will be created.
. Para adicionar a data atual ao nome da pasta, posicione o cursor do mouse depois deMailAttachments_
e, então, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell]. Clique em Salvar no Construtor de Texto. -
Selecione a atividade Message Box adicionada ao painel Designer e abra seu painel Propriedades:
- No menu suspenso Buttons, selecione YesNo.
-
Clique em Mais no lado direito do campo ChosenButton, selecione Salvar para uso posterior e dê um nome para o valor, como por exemplo
ChosenButton from Message Box FolderAlreadyExists
.Você indicou que deseja solicitar ao usuário que escolha se a pasta deve ser removida se já existir, exibindo uma caixa de mensagem com duas opções de botão, Sim e Não. A escolha do usuário é salva para uso posterior na automação.
-
Etapa 5: Adicionar atividades a serem executadas quando o usuário selecionar excluir qualquer pasta existente com o mesmo nome ou movê-la.
- No painel de Atividades, selecione a guia Comum, arraste outra atividade If e solte-a dentro da ramificação Then da primeira atividade If abaixo da caixa de mensagem . Uma atividade If é adicionada ao painel do designer.
-
Na atividade If:
- Clique em Show Else para adicionar a ramificação Else.
- Clique em Mais no lado direito do campo Condição e selecione Construtor de Condição.
-
No Construtor de Condição, adicione a condição "se o usuário clicar em Sim":
- Clique em Mais no lado direito do campo e selecione Usar Valor Salvo > BotãoEscolhido da Caixa de Mensagem PastaJáExiste.. Isso seleciona a escolha do usuário (o botão clicado na atividade Message Box) como o valor a ser avaliado na condição.
- No menu suspenso do meio, selecione igual a.
-
Clique em Mais no lado direito do campo à direita e selecione Texto. No Construtor de Texto, insira
Yes
, e clique em Salvar duas vezes.As atividades adicionadas na ramificação Then da atividade If serão executadas se o usuário clicar em Sim e as da ramificação Else serão executadas se o usuário clicar em Não.
- No painel Atividades, selecione a guia Arquivo, arraste uma atividade Delete Folder e solte-a dentro da ramificação Then da segunda atividade If. Uma atividade Delete Folder é adicionada ao painel Designer.
-
Na atividade Delete Folder, clique em Mais no lado direito do campo Nome da pasta e selecione Texto.No Construtor de Texto, insira
C:\MailAttachments_
e, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell]. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD
. Clique em Salvar no Construtor de Texto.Você indicou que deseja excluir a pasta MailAttachments existente com a data de hoje no nome.
- No painel de Atividades, arraste uma atividade Create Folder e solte-a dentro da ramificação Verdadeira da segunda atividade If abaixo de Delete Folder. Uma atividade Create Folder é adicionada ao painel Designer.
-
Na atividade Create Folder, clique em Mais no lado direito do campo Nome da pasta e selecione Texto. No Construtor de Texto, insira
C:\MailAttachments_
e, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell]. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD
. Clique em Salvar no Construtor de Texto.Você indicou que deseja criar uma nova pasta MailAttachments com a data de hoje no nome.
- No painel de Atividades, arraste uma atividade Create Folder e solte-a dentro da ramificação Else da segunda atividade If. Uma atividade Create Folder é adicionada ao painel Designer.
-
Na atividade Create Folder, clique em Mais no lado direito do campo Nome da pasta e selecione Texto. No Construtor de Texto, insira
C:\old_MailAttachments
e clique em Salvar.Você indicou que deseja criar uma nova pasta chamada old_MailAttachments.
- No painel Atividades, arraste uma atividadeMove Folder e solte-a dentro da ramificação Else da segunda atividade If abaixo da atividade Create Folder. Uma atividade Move Folder é adicionada ao painel Designer.
-
Na atividade Move Folder:
- Clique em Adicionar no lado do direito do campo De e selecione Texto. No Construtor de Texto, insira
C:\MailAttachments_
, e em seguida na opção Adicionar no lado direito do Construtor de Texto, selecione Notebook do Projeto (Notas) > Data [Planilha] > AAAAMMDD [Célula]. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD
. Clique em Salvar no Construtor de Texto. -
Clique em Mais no lado direito do campo Para e selecione Texto. No Construtor de Texto, insira
C:\old_MailAttachments
e clique em Salvar.Com isso você indica que deseja mover a pasta AnexosdeEmail com a data de hoje para a pasta Antigos_AnexosdeEmail.
- Clique em Adicionar no lado do direito do campo De e selecione Texto. No Construtor de Texto, insira
-
Etapa 6: salve os anexos da pasta de pesquisa do Outlook.
- No painel Atividades, selecione a guia E-mail, arraste o recurso Use Desktop Outlook App e solte-o abaixo da primeira atividade If como a última atividade no projeto. A atividade será adicionada ao painel Designer.
-
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. - No painel Atividades, arraste a atividade For Each Mail e solte-a dentro da atividade Use Desktop Outlook App.
-
Na atividade For Each Email, clique em Mais do lado direito do campo In emails from e selecione Outlook > [Pastas de pesquisa] > [Anexos da última semana] para selecionar a pasta de pesquisa criada na conta
Outlook
. Sua seleção é exibida no campo In emails from como "Last week's attachments".Você indicou que deseja iterar pelos e-mails na pasta de pesquisa Anexos da semana passada.
- No painel Atividades, arraste a atividade Save Email Attachments e solte-a dentro da atividade For Each Email.
-
Na atividade Save Email Attachments:
- Clique no Mais do lado direito do campo Da mensagem e selecione E-mail atual para indicar que o e-mail cujos anexos você deseja salvar é o e-mail atual pelo qual você está iterando.
-
Clique em Mais no lado direito do campo Salvar na pasta e selecione Texto. No Construtor de Texto, insira
C:\MailAttachments_
e, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell]. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD
. Clique em Salvar no Construtor de Texto.Você indicou que deseja salvar os anexos na pasta AnexosdeEmail com a data de hoje no nome.
-
Etapa 7: crie o arquivo de texto onde adicionar informação sobre os arquivos, crie subpastas para salvar o arquivo de texto e mover os anexos.
- No painel Atividades, selecione a guia Arquivo, arraste uma atividade Create Folder e solte-a abaixo do recurso Use Desktop Outlook App como a última atividade no projeto. Uma atividade Create Folder é adicionada ao painel Designer.
-
Na atividade Create Folder, clique em Mais no lado direito do campo Nome da pasta e selecione Texto. No Construtor de Texto, insira
C:\MailAttachments_
e, então, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell] e, então, insira\Output
. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD\Output
. Clique em Salvar no Construtor de Texto.Você indicou que deseja criar uma subpasta chamada Output na pasta MailAttachments.
- No painel Atividades, arraste uma atividade Create File e solte-a abaixo da última Create Folder.
-
Na atividade Create File, clique em Mais no lado direito do campo Local do arquivo e selecione Texto. No Construtor de Texto, insira
C:\MailAttachments_
e, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell] e insira\Output\AttachmentsDetails.txt
. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD\Output\AttachmentsDetails.txt
. Clique em Salvar no Construtor de Texto.Você indicou que deseja criar um arquivo chamado AttachmentsDetails.txt na subpasta Saída.
- No painel Atividades, arraste uma atividade Write Text File e solte-a abaixo da atividade Create File. Uma atividade Write Text File é adicionada ao painel Designer.
-
Na atividade Write Text File:
- Clique em Mais no lado direito do campo Texto e selecione Texto. No Construtor de Texto, insira
Files received in the last week:
. Clique em Salvar no Construtor de Texto. -
Clique em Mais no lado direito do campo Gravar no nome de arquivo e selecione Texto. No Construtor de Texto, insira
C:\MailAttachments_
e, então, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell] e, então, insira\Output\AttachmentsDetails.txt
. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD\Output\AttachmentsDetails.txt
. Clique em Salvar no Construtor de Texto.Você indicou que deseja inserir o texto "Arquivos recebidos na semana passada:" no arquivo AttachmentsDetails.txt.
- Clique em Mais no lado direito do campo Texto e selecione Texto. No Construtor de Texto, insira
- No painel de Atividades, arraste uma atividade Create Folder e solte-a abaixo da atividade Write Text File. Uma atividade Create Folder é adicionada ao painel Designer.
-
Na atividade Create Folder, clique em Mais no lado direito do campo Nome da pasta e selecione Texto. No Construtor de Texto, insira
C:\MailAttachments_
e, então, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell] e, então, insira\Processed
. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD\Processed
. Clique em Salvar no Construtor de Texto.Você indicou que deseja criar uma subpasta chamada Processed na pasta MailAttachments.
-
Etapa 8: Iterar pelos arquivos, adicionar informações sobre cada arquivo ao arquivo de texto e mover cada arquivo para a subpasta Processed.
- No painel Atividades, arraste uma atividade For Each File in Folder in Folder e solte-a abaixo da última atividade Create Folder. Uma atividade For Each File in Folder é adicionada ao painel do usuário.
-
Na atividade For Each File in Folder, clique em Mais no lado direito do campo Pasta e selecione Texto. No Construtor de Texto, insira
C:\MailAttachments_
e, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell]. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD\Output
. Clique em Salvar no Construtor de Texto.Você indicou que deseja iterar pelos arquivos na pasta AnexosdeEmail.
- No painel Atividades, arraste uma atividade Append Line e solte-a dentro da atividade For Each File in Folder. Uma atividade Append Line é adicionada ao painel Designer.
-
Na atividade Append Line:
- Clique em Mais no lado direito do campo Texto e selecione Texto. No Construtor de Texto, insira
FileName:
e, então, em Mais no lado direito do Construtor de Texto, selecione CurrentFile > Nome, insira| LastModifiedDate:
e, então, em Mais no lado direito do Construtor de Texto, selecione CurrentFile > Last Modified Date . O texto deve ter a seguinte aparência:FileName: [CurrentFile] Name | LastModifiedDate: [CurrentFile] LastModifiedDate
. Clique em Salvar no Construtor de Texto. -
Clique em Mais no lado direito do campo Gravar no nome de arquivo e selecione Texto. No Construtor de Texto, insira
C:\MailAttachments_
e, então, em Mais no lado direito do Construtor de Texto, selecione Project Notebook (Notes) > Date [Sheet] > YYYYMMDD [Cell] e, então, insira\Output\AttachmentsDetails.txt
. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD\Output\AttachmentsDetails.txt
. Clique em Salvar no Construtor de Texto.Você indicou que deseja inserir o nome do arquivo e a hora em que o arquivo foi modificado no arquivo AttachmentsDetails.txt para o arquivo atual pelo qual você está iterando.
- Clique em Mais no lado direito do campo Texto e selecione Texto. No Construtor de Texto, insira
- No painel Atividades, arraste uma atividade Move File e solte-a dentro da atividade For Each File in Folder abaixo de Append Line. Uma atividade Move File é adicionada ao painel do designer.
-
Na atividade Move File:
- Clique em Mais no lado direito do campo De e selecione CurrentFile > Full Path.
-
Clique em Mais no lado direito do campo Para, selecione Texto. No Construtor de Texto, tecle enter
C:\MailAttachments_
, então, através Mais no lado direito do Construtor de Texto, selecione Notebook > Date [Planilha] > YYYYMMDD [Célula] e tecle enter\Processed
. O texto deve ter a seguinte aparência:C:\MailAttachments_[Excel] Date!YYYYMMDD\Processed
. Clique em Salvar no Construtor de Texto.Você indicou que deseja mover o arquivo atual através do qual está iterando para a subpasta Processado.
- 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.
Os anexos da pasta de pesquisa do Outlook são salvos na pasta AnexosdeEmail, um arquivo de texto com informação sobre os arquivos é criado na subpasta Saída e, em seguida, os arquivos são movidos para a subpasta Processado. Se você executar o projeto novamente porque a pasta já foi criada durante a primeira execução, será solicitado que você selecione o que fazer com a pasta existente antes que as outras atividade sejam executadas.