Guia do usuário do StudioX

Última atualização 18 de dez de 2024

Tutorial: Trabalhar com a automação do Word

Neste tutorial, criaremos uma automação que gera um documento do Word para revisão do desempenho individual de cada membro de uma equipe, com base em um modelo de arquivo do Word e dados coletados de vários arquivos do Excel e de texto. O modelo de arquivo contém texto de espaço reservado e indicadores, que podem ser preenchidos com valores usando atividades do Word. Os nomes dos arquivos do Excel e de texto dos quais os dados serão copiados seguem um padrão específico que inclui o nome do funcionário.

Começaremos adicionando uma atividade Use Excel File para indicar um arquivo do Excel com informação do funcionário para adicionar à automação. Dentro dele, adicionaremos uma atividade For Each Excel Row para iterar através das linhas com dados de funcionários. Dentro de cada linha do Excel, adicionaremos uma atividade Use Word File para adicionar o documento modelo à automação e, em seguida, uma série de atividades Replace Text, Set Bookmark Content e Insert DataTable in Document preencherá cada arquivo do Word com as informação necessárias retirado para cada funcionário de um arquivo Excel e um arquivo de texto. Por fim, adicionaremos uma atividade Save Word File As para salvar o modelo de documento como um arquivo separado para cada funcionário.

Configure o projeto e obtenha os arquivos necessários.
1. Crie um novo projeto em branco usando as configurações padrão.
2. Baixe e extraia o arquivo com o projeto de automação neste tutorial usando o botão na parte inferior desta página. Copie a pasta Arquivos para a pasta do seu projeto.
3. Crie uma pasta chamada Saída na pasta do seu projeto.
Adicionar o Excel com os dados do funcionário ao projeto e iterar pelas linhas do arquivo.
1. No StudioX, clique em Adicionar atividade no painel Designer e localize a atividade Use Excel File na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel Designer.
2. Na atividade:
  - Clique em Procurar por arquivo próximo ao campo Arquivo do Excel e navegue até a pasta Arquivos e selecione o arquivo Employees.xlsx.
  - No campo Referenciar como, insira EmployeeData.
    
    Você indicou que trabalhará com o arquivo Employees.xlsx que é conhecido em sua automação como EmployeeData.
3. Clique em Adicionar Atividade dentro de Use Excel File e depois localize a atividade For Each Excel Row na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel do designer dentro da atividade Use Excel File.
4. Na atividade For Each Excel Row:
  - Na caixa de texto Para cada, substitua CurrentRow por Employee.
  - Clique em Mais no lado direito do campo In range e selecione EmployeeData > Sheet1 [Sheet].
    
    Você indicou que deseja iterar por todas as linhas da Sheet1 da planilha Employees. Como cada linha contém informações sobre um funcionário, a linha atual na iteração foi renomeada como Funcionário para tornar as informações da linha mais fáceis de identificar posteriormente na automação.
Adicionar o arquivo de modelo do Word à automação.
1. Clique em Adicionar Atividade dentro da atividade For Each Excel Row e localize a atividade Use Word File na caixa de pesquisa na parte superior da tela e selecione-a.A atividade será adicionada ao painel Designer.
2. Na atividade Use Word File:
  - Clique em Procurar ao lado do campo Arquivo do Word, navegue até a pasta de arquivos e selecione o arquivo modelo_DocAvaliaçãodeDesempenho.docx.
  - Desmarque a caixa de seleção Salvar alterações. Isso garante que o modelo de arquivo não seja salvo com os dados adicionados para cada funcionário.
    
    Você indicou que trabalhará com o arquivo modelo_DocAvaliaçãodeDesempenho.
Adicionar informações do arquivo do Excel com os dados do funcionário ao arquivo do Word.
1. Clique em Adicionar atividade dentro de Use Excel File, localize a atividade Replace text na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel Designer.
2. Na atividade Replace Text:
  - Clique em Mais no lado direito do campo Pesquisar por e selecione Texto. No Construtor de Texto, insira <<FullName>>.
  - Clique em Mais no lado direito do campo Substituir por e selecione Funcionário > Nome completo.
    
    Você indicou que deseja substituir o texto do espaço reservado <<FullName>> no arquivo do Word pelo nome completo que será copiado para cada funcionário a partir da célula na coluna Nome completo do arquivo do Excel Funcionários.
3. Clique em Adicionar Atividade abaixo da atividade Replace Text e localize a atividade Set Bookmark Content na caixa de pesquisa na parte superior da tela e selecione-a.A atividade será adicionada ao painel Designer.
4. Na atividade Set Bookmark Content:
  - Clique em Mais no lado direito do campo Nome do indicador e selecione Texto. No Construtor de Texto, insira DirectManager.
  - Clique em Mais no lado direito do campo Texto do indicador e selecione Funcionário > Gerente Direto.
    
    Você indicou que, para cada funcionário, deseja adicionar o nome do gerente direto ao arquivo Word, copiando o conteúdo da célula na coluna Gerente Direto do arquivo Excel Funcionários e colando-o no local do marcador GerenteDireto no arquivo do Word.
