Notação de Acesso

Aprenda a acessar dados dos campos do ENSPACE

Sempre que você precisa referenciar o valor de um campo — seja em uma expressão, template de documento, condicional ou evento em campo — você usa uma notação de acesso. Essa notação é o caminho que indica ao sistema exatamente qual dado você quer.

Esta página explica os três padrões de acesso disponíveis no ENSPACE e como combiná-los para alcançar qualquer informação armazenada nos seus campos.

O ponto de partida: data

Todo acesso a dados de um item começa pelo prefixo data. Ele representa o conjunto de campos do item atual. A partir dele, você navega até o campo desejado usando a referência que foi definida na configuração do tipo.

Por exemplo, se o tipo possui um campo de texto curto com a referência nome, o caminho completo para acessar seu valor é:

data.nome

Dentro de templates e expressões, esse caminho é envolvido por chaves duplas para que o sistema interprete e substitua pelo valor real:

{{data.nome}}

O resultado seria o conteúdo do campo — por exemplo, "João Silva".

Notação de ponto

A notação de ponto permite acessar propriedades dentro de campos que armazenam objetos (campos complexos como valor monetário, endereço, pessoa/empresa, documento, etc.). Cada ponto representa um nível de profundidade dentro do objeto.

Sintaxe: data.campo.propriedade

Exemplo prático — um campo de valor monetário com referência valor:

Quando o objeto tem múltiplos níveis de profundidade, basta encadear os pontos. Por exemplo, para acessar o código do índice de correção monetária dentro de um campo valor:

{{data.valor.config.correction.periods[0].indexCode}}

Nesse caminho, cada segmento separado por ponto entra um nível mais fundo no objeto: data → valor → config → correction → periods → primeiro item → indexCode.

Outros exemplos:

Notação de colchete

A notação de colchete permite acessar itens específicos dentro de campos que armazenam listas (campos como seleção múltipla, relacionamento múltiplo, arquivos, repetidor, anotações, chat, etc.). O número entre colchetes indica a posição do item na lista, começando do zero.

Sintaxe: data.campo[posição]

Exemplo prático — um campo de seleção múltipla com referência departamentos contendo ["Financeiro", "Jurídico", "Compliance"]:

Para listas que contêm objetos (como arquivos, relacionamentos ou anotações), combine a notação de colchete com a notação de ponto para acessar propriedades específicas de cada item:

Exemplo — um campo de arquivos com referência anexos:

Outros exemplos:

Contagem de itens

Para saber quantos itens existem dentro de uma lista, use .length ao final do caminho do campo.

Sintaxe: data.campo.length

Combinando as notações

Na prática, os três padrões se combinam livremente para acessar qualquer dado, por mais aninhado que seja. Leia o caminho da esquerda para a direita como uma sequência de instruções:

{{data.valor.config.correction.periods[0].indexCode}}

Passo a passo:

1. data — parta do item atual.
2. .valor — entre no campo valor (um objeto de valor monetário).
3. .config — acesse a propriedade config dentro dele.
4. .correction — entre no subobjeto correction.
5. .periods — acesse a lista de períodos de correção.
6. [0] — selecione o primeiro período da lista.
7. .indexCode — acesse o código do índice desse período.

Mais exemplos de caminhos combinados:

Resumo rápido