---
title: "Variáveis e Condicionais em Templates do Drive"
canonical: "https://centraldeajuda.projuris.com.br/space/PE/888733697/Vari%C3%A1veis%20e%20Condicionais%20em%20Templates%20do%20Drive"
format: markdown
---
### **Contexto**
Os templates do Drive (Central de Documentos) vão além de texto reutilizável. Com **variáveis** e **blocos condicionais**, você cria um template inteligente: partes do documento são preenchidas automaticamente e trechos aparecem ou não conforme critérios que você define.
Variáveis e condicionais existem apenas em templates. Um documento comum do Drive pode ser criado, importado e editado normalmente, mas não permite essa configuração. Na prática, primeiro você cria ou seleciona um template e depois configura sua inteligência.
> ℹ️ Para aprender a criar, organizar e usar templates, consulte o artigo [https://projurishelp.atlassian.net/wiki/spaces/PE/pages/775618562](https://projurishelp.atlassian.net/wiki/spaces/PE/pages/775618562)
### **Objetivo**
Ao final deste artigo você saberá associar um contexto ao template, inserir variáveis a partir dos campos desse contexto, criar blocos condicionais com critérios e entender como o documento final é gerado.
### **Acessando o editor de templates**
Você abre o editor de templates em **Drive > aba Templates > Edição de template** (ou **Novo template**, para começar do zero).
No editor, o painel lateral reúne três ícones com os principais recursos de inteligência do template:
- **Cláusulas** — abre o Banco de cláusulas, onde você reutiliza blocos condicionais salvos em outros templates.
- **Variáveis** — mostra os campos do contexto selecionado, disponíveis para inserir no documento;
- **Condicionais** — lista os blocos condicionais já criados no template e permite editá-los;
### **Selecionando o contexto do template**
Para usar variáveis ou condicionais, o template precisa estar associado a um **contexto** do Projuris Empresas. O contexto define quais campos ficam disponíveis para variáveis e critérios das condicionais.
Um template trabalha com um único contexto. Se ele estiver associado a Contratos, você não pode misturar campos de outros contextos, como Processos ou Requisições.
Você acessa variáveis, condicionais, cláusulas e histórico pelo **painel lateral** do editor de templates.
> ⚠️ Nesta versão, o contexto disponível é **Contratos**.
### Inserindo variáveis
Uma variável é um campo do contexto que, ao gerar o documento, é substituído pelo valor correspondente. Você não precisa criar variáveis: elas já vêm dos campos do contexto selecionado.
No contexto Contratos, por exemplo, podem existir campos como:
- Nome da contraparte;
- CPF/CNPJ;
- Categoria;
- Valor;
- Data;
No painel lateral, use a busca para localizar qualquer variável do contexto e clique** sobre ela** para inseri-la na posição do cursor. O painel também mostra as variáveis já presentes no documento, na ordem em que aparecem.
Você pode usar a mesma variável várias vezes no template. Ao gerar o documento, todas as ocorrências recebem o mesmo valor.
### **Criando blocos condicionais**
Um bloco condicional é um trecho do documento, com um ou mais parágrafos, que aparece somente quando os critérios definidos forem atendidos. O bloco pode conter texto, formatação, variáveis e outros elementos aceitos pelo editor. Acesse por meio do caminho **Drive > Templates > Edição de template (ou Novo template) > Cláusulas**
Você cria um bloco condicional de duas formas:
- Selecionando um trecho existente no template e transformando-o em condicional;
- Criando um bloco em branco e preenchendo o conteúdo.
Cada bloco recebe um nome sequencial (Condicional 1, Condicional 2) que você pode renomear. Esse nome serve para organizar o template e não aparece no documento gerado. Os nomes devem ser únicos dentro do mesmo template.
Os blocos condicionais têm identificação visual no documento e também aparecem listados no painel lateral.
> ⚠️ Nesta versão, um bloco condicional não pode conter outro bloco condicional.
### **Definindo os critérios**
Para cada bloco você define quando o conteúdo deve aparecer. Um critério é formado por campo, operador e valor: ao escolher o campo aparece o operador; ao escolher o operador aparece o valor.
O tipo do campo determina quais operadores ficam disponíveis:
- número e moeda: igual, diferente, maior que, menor que, maior ou igual, menor ou igual;
- data: igual, antes de, depois de, entre;
- texto: é, não é, contém, não contém, está vazio, não está vazio;
- CPF/CNPJ: é, não é, está vazio, não está vazio;
- booleano: é verdadeiro, é falso.
> ℹ️ Um bloco pode ter mais de um critério. A partir do segundo critério, você define se o bloco aparece quando **todos** os critérios forem atendidos ou quando **qualquer um** deles for atendido.
> ⚠️ Um critério só fica completo com campo, operador e valor definidos. Enquanto houver um bloco condicional sem pelo menos um critério completo, o template não pode ser salvo e o bloco pendente será sinalizado.
### **Ações do bloco condicional**
- **Copiar bloco** — Duplica o bloco condicional com todo o seu conteúdo e critérios, pronto para colar em outro ponto do template.
- **Renomear** — Altera o nome do bloco (ex.: "Condicional 1"), útil para identificar cada condicional pela sua função.
- **Editar critérios** — Abre as condições que determinam quando o bloco aparece no documento gerado. É onde você ajusta o "1 critério" exibido no cabeçalho.
- **Salvar no Banco de cláusulas** — Guarda o bloco no Banco de cláusulas para reutilizá-lo em outros templates sem precisar recriá-lo.
- **Excluir condicional** — Remove o bloco condicional do template.
### **Banco de cláusulas**
O Banco de cláusulas reúne blocos condicionais reutilizáveis entre diferentes templates do Drive, evitando que você recrie o mesmo trecho sempre que ele for necessário. Você acessa o Banco de cláusulas em **Drive > Templates > Edição de template (ou Novo template) > Cláusulas > Adicionar > Banco de Cláusulas**, no painel lateral do editor.
> ℹ️ Nesta primeira entrega, o Banco de cláusulas fica disponível apenas durante a edição ou criação de um template. A evolução prevista é disponibilizá-lo como funcionalidade independente, aplicável a qualquer documento do Drive.
Existem duas formas de adicionar uma cláusula ao Banco: salvando um bloco condicional já existente no template, pela ação **Salvar no Banco de cláusulas** descrita na seção anterior, ou criando uma cláusula diretamente no Banco, pelo botão **+ Nova**, informando um nome e o conteúdo desejado.
> ⚠️ Só é possível salvar no Banco um bloco condicional que contenha variáveis ainda não preenchidas. Se o bloco tiver dados de um cliente específico já mesclados, o sistema alerta você antes de confirmar o salvamento.
No Banco de cláusulas, use o campo de busca para localizar uma cláusula pelo nome. Ao selecionar uma cláusula na lista, você vê seu conteúdo completo, a autoria, a data da última atualização, o contexto vinculado e a quantidade de variáveis e critérios que ela contém antes de decidir usá-la. Para inserir a cláusula no documento, clique em **Adicionar no documento**; selecionar a cláusula na lista não a insere automaticamente.
Ao inserir uma cláusula, o editor cria uma cópia independente no ponto do cursor. Alterações feitas no documento após a inserção não afetam o conteúdo salvo no Banco, e a mesma cláusula pode ser usada em quantos documentos você precisar, sem que uma utilização interfira nas demais.
Quando a cláusula contém variáveis e critérios de um contexto compatível com o template de destino, eles são preservados junto com o conteúdo, incluindo critérios agrupados por "algum" ou "todos". Se o contexto da cláusula não for compatível com o template de destino, o sistema não insere o conteúdo como texto incondicional: ele sinaliza a incompatibilidade antes da inserção.
> ℹ️ Excluir uma cláusula do Banco não remove o conteúdo já inserido em documentos existentes; apenas impede que ela seja usada em novas inserções.
### **Como o documento é gerado**
Ao gerar um documento a partir do template, o sistema substitui as variáveis pelos valores correspondentes, mantém os blocos cujos critérios foram atendidos e remove os blocos cujos critérios não foram atendidos. Quando um bloco é removido, ele não deixa espaços, marcadores ou linhas em branco no documento final.
Se um critério depende de um campo sem valor, ele é considerado não atendido e a geração continua. Antes de concluir, o sistema avisa caso algum conteúdo tenha sido retirado por falta de informação.
### **Histórico e permissões**
As alterações na configuração do template ficam registradas no histórico, com autor e data: inclusão ou remoção de variável, criação de condicional, alteração de critérios, renomeação e exclusão.
Configurar variáveis e condicionais requer permissão para editar templates no Drive. A geração de documentos a partir do template segue as permissões normais do Drive e do contexto relacionado.
### **Perguntas frequentes**
Para quais informações as variáveis funcionam?
No momento, as variáveis funcionam apenas com o contexto Contratos. Cada template é associado a um único contexto, e as variáveis disponíveis para esse template vêm somente dos campos de Contratos. Informações de outras áreas do sistema, como as de Requisições, ainda não podem ser usadas em variáveis.
As variáveis funcionam em qualquer documento do Drive?
Não. Variáveis e blocos condicionais funcionam somente dentro de um template. Um documento comum não aceita essa configuração. Para usar esses recursos, primeiro transforme o documento em um template ou crie um template novo. Veja como fazer isso no artigo sobre como criar, organizar e usar templates.
Como a variável é posicionada e formatada no texto?
A variável é inserida exatamente na posição em que está o cursor. Depois de inserida, ela segue a formatação do texto ao redor, como fonte e tamanho, e pode ser formatada como qualquer outro trecho do documento.
Como as informações são preenchidas quando eu uso o template em um contrato?
Ao usar o template dentro de um contrato, o sistema substitui cada variável pelas informações daquele contrato. Se a mesma variável aparece mais de uma vez no template, todas as repetições recebem o mesmo valor. Os blocos condicionais também são avaliados com as informações desse contrato, por isso o mesmo template pode gerar documentos diferentes dependendo do contrato utilizado.
Os documentos que eu crio no Drive ficam visíveis para toda a minha equipe?
Ainda não. Cada pessoa visualiza apenas os documentos que ela mesma criou. A exceção são os templates, que ficam visíveis para todos os usuários da empresa.
Onde encontro o Banco de cláusulas e ele funciona em qualquer documento?
Você acessa o Banco de cláusulas em **Drive > Templates > Edição de template (ou Novo template) > Cláusulas > Adicionar > Banco de Cláusulas, n**o painel lateral do editor. Nesta primeira entrega, ele fica disponível apenas durante a edição ou criação de templates. A evolução prevista é disponibilizá-lo como funcionalidade independente, aplicável a qualquer documento do Drive.