Bem-vindo à Página de Modelos da Clicksign!

Aqui, você terá a possibilidade de criar seus próprios modelos criados em Microsoft Word. Esses modelos serão predefinições que você poderá utilizar como base para criar novos documentos de maneira rápida e eficiente. Confira mais em nossa página de Ajuda.

Com esta funcionalidade, você poderá utilizar templates criados em Microsoft Word para criação automática de documentos baseados em metadados. Confira mais em nossa página de Ajuda.

Endpoints Disponíveis:

1. Consultar Modelos:

• Método: GET
• Endpoint: /templates
• Descrição: Lista todos os Modelos cadastrados na conta.
• URL: Página de Referência.

2. Criar Modelo:

• Método: POST
• Endpoint: /templates
• Descrição: Criar um Modelo.
• URL: Página de Referência.

3. Editar Modelo:

• Método: PATCH
• Endpoint: /templates/{id}
• Descrição: Atualiza os detalhes de um Modelo existente.
• URL: Página de Referência.

4. Visualizar Modelo:

• Método: GET
• Endpoint: /templates/{id}
• Descrição: Recupera os detalhes de um Modelo.
• URL: Página de Referência.

5. Excluir Modelo:

• Método: DELETE
• Endpoint: /templates/{id}
• Descrição: Exclui permanentemente um Modelo.
• URL: Página de Referência.

Referência: Geração de Tabelas

Este documento é a referência técnica completa para a funcionalidade de geração de tabelas em modelos.

Método 1: Tabelas Automáticas

Use este método quando precisar de máxima flexibilidade para definir cabeçalhos, dados, larguras de coluna e estilos diretamente a partir dos seus dados.

1.1. Sintaxe no Template

Para inserir uma tabela automática, adicione a seguinte tag no seu arquivo .docx:

{{:table nome_da_sua_tabela}}

O nome_da_sua_tabela será a chave principal do objeto JSON que conterá os dados e as configurações da tabela.

1.2. Estrutura do Objeto JSON

O JSON correspondente deve ter uma chave com o mesmo nome definido na tag. Exemplo de JSON Mínimo:

{
  "data": {
    "nome_da_sua_tabela": {
      "header": ["Produto", "Quantidade", "Preço Unitário"],
      "data": [
        ["Caneta Azul", "10", "R$ 2,50"],
        ["Caderno 96fls", "5", "R$ 15,00"]
      ]
    }
  }
}

1.3. Parâmetros

A seguir estão todos os parâmetros disponíveis para configurar sua tabela.

1.4. O Objeto style

O objeto style permite customizar a aparência da tabela. Você pode aplicar estilos para as seções header, subheader e data.

1.5. Exemplo Completo

Este exemplo combina vários parâmetros para criar uma tabela estilizada.

Template (.docx): {{:table relatorio_vendas}} JSON:

{
  "data": {
    "relatorio_vendas": {
      "header": ["Produto", "Qtd", "Preço", "Total"],
      "subheader": ["Item", "Un", "R$", "R$"],
      "totalWidth": "100%",
      "widths": ["40", "20", "20", "20"],
      "data": [
        ["Lápis Grafite", "100", "0.50", "50.00"],
        ["Borracha Branca", "30", "1.00", "30.00"]
      ],
      "style": {
        "header": { "textAlign": "center", "verticalAlign": "center", "shade": "F47B20" },
        "subheader": { "textAlign": "center", "shade": "FBB784" },
        "data": { "textAlign": "left", "verticalAlign": "center" }
      }
    }
  }
}

Método 2: Tabelas em Loop

Use este método para preencher uma tabela com estrutura fixa, repetindo as linhas para cada item de um array.

2.1. Estrutura no Template

Crie a tabela diretamente no seu arquivo .docx com uma linha de cabeçalho e uma linha de exemplo para os dados. Envolva a linha de dados com as tags de loop.

Exemplo de estrutura no .docx:

• {{#pessoas}}: Inicia o loop no array chamado pessoas.
• {{Nome}}, {{Idade}}, {{Cidade}}: Variáveis que serão preenchidas com os dados de cada objeto do array.
• {{/pessoas}}: Fecha o loop.

2.2. Estrutura do JSON

O JSON deve conter um array de objetos. O nome do array (pessoas, no exemplo) deve corresponder ao nome usado nas tags de loop.

  "data": {
    "pessoas": [
      { "Nome": "Paulo Oliveira", "Idade": "29", "Cidade": "Porto Alegre" },
      { "Nome": "Isabela Lima", "Idade": "35", "Cidade": "Curitiba" }
    ]
  }
}

O resultado será uma tabela com duas linhas de dados, preenchidas com as informações do array pessoas.