5. Repita as etapas 3 a 4 três vezes para adicionar atividades Set Bookmark Content adicionais, que adicionam o nome completo, localização e cargo de cada funcionário ao arquivo do Word. Configure cada atividade da seguinte maneira:
  - Nome do indicador FullName, Texto do indicador Funcionário > Nome completo
  - Nome do indicador Location, Nome do indicador Funcionário > Localização
  - Nome do indicador PositionTitle, Nome do indicador Funcionário > Título do cargo
Adicionar informação do arquivo Excel com dados sobre projetos ao arquivo do Word.
1. Clique em Adicionar Atividade abaixo do último Set Bookmark Content e localize a atividade Use Excel File na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel Designer.
2. Na atividade Use Excel File:
  - Clique em Mais no lado direito do campo Arquivo do Excel e selecione Texto.
    
    No Construtor de Texto:
    1. Insira o texto Files\
    2. Clique em Mais no lado direito do Construtor de Texto e selecione Funcionário > Nome completo.
    3. Insira o texto _Projects.xlsx
      O texto deve ter a seguinte aparência: Files\[Employee]FullName_Projects.xlsx.
    4. Clique em Salvar no Construtor de Texto.
  Você indicou que, para cada funcionário, deseja adicionar o arquivo do Excel Projetos à automação. Como a seleção do Arquivo do Excel é um caminho de arquivo dinâmico e você deseja poder selecionar dados nas atividades que usam os arquivos de projetos, você indicou um dos arquivos como um modelo de arquivo.
3. Clique em Adicionar Atividade dentro da atividade recém adicionada Use Excel File e localize a atividade Insert DataTable in Document na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel Designer.
4. Na atividade Insert DataTable in Document:
  - Clique em Mais no lado direito do campo Tabela a inserir e selecione Projects > Sheet1 [Sheet] > Table1 [Table].
  - No Inserir relativo a do menu suspenso, selecione Indicador.
  - Clique em Mais no lado direito do campo Indicador a pesquisar e selecione Texto. No Construtor de Texto, insira Projects.
  - No menu suspenso Posição onde inserir, selecione Depois.
  Você indicou que, para cada funcionário, deseja copiar a Tabela1 do arquivo Excel de Projetos e colá-la no arquivo Word após o indicador denominado Projetos.
Adicionar informação dos arquivos de texto com feedback do gerente ao arquivo do Word e salve um arquivo separado para cada funcionário.
1. Clique em Adicionar atividade abaixo da atividade recém-adicionada Use Excel File, em seguida localize a atividade Read Text File na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel Designer.
2. Na atividade Read Text File:
  - Clique em Mais no lado direito do campo Nome do arquivo e, em seguida, selecione Texto.
    
    No Construtor de Texto:
    1. Insira o texto Files\
    2. Clique em Mais no lado direito do Construtor de Texto e selecione Funcionário > Nome completo.
    3. Insira o texto _ManagerFeedback.txt
      O texto deve ter a seguinte aparência: Files\[Employee]FullName_ManagerFeedback.txt.
    4. Clique em Salvar no Construtor de Texto.
  - No painel Propriedades, clique em Mais no lado direito do campo Saída para e selecione Abrir no Editor avançado. Insira a expressão Saved.Values(Of String)("ManagerFeedback") e clique em OK.
  Você indicou que, para cada funcionário, deseja copiar o feedback do gerente do arquivo de texto que contém o nome do funcionário no nome do arquivo e deseja salvar o feedback para uso posterior na automação.
3. Clique em Adicionar atividade abaixo da atividade Read Text File, em seguida localize a atividade Set Bookmark Content na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel Designer.
4. Na atividade Set Bookmark Content:
  - Clique em Mais no lado direito do campo Nome do indicador e selecione Texto. No Construtor de Texto, insira DirectManagerFeedback.
  - Clique em Mais no lado direito do campo Texto do indicador e selecione Usar Valor Salvo > FeedbackdoGerente.
    
    Você indicou que, para cada funcionário, deseja copiar o feedback do gerente que salvou para uso posterior na atividade Read Text File e colá-lo no arquivo do Word no local do indicador DirectManagerFeedback.
5. Clique em Adicionar atividade abaixo da atividade Set Bookmark Content, em seguida localize a atividade Save Word File As na caixa de pesquisa na parte superior da tela e selecione-a. A atividade será adicionada ao painel Designer.
6. Na atividade Save Word File As.
  - Clique em Mais no lado direito do campo Salvar como arquivo e, em seguida, selecioneTexto.
    
    No Construtor de Texto:
    1. Insira o texto Output\
    2. Clique em Mais no lado direito do Construtor de Texto e selecione Funcionário > Nome completo.
    3. Insira o texto _PerformanceReview.docx
      
      O texto deve ter a seguinte aparência: Output\[Employee]FullName_PerformanceReview.docx.
    4. Clique em Salvar no Construtor de Texto.
  - Deixe as seleções padrão para as outras opções.
  Você indicou que deseja salvar o arquivo de modelo modificado com os dados de cada funcionário em uma nova pasta chamada Saída. O nome completo de cada funcionário será adicionado ao nome do arquivo usando o valor na coluna Nome Completo do arquivo Funcionário do Excel
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.
A automação cria documentos Word de revisão de desempenho separados para cada funcionário na pasta Saída e preenche os arquivos com informação dos arquivos do Excel com dados de funcionários e informação de projetos, e dos arquivos de texto com feedback do gerente.

Baixe o exemplo