Skip to main content

Preencher modelo de Word

Ação responsável por preencher um modelo de documento Word que possuí formatação dinâmica, ou seja, existem váriaveis dentro do documento que podem receber valores passados por parâmetros através do robô.


Atenção!

Observação: O arquivo deve estar fechado no momento da execução se não o robô será finalizado com erro de que o arquivo está ocupado.

Aviso!

Se você gerar um modelo docx com a ação e depois tentar gerar outro com o mesmo nome de arquivo, o novo modelo não será substituído. O primeiro modelo gerado será mantido. Para criar um novo modelo com o mesmo nome, você precisa excluir o primeiro arquivo salvo.

Opção​

Caminho para o modelo​

Este campo deve ser preenchido pelo usuário com o caminho completo em que o arquivo word (.docx) se encontra.

Atenção!

O caminho deve contemplar no seu final o nome exato do arquivo e a extensão conforme no exemplo abaixo.

Exemplo : C:\Users\Usuário\Downloads\arquivo.docx

Caminho para salvar arquivo preenchido​

Este campo deve ser preenchido com o caminho no qual o usuário deseja que seja criado o arquivo com o modelo preenchido.

Exemplo: C:\Users\Usuário\Downloads\arquivo_preenchido.docx

Variáveis de preenchimento​

Este campo deve retornar um JSON em que as chaves deverão ser exatamente o nome das variáveis que estão no modelo do word. Por exemplo: 

return {
    "nome": "Roberty",
    "idade": "20",
    "cidade": "Ribeirão Preto"
}

No exemplo acima, as chaves nome, idade e cidade devem estar presentes como variáveis no modelo do word passado pelo usuário, elas serão substituídas pelos valores Roberty, 20 e Ribeirão Preto respectivamente.

Para que esses valores sejam preenchidos no modelo Word é preciso utilizar uma nomenclatura específica dentro do documento. Abaixo há um exemplo de como as variáveis devem ser utilizadas dentro do template do Word:

Olá! Eu sou o +++= nome +++, tenho +++= idade +++ anos e moro na cidade de +++= cidade +++.

Quando a ação for executada, o novo documento criado será salvo com as variáveis substituídas pelos valores passados pelo usuário, nesse caso, ficaria da seguinte forma:

Olá! Eu sou o Roberty, tenho 20 anos e moro na cidade de Ribeirão Preto.

Também é possível criar diversas estruturas dentro do template .docx, como por exemplo um loop que é mostrado na imagem abaixo:

fillTemplateLoop

Para que a tabela acima seja preenchida com vários valores é preciso passar no campo variáveis de preenchimento um array de objetos, como mostrado abaixo:

return {
    pessoa: [
        {
            nome: "Roberty",
            idade: 20,
            cidade: "Ribeirão Preto"
        },
        {
            nome: "João",
            idade: 31,
            cidade: "São Paulo"
        }
    ]
}

Nesse caso, o objeto pessoa é um array com dois objetos, assim os campos nome, idade e cidade serão preenchidos com os valores passados pelo usuário.

Quando a ação for executada, o novo documento gerado ficará da seguinte forma:

fillTableWord

Além desses exemplos, há várias outras estruturas que podem ser colocadas em um template de documento Word. Para saber como utilizar mais dessas estruturas, basta acessar a documentação do docx-template.

Retornos

Essa ação não possui retornos.