Fórmula

Introdução

No NocoBase, fórmula (Formula) é usada para calcular valores de campos com base em expressões.

Os campos de fórmula são adequados para cenários como cálculos de valores, pontuações, concatenação de textos e cálculos condicionais. Seus valores geralmente são gerados por expressões, não sendo adequados para inserção manual direta.

Se o resultado precisar ser preenchido manualmente, escolha o campo básico correspondente. Se a lógica de cálculo for muito complexa, considere usar um fluxo de trabalho ou uma visualização de banco de dados.

Cenários aplicáveis

As fórmulas são adequadas para estes cenários de negócio:

  • Subtotal do pedido e valor com impostos
  • Pontuação, pontuação ponderada e pontuação de desempenho
  • Nome de exibição após concatenação de textos
  • Resultados de negócio calculados com base em condições

Configuração de criação

Na página 「Configure fields」 da tabela de dados, clique em 「Add field」 e selecione 「Fórmula」 para criar um campo de fórmula.

20240512173541

ConfiguraçãoDescrição
Field interfaceTipo de interface do campo. A fórmula corresponde a formula, que determina como o campo será preenchido e exibido na página.
Field display nameNome exibido do campo na interface, como 「Subtotal do pedido」, 「Pontuação geral」 e 「Nome de exibição」. Recomenda-se usar um nome que os usuários de negócio possam entender diretamente.
Field nameNome identificador do campo, usado para referências internas em APIs, campos de relação, permissões, fluxos de trabalho etc. Normalmente não é alterado após a criação; aceita apenas letras, números e sublinhados e deve começar com uma letra.
Field typeTipo do campo na camada de dados. Os campos de fórmula usam formula; o tipo do resultado depende da configuração da fórmula.
Default valueValor padrão. Ao adicionar um registro, se o usuário não preencher o campo, o valor padrão poderá ser preenchido automaticamente.
Validation rulesRegras de validação. O foco está em verificar se a expressão da fórmula está completa e se os campos referenciados existem.
DescriptionDescrição do campo. É adequada para registrar o significado do campo, os requisitos de preenchimento, a origem dos dados ou o responsável pela manutenção.
Atenção

Depois de criado, 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 de configuração posteriormente.

Características do campo

O comportamento padrão dos campos de fórmula é o seguinte:

CaracterísticaDescrição
Default Field interfaceformula.
Default Field typeformula.
Field type opcionalformula.
Componente da páginaNo modo de edição, normalmente é configurada a expressão da fórmula; no modo de leitura, o resultado calculado é exibido.
FiltroA possibilidade de filtrar depende do resultado da fórmula e do modo de execução.
OrdenaçãoA possibilidade de ordenar depende do resultado da fórmula e do modo de execução.
ValidaçãoDepende da expressão da fórmula e do tipo do resultado.

Configuração de edição

Após a criação, clique em 「Edit」 à direita do campo para editar a configuração do campo de fórmula. A edição do campo é usada principalmente para ajustar sua forma de exibição e utilização no NocoBase, como modificar o nome de exibição, 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 do banco de dados principal que já foi sincronizada, a edição normalmente consiste em fazer um mapeamento de campo — mapear o campo do banco de dados para o Field type e o Field interface do NocoBase.

ConfiguraçãoPode ser editadaDescrição
Field display nameSimModifica o nome exibido do campo na interface, sem alterar o nome identificador do campo.
Field nameNãoNormalmente, o nome identificador do campo não pode ser modificado no formulário de edição após a criação.
Field interfaceSuporte condicionalOs campos do banco de dados principal ou os campos sincronizados podem ser ajustados durante o mapeamento. O ajuste afetará a forma de entrada, exibição e validação na página.
Field typeSuporte condicionalOs campos do banco de dados principal ou os campos sincronizados podem ser ajustados durante o mapeamento. Antes do ajuste, é necessário confirmar se os dados existentes poderão ser usados com o novo tipo.
Default valueSimAjusta o valor padrão ao adicionar novos registros.
Validation rulesSimAjusta as regras de validação do campo.
DescriptionSimComplementa o significado do campo, os requisitos de preenchimento, a origem dos dados ou o responsável pela manutenção.
Atenção

Alternar o Field type ou o Field interface não equivale a simplesmente alterar um nome de exibição. Isso afetará a forma de armazenamento do campo, o componente de entrada, as regras de validação, as condições de filtragem e a forma de utilização das variáveis em fluxos de trabalho. Quando houver muitos dados existentes, confirme primeiro se o formato dos dados é compatível.

Excluir campo

Clique em 「Delete」 à direita do campo para excluir o campo de fórmula. No banco de dados principal, também é possível selecionar vários campos e excluí-los em lote.

Ao excluir um campo de fórmula criado no banco de dados principal, normalmente a coluna real correspondente no banco de dados e os dados já existentes nessa coluna também serão excluídos. Ao excluir um campo sincronizado do banco de dados ou mapeado de uma fonte de dados externa, o impacto dependerá da fonte de dados e da origem do campo correspondente.

Aviso

A exclusão de um campo pode afetar blocos de página, formulários, filtros, permissões, fluxos de trabalho, APIs, importações, exportações e dados existentes. Antes de excluir, confirme se o campo ainda é referenciado por configurações de negócio.

Uso na configuração de páginas

Os campos de fórmula são adequados para exibir resultados calculados em tabelas, detalhes, estatísticas e fluxos de trabalho. 20260710151619

CenárioUso
Configuração do campoEscrever expressões de fórmula e selecionar os campos referenciados.
Bloco de tabelaExibir resultados calculados.
Bloco de detalhesExibir o resultado calculado de um único registro.
Fluxo de trabalhoLer o resultado da fórmula para participar de decisões posteriores.
  • Campo — Entenda a função, a classificação e a lógica de mapeamento dos campos
  • Tabela comum — Criar e gerenciar campos em uma tabela comum
  • Número — Armazenar valores numéricos usados nos cálculos
  • JSON — Armazenar resultados estruturados