Guia do usuário do StudioX

Última atualização 18 de dez de 2024

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.

Criar uma pasta de pesquisa no Outlook.
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 "Last week's attachments" na caixa Nome e selecione Critérios.
4. 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.
5. Na guia Mais opções, selecione Apenas itens com e, então, um ou mais anexos no menu suspenso adjacente.
6. Clique em OK três vezes para fechar as janelas e salvar a pasta de pesquisa.
Configure o projeto.
Crie um novo projeto em branco usando as configurações padrão
Verificar se existe a pasta onde salvar os anexos.
1. No painel Atividades, selecione a guia Arquivo e clique duas vezes em Pasta existe. Uma atividade Folder Exists é adicionada ao painel do designer.
2. 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 depois, a partir de Mais no lado direito do Construtor de Texto, selecione Notebook > Data [Planilha] > AAAAMMDD [Célula]. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] Date!YYYYMMDD.Clique em Salvar no Construtor de Texto.
  - Clique em Mais à direita do campo Salvar resultado, e depois selecione Salvar para Uso Posterior. Dê ao valor o nome Folder 'MailAttachments' Exists e clique em OK
    
    Você 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.
Adicionar atividades a serem executadas quando a pasta existir e também quando não existir.
1. 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.
2. Na atividade If:
  - Clique em Show Else para adicionar a ramificação Else.
  - Selecione Abrir no Editor avançado ao lado do campo Condição para abrir o Construtor de condição.
3. 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.
4. 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.
5. 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 depois, a partir de Mais no lado direito do Construtor de Texto, selecione Notebook > Data [Planilha] > AAAAMMDD [Célula]. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] 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.
6. 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.
7. 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 de MailAttachments_ e, então, em Mais no lado direito do Construtor de Texto, selecione Notebook > Data [Planilha] > YYYYMMDD [Célula]. Clique em Salvar no Construtor de Texto.
8. 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.
Adicionar atividades a serem executadas quando o usuário selecionar excluir qualquer pasta existente com o mesmo nome ou movê-la.
1. 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.
2. Na atividade If:
  - Clique em Show Else para adicionar a ramificação Else.
  - Selecione Abrir no Editor avançado ao lado do campo Condição para abrir o Construtor de condição.
3. 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.
4. 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.
5. 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 depois, a partir de Mais no lado direito do Construtor de Texto, selecione Notebook > Data [Planilha] > AAAAMMDD [Célula]. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] 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.
6. 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.
7. 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 depois, a partir de Mais no lado direito do Construtor de Texto, selecione Notebook > Data [Planilha] > AAAAMMDD [Célula]. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] 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.
8. 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.
9. 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.
10. 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.
11. 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 depois, a partir de Mais no lado direito do Construtor de Texto, selecione Notebook > Data [Planilha] > AAAAMMDD [Célula]. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] 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.
Salvar os anexos da pasta de pesquisa do Outlook.
1. 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.
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 Mail e solte-a dentro da atividade Use Desktop Outlook App.
4. 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.
5. No painel Atividades, arraste a atividade Save Email Attachments e solte-a dentro da atividade For Each Email.
6. 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 depois, a partir de Mais no lado direito do Construtor de Texto, selecione Notebook > Data [Planilha] > AAAAMMDD [Célula]. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] 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.
Criar o arquivo de texto onde adicionar informações sobre os arquivos, criar subpastas onde salvar o arquivo de texto e mover os anexos.
1. 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.
2. 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 Notebook > Data [Planilha] > YYYYMMDD [Célula] e, depois insira \Output. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] Date!YYYYMMDD\Output.Clique em Salvar no Construtor de Texto.
  
  Você indicou que deseja criar uma subpasta chamada Output na pasta MailAttachments.
3. No painel Atividades, arraste uma atividade Create File e solte-a abaixo da última Create Folder.
4. 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_, então, em Mais no lado direito do Construtor de Texto, selecione Notebook > Data [Planilha] > YYYYMMDD [Célula] e depois insira \Output\AttachmentsDetails.txt. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] 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.
5. 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.
6. 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 Notebook > Data [Planilha] > YYYYMMDD [Célula] e, depois insira \Output\AttachmentsDetails.txt. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] 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.
7. 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.
8. 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 Notebook > Data [Planilha] > YYYYMMDD [Célula] e, depois insira \Processed. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] Date!YYYYMMDD\Processed.Clique em Salvar no Construtor de Texto.
  
  Você indicou que deseja criar uma subpasta chamada Processed na pasta MailAttachments.
Iterar pelos arquivos, adicionar informações sobre cada arquivo ao arquivo de texto e mover cada arquivo para a subpasta Processado.
1. 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.
2. 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 depois, a partir de Mais no lado direito do Construtor de Texto, selecione Notebook > Data [Planilha] > AAAAMMDD [Célula]. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] Date!YYYYMMDD\Output.Clique em Salvar no Construtor de Texto.
  
  Você indicou que deseja iterar pelos arquivos na pasta AnexosdeEmail.
3. 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.
4. 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 Notebook > Data [Planilha] > YYYYMMDD [Célula] e, depois insira \Output\AttachmentsDetails.txt. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] 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.
5. 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.
6. 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 e, em seguida, selecione Texto. No Construtor de Texto, insira C:\MailAttachments_ e, então, em Mais no lado direito do Construtor de Texto, selecione Notebook > Data [Planilha] > YYYYMMDD [Célula] e, então, insira \Processed. O texto deve ter a seguinte aparência: C:\MailAttachments_[Notes] 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.
7. 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.

Baixe o exemplo