Leitura e escrita de documentos Word
Word (DOCX)word.open_documentAbre arquivo .docx
Abre um arquivo .docx e guarda o documento na variável usada pelos demais comandos. Não precisa do Word instalado.
Exemplo: Abra C:\Modelos\contrato.docx em {document}.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Arquivo Word * | Arquivo | ||
| Salvar resultado na variável * | Variável de saída | document |
Resultado: guardado na variável document (Objeto).
word.create_documentCria novo documento Word
Cria um documento novo, em branco ou a partir de um modelo .docx (que traz estilos, cabeçalho e rodapé).
Exemplo: Crie {document} a partir de modelo_relatorio.docx.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Modelo (opcional) | Arquivo | ||
| Salvar resultado na variável * | Variável de saída | document |
Resultado: guardado na variável document (Objeto).
word.add_paragraphAdiciona texto com estilo
Acrescenta um parágrafo ao fim do documento com estilo (título, subtítulos, lista, citação), negrito, itálico, tamanho e alinhamento.
Exemplo: Adicione "Relatório de {mes}" com o estilo title e centralizado.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Documento * | Variável | document | |
| Texto * | Texto (várias linhas) | ||
| Estilo | Opção | Normal | Opções: Normal, Título, Título 1, Título 2, Título 3, Lista com marcadores, Lista numerada, Citação |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Negrito | Sim/Não | Não | |
| Itálico | Sim/Não | Não | |
| Tamanho da fonte (vazio = do estilo) | Número | ||
| Alinhamento | Opção | Esquerda | Opções: Esquerda, Centro, Direita, Justificado |
word.add_tableInsere tabela
Insere uma tabela a partir de uma lista de linhas ou tabela de dados (DataFrame), com a primeira linha como cabeçalho e um estilo do Word.
Exemplo: Adicione {df_resumo} como tabela com o estilo Table Grid.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Documento * | Variável | document | |
| Dados * | Texto | DataFrame, lista de dicionários ou lista de listasEx.: {df} | |
| Primeira linha com o cabeçalho | Sim/Não | Sim |
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Estilo da tabela | Texto | Table Grid |
word.add_imageInsere imagem no documento
Insere uma imagem no fim do documento, com largura opcional em centímetros.
Exemplo: Adicione grafico.png com 15 cm de largura.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Documento * | Variável | document | |
| Imagem * | Arquivo | ||
| Largura (vazio = original) | Número |
word.read_paragraphsLê todos os parágrafos
Lê os parágrafos do documento como lista ou como um texto único.
Exemplo: Leia os parágrafos de {document} como texto e procure a cláusula de vigência.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Documento * | Variável | document | |
| Retornar | Opção | Lista de parágrafos | Opções: Lista de parágrafos, Todo o texto (um parágrafo por linha) |
| Incluir parágrafos vazios | Sim/Não | Não | |
| Salvar resultado na variável * | Variável de saída | paragraphs |
Resultado: guardado na variável paragraphs (Qualquer).
word.read_tablesLê dados das tabelas
Lê uma tabela do documento (ou todas) como lista de linhas ou de dicionários pelo cabeçalho.
Exemplo: Leia a tabela 1 de {document} como records e percorra os itens do pedido.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Documento * | Variável | document | |
| Número da tabela (1 = primeira; 0 = todas) | Número | 1 | |
| Formato | Opção | Lista de linhas ([[...], ...]) | Opções: Lista de linhas ([[...], ...]), Dicionários usando a 1ª linha como cabeçalho |
| Salvar resultado na variável * | Variável de saída | table |
Resultado: guardado na variável table (Lista).
word.find_replaceBusca e substitui texto
Troca textos no documento inteiro (inclusive tabelas, cabeçalho e rodapé), como preencher marcadores de um modelo, e pode guardar quantas trocas fez.
Exemplo: Troque [NOME] por {cliente} e [DATA] por {data_hoje} no modelo do contrato.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Documento * | Variável | document | |
| Procurar → substituir por * | Pares chave e valor | Vale também em tabelas, cabeçalhos e rodapés. Ótimo para preencher modelos: [NOME] → {nome} | |
| Salvar o nº de substituições na variável | Variável de saída |
Resultado: guardado na variável escolhida (Número).
word.save_documentSalva o documento
Salva o documento no mesmo arquivo ou num novo caminho.
Exemplo: Salve como C:\Contratos\contrato_{cliente}.docx.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Documento * | Variável | document | |
| Salvar como (vazio = o mesmo arquivo) | Arquivo |
word.convert_to_pdfConverte DOCX para PDF (requer Word instalado)
Converte um .docx em PDF usando o Word instalado na máquina, mantendo a formatação.
Exemplo: Converta contrato_{cliente}.docx em PDF para enviar ao cliente.
| Campo | Tipo | Padrão | Detalhes |
|---|---|---|---|
| Arquivo Word (.docx) * | Arquivo | ||
| Arquivo PDF (vazio = mesmo nome) | Arquivo | ||
| Salvar o caminho do PDF na variável | Variável de saída |
Resultado: guardado na variável escolhida (Texto).