Anotações

Campo destinado a exibir e registrar informações textuais, como instruções, observações ou conteúdos informativos em formulários e tarefas.
Atualizado

Configure campos de anotações para registros textuais livres

O campo do tipo Anotações é utilizado para adicionar conteúdos textuais informativos ou observacionais em formulários, tarefas e telas do ENSPACE.

Ele permite que o usuário registre blocos de texto explicativo, instruções, lembretes ou títulos intermediários diretamente no contexto de um item. O conteúdo é variável por item, ou seja, cada registro possui suas próprias anotações independentes.


Quando usar este campo

Utilize o campo Anotações quando precisar de um espaço livre para registros textuais dentro de um item.

Ele é ideal para:

  • Inserir avisos, lembretes ou instruções ao longo de um processo
  • Registrar observações pontuais sobre o andamento de uma tarefa
  • Adicionar notas de acompanhamento ou esclarecimentos
  • Exibir conteúdos informativos que não demandam campos estruturados
  • Qualquer contexto que exija texto livre vinculado ao item
O campo Anotações não possui validação de formato ou estrutura. Avalie a necessidade de campos obrigatórios ou padrão quando a informação for crítica para o processo.

Informações básicas do campo

Todo campo no ENSPACE possui quatro informações básicas que são definidas no momento da criação:

  • Nome do campo — nome interno utilizado nas configurações da categoria. Possui limite de 31 caracteres. Não é necessariamente o nome exibido para o usuário final.
  • Rótulo Visível (Label) — nome exibido para os usuários em formulários, tarefas e telas. Possui limite de 255 caracteres. Pode ser mais descritivo que o nome interno e pode ser alterado posteriormente sem impactar automações ou referências técnicas.
  • Referência técnica — identificador técnico do campo, gerado automaticamente em formato snake_case. É utilizado em expressões, variáveis, fluxos, automações e referências internas.
  • Descrição — descrição interna para adicionar contexto ao campo. Ajuda configuradores a entenderem a finalidade do campo e auxilia recursos de IA do ENSPACE durante pesquisas e interpretações automáticas.
Após salvar o campo pela primeira vez, a referência técnica não poderá ser alterada.

Como o campo funciona

Em programação, uma anotação é um tipo de dado textual livre (string) vinculado a um registro específico. Diferente de campos de conteúdo fixo definidos na configuração, o valor é preenchido e editado individualmente em cada item.

O campo Anotações funciona como um espaço de texto livre associado a cada item do sistema.

O usuário digita o conteúdo diretamente no formulário ou tarefa. O valor é salvo individualmente por item, permitindo que cada registro possua suas próprias observações, independentes dos demais. O campo aceita texto simples e pode conter formatação básica, links e referências conforme a interface de preenchimento.

As configurações aplicadas definem apenas o rótulo e a referência técnica. O conteúdo em si é definido pelo usuário no momento do preenchimento do item.


Como configurar

Crie um novo campo

Acesse Configurações > Categorias > Campos e clique em Criar.

Preencha as informações básicas

Defina o nome do campo, a referência técnica, o rótulo visível (Label) e selecione o tipo Anotações.

Salve o campo

Após salvar, o campo poderá ser utilizado em formulários, tarefas e telas.


Comportamento dos dados

Algumas características do campo afetam a experiência de uso:

  • O conteúdo do campo é variável por item: cada registro possui suas próprias anotações, independentes dos demais.
  • Alterar o nome ou o rótulo do campo não afeta o conteúdo já preenchido em itens existentes.
  • O campo não possui valor inicial automático; é preenchido manualmente pelo usuário em cada item.
  • O conteúdo pode ser editado a qualquer momento durante a vida do item, salvo restrições de permissão ou somente leitura aplicadas ao formulário.
  • Os dados anteriores só serão alterados caso sejam editados novamente.

Boas práticas

  • Utilize o campo Anotações para registros pontuais que não se encaixem em campos estruturados, como justificativas temporárias ou observações de acompanhamento.
  • Prefira campos específicos (Texto Curto, Texto Longo, Seleção) quando a informação precisar ser padronizada, filtrada ou utilizada em automações.
  • Evite armazenar dados sensíveis ou sigilosos em anotações se o item for acessível a múltiplos usuários.
  • Combine o campo Anotações com Regras e Condições ou Eventos de Campo quando for necessário exibir anotações condicionalmente.