Variáveis e Formatação

Use variáveis para personalizar seus dados

O ENSPACE permite utilizar variáveis para inserir dinamicamente os valores dos campos dos seus itens em diversos contextos da plataforma. Com elas, você pode exibir informações e formatar dados automaticamente.

As variáveis podem ser utilizadas em qualquer contexto que aceite campos dinâmicos — entre eles: título e descrição de tarefas (agendadas e rápidas), templates de documento, modelos de e-mail, formato de exibição na configuração de campos (ex: display de campo de relacionamento), colunas de expressão em relatórios e construtores de condicionais.

Sintaxe básica

A sintaxe para inserir o valor de um campo é:

{{ data.referencia_do_campo }}

Nesse caso, se um campo foi criado com o nome "Data de vencimento", a referência será:

{{ data.data_de_vencimento }}

A referência de cada campo pode ser consultada na tela de configuração de campos, na coluna Referência. Ela segue o formato snake_case baseado no nome do campo.

Fallback com pipe (|)

Você pode definir múltiplas opções dentro de uma variável usando o operador |.

O sistema tentará resolver da esquerda para a direita, retornando o primeiro valor disponível.

Valor padrão vazio

O valor padrão de um encadeamento pode ser vazio. Use essa forma quando o campo pode não estar preenchido e você prefere que nada apareça no lugar dele, em vez do indicador de valor vazio.

Três formas são aceitas e têm o mesmo efeito:

Com o campo vazio, as três retornam uma string vazia: sem o indicador --, sem espaço e sem nenhum outro caractere. Com o campo preenchido, o valor do campo prevalece, como em qualquer encadeamento com |.

Variáveis disponíveis para itens

Variáveis padrão do item (metadados)

Sempre que você estiver trabalhando com um item de uma categoria, o ENSPACE disponibiliza automaticamente algumas variáveis para acessar seus dados.

Variáveis de campos personalizados

Os campos que você cria (como nome, valor, data, status, etc.) ficam dentro de data.

Para acessar um campo, use:

{{ data.nome_do_campo }}

Se um campo referenciado não existir ou estiver vazio, o sistema exibirá -- como indicador de valor vazio. Esse indicador é de exibição em tela: em um arquivo extraído de relatório, o mesmo campo sai em branco. Para não exibir o indicador, defina um valor padrão vazio no encadeamento.

Formatação de dados

Após montar suas variáveis, você pode formatar como os valores serão exibidos. O ENSPACE oferece duas sintaxes para formatação: Sufixo e Função.

Use Sufixo para formatar um campo sozinho. Use Função quando precisar combinar com expressões ou aplicar múltiplas configurações.

Sintaxe com sufixo (__mod[])

Ideal para formatar campos individuais, sem necessidade de expressões.

Estrutura: {{ variavel__mod[format?parametro1=valor1&parametro2=valor2] }}

Detalhamento:

Exemplos:

Sintaxe com função format()

Recomendada quando você precisa:

• formatar resultados de expressões
• aplicar múltiplas configurações
• trabalhar com estruturas mais complexas

Estrutura: format(VALOR, {"parametro": "valor"})

Detalhamento:

Exemplos:

Comparação entre as sintaxes

Parâmetros de formatação

Os parâmetros de formatação definem como o valor será exibido — por exemplo:

• como número, data ou texto
• com moeda, percentual ou casas decimais
• com formato curto ou completo

Você pode usar esses parâmetros tanto no sufixo (__mod[]) quanto na função format().

Parâmetros gerais

Esses parâmetros são a base de qualquer formatação.

Parâmetros para datas (type="date")

Controlam como datas e horários são exibidos.

Exemplos:

• Data completa: {{ data.custom_due_date__mod[format?type=date&d_style=full] }}
• Data e hora: {{ data.server_time__mod[format?type=date&d_style=medium&dt_style=short] }}

Parâmetros para números (type="number")

Controlam como valores numéricos são exibidos.

Exemplos:

• Dólar: {{ data.preco__mod[format?type=number&n_style=currency&n_currency=USD] }}
• Percentual: {{ data.taxa__mod[format?type=number&n_style=percent&n_minimumFractionDigits=2] }}
• Multiplicador: {{ data.tempo__mod[format?type=number&n_multiplier=60] }}

Parâmetros para texto (type="text")

Usados para limitar ou ajustar textos.

Exemplo: {{ data.descricao__mod[format?type=text&t_length=20&t_suffix="..."] }}

Parâmetros para listas (type="list")

Usados para exibir listas de itens.

value_path é obrigatório para listas.

Exemplo: {{ data.produtos__mod[format?type=list&value_path=name&l_separator=", "] }}

Parâmetros para type="object"

Usados para definir como objetos serão exibidos.

Um objeto é um conjunto de dados estruturados (com múltiplos campos), como por exemplo um item de relacionamento ou um registro com várias propriedades.

Modificador transformText

O modificador transformText permite alterar o formato de textos automaticamente, como:

• mudar para maiúsculas ou minúsculas
• remover espaços ou acentos
• converter para formatos como slug, camelCase, snake_case

Opções disponíveis

Exemplos:

Encadeando format com transformText

Você pode combinar format com transformText usando pipe (|).

Nesse caso:

1. o format é aplicado primeiro
2. o transformText transforma o resultado

Guia rápido de decisão

Erros comuns

Quantidade incorreta de chaves

• Errado: { data.campo }, {{{ data.campo }}}, {{ data.campo }
• Correto: {{ data.campo }} — sempre duas chaves de cada lado.

Parênteses não fechados

• Errado: format(math({{a}} + {{b}}), {"type":"number"}
• Correto: format(math({{a}} + {{b}}), {"type":"number"})

Aspas no JSON

• Errado: format({{data.valor}}, {type: number})
• Correto: format({{data.valor}}, {"type": "number"})

Misturar sintaxes

• Errado: {{ data.valor__mod[format?type=number] }}({"n_style":"currency"})
• Correto: escolha uma das duas sintaxes

Esquecer value_path em listas

• Errado: {{ data.produtos__mod[format?type=list&l_separator=", "] }}
• Correto: {{ data.produtos__mod[format?type=list&value_path=name&l_separator=", "] }}

Expressões

Para aprender como criar expressões matemáticas, textuais ou de data utilizando variáveis e formatação, consulte a documentação de Expressões