JSON
Introdução
No NocoBase, JSON (JSON) é usado para armazenar dados estruturados ou semiestruturados.
Os campos JSON são adequados para armazenar trechos de respostas de APIs externas, configurações de extensão, propriedades dinâmicas e outros dados cuja estrutura não é fixa. Eles são flexíveis, mas menos fáceis de filtrar, validar e exibir do que os campos comuns.
Se a estrutura do campo for estável, prefira dividi-la em campos específicos, facilitando a configuração de páginas, as permissões, os filtros e o uso em fluxos de trabalho.
Cenários de uso
O JSON é adequado para estes cenários de negócio:
- Respostas brutas de APIs externas
- Propriedades de extensão dinâmicas
- Objetos de configuração complexos
- Armazenamento temporário de dados que não podem ser divididos em uma estrutura organizada
Configuração de criação
Na página «Configure fields» da tabela de dados, clique em «Add field» e selecione «JSON» para criar um campo JSON.
O nome do campo será referenciado por blocos de página, permissões, fluxos de trabalho e APIs. Confirme a nomenclatura antes da criação para evitar custos de ajustes posteriores na configuração.
Características do campo
O comportamento padrão dos campos JSON é o seguinte:
Configuração de edição
Após a criação, clique em «Edit» à direita do campo para editar a configuração do campo JSON. A edição do campo é usada principalmente para ajustar a forma como ele é exibido e utilizado no NocoBase, como alterar o nome exibido, a descrição, o valor padrão, as regras de validação ou as configurações específicas do campo.
Se o campo vier de uma tabela já sincronizada no banco de dados principal, a edição normalmente consiste em fazer o mapeamento do campo — mapear o campo do banco de dados para o Field type e o Field interface do NocoBase.
Alternar o Field type ou o Field interface não equivale a simplesmente alterar um nome exibido. Isso afeta a forma de armazenamento do campo, o componente de entrada, as regras de validação, as condições de filtro e a forma de uso das variáveis em fluxos de trabalho. Quando houver muitos dados existentes, confirme primeiro se o formato dos dados é compatível.
Exclusão de campos
Clique em «Delete» à direita do campo para excluir o campo JSON. No banco de dados principal, também é possível selecionar vários campos e excluí-los em massa.
Ao excluir um campo JSON criado no banco de dados principal, normalmente a coluna correspondente no banco de dados e os dados já existentes nessa coluna também são excluídos. Ao excluir um campo sincronizado do banco de dados ou mapeado de uma fonte de dados externa, o impacto depende da fonte de dados e da origem do campo correspondente.
A exclusão de um campo pode afetar blocos de página, formulários, filtros, permissões, fluxos de trabalho, APIs, importações e exportações, além dos dados existentes. Antes de excluir, confirme se o campo ainda é referenciado por alguma configuração de negócio.
Uso na configuração de páginas
Os campos JSON são adequados para cenários de integração e configurações de extensão.
Links relacionados
- Campos — Saiba mais sobre a finalidade, a classificação e a lógica de mapeamento dos campos
- Tabela comum — Criar e gerenciar campos em uma tabela comum
- Texto multilinha — Armazenar textos longos sem formatação
- Fórmula — Calcular resultados com base em campos