Região administrativa da China

Introdução

No NocoBase, Região administrativa da China (China region) é usada para armazenar informações sobre divisões administrativas chinesas, como província, cidade e distrito/condado.

O campo Região administrativa da China é baseado na tabela integrada de dados de divisões administrativas chinaRegions e usa um seletor em cascata para inserir dados na página. Os usuários podem selecionar sucessivamente a província, a cidade e o distrito por nível; na exibição, os níveis são concatenados em um caminho completo.

Para armazenar endereços detalhados, como rua e número do imóvel, o campo pode ser usado em conjunto com os campos Texto de linha única ou Texto multilinha.

Cenários de aplicação

A Região administrativa da China é adequada para estes cenários de negócio:

  • Localização de clientes, contatos, lojas e projetos
  • Informações básicas de endereço, como domicílio registrado, naturalidade e região de entrega
  • Áreas de atendimento, regiões de vendas e regiões de implementação de projetos
  • Dados que precisam ser filtrados ou agrupados por província, cidade e distrito

Criação e configuração

Na página «Configure fields» da tabela de dados, clique em «Add field» e selecione «Região administrativa da China» para criar um campo Região administrativa da China.

ConfiguraçãoDescrição
Field interfaceTipo de interface do campo. A Região administrativa da China corresponde a chinaRegion, que determina como os dados serão inseridos e exibidos na página.
Field display nameNome exibido do campo na interface, como «Região de residência», «Área de atendimento» ou «Região de entrega». Recomenda-se usar um nome que os profissionais 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 e outros recursos. 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. A Região administrativa da China geralmente é armazenada como um registro relacionado ou um valor estruturado, conforme a configuração do campo.
Nível de seleçãoControla o nível mais profundo que pode ser selecionado. Atualmente, há suporte para «província», «cidade» e «distrito», sendo «distrito» o padrão.
É obrigatório selecionar até o último nívelQuando ativado, o usuário deve selecionar até o nível mais profundo configurado para poder enviar; quando desativado, é possível concluir a seleção em um nível intermediário.
Validation rulesRegras de validação. Normalmente, são configurados a obrigatoriedade e o nível de seleção.
DescriptionDescrição do campo. É adequada para indicar o significado do campo, os requisitos de preenchimento, a fonte dos dados ou o responsável pela manutenção.
Atenção

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 do campo Região administrativa da China é o seguinte:

CaracterísticaDescrição
Field interface padrãochinaRegion.
Fonte dos dadosTabela integrada de dados de divisões administrativas chinaRegions.
Componente da páginaO modo de edição usa um seletor em cascata.
Nível de seleçãoAtualmente, há suporte para os três níveis: província, cidade e distrito.
Forma de exibiçãoNo modo de leitura, os níveis são exibidos como 省 / 市 / 区.
FiltragemPermite filtrar pelos valores de região salvos; os recursos específicos dependem da configuração do campo e do bloco da página.
Seleção múltiplaA seleção múltipla não é compatível.

Edição da configuração

Após a criação, clique em «Edit» à direita do campo para editar a configuração do campo Região administrativa da China. A edição do campo é usada principalmente para ajustar a forma como ele é exibido e utilizado no NocoBase, por exemplo, para alterar o nome exibido, a descrição, as regras de validação, o nível de seleção ou a obrigatoriedade de selecionar até o último nível.

Se o campo vier de uma tabela já sincronizada no banco de dados principal, 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 nameSimAltera 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 alterado no formulário de edição após a criação.
Field interfaceCom suporte condicionalCampos do banco de dados principal ou campos sincronizados podem ser ajustados durante o mapeamento de campos. O ajuste afetará a forma de entrada, exibição e validação na página.
Field typeCom suporte condicionalCampos do banco de dados principal ou campos sincronizados podem ser ajustados durante o mapeamento de campos. Antes do ajuste, confirme se os dados existentes poderão ser usados com o novo tipo.
Nível de seleçãoSimAjusta se o campo pode selecionar até província, cidade ou distrito.
É obrigatório selecionar até o último nívelSimControla se é obrigatório selecionar até o nível mais profundo configurado no momento do envio.
Validation rulesSimAjusta regras de validação, como a obrigatoriedade.
DescriptionSimComplementa o significado do campo, os requisitos de preenchimento, a fonte dos dados ou o responsável pela manutenção.
Atenção

O campo Região administrativa da China depende da tabela de dados chinaRegions fornecida pelo plug-in. Antes de usá-lo, verifique se o plug-in de campo «Divisões administrativas da China» está ativado.

Exclusão do campo

Clique em «Delete» à direita do campo para excluir o campo Região administrativa da China. No banco de dados principal, também é possível selecionar vários campos e excluí-los em lote.

Ao excluir um campo Região administrativa da China criado no banco de dados principal, normalmente a coluna 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 do 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

O campo Região administrativa da China é adequado para cenários de endereço, região e estatísticas.

CenárioUso
Bloco de formulárioUsar um seletor em cascata para selecionar província, cidade e distrito/condado.
Bloco de detalhesExibir o caminho da divisão administrativa.
Bloco de tabelaExibir a região à qual o registro pertence.
Bloco de filtroFiltrar registros por região.
Bloco de gráficoAgrupar dados de negócio por província, cidade e distrito.

Modo de edição

No modo de edição, o campo Região administrativa da China é exibido como um seletor em cascata.

Modo de leitura

No modo de leitura, o campo Região administrativa da China será exibido como um caminho de texto, por exemplo:

北京市 / 市辖区 / 东城区
  • Campo — Entenda a finalidade, a classificação e a lógica de mapeamento dos campos
  • Tabela comum — Crie e gerencie campos em uma tabela comum
  • Texto de linha única — Armazene endereços detalhados
  • Texto multilinha — Armazene descrições de endereço mais longas