Linha

Introdução

No NocoBase, linha (LineString) é usada para armazenar dados espaciais lineares.

O campo Linha é adequado para dados de negócio como rotas, trajetos, tubulações e caminhos de inspeção. Em conjunto com um bloco de mapa, é possível exibir o caminho.

Se você precisa apenas de uma localização, escolha ponto. Se precisa de uma área, escolha polígono.

Cenários aplicáveis

A linha é adequada para estes cenários de negócio:

  • Rotas de entrega e inspeção
  • Trajetos de veículos e pessoas
  • Tubulações, linhas e limites
  • Resultados do planejamento de rotas no mapa

Criar configuração

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

20240512181454

ConfiguraçãoDescrição
Field interfaceTipo de interface do campo. Para Linha, corresponde a lineString e determina como o campo será preenchido e exibido na página.
Field display nameNome exibido do campo na interface, como «Rota de entrega», «Trajeto de inspeção» ou «Tubulação». Recomenda-se usar um nome que os usuários de negócio compreendam diretamente.
Field nameNome identificador do campo, usado em referências internas como API, campos de relação, permissões e fluxos de trabalho. Normalmente não pode ser 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. Por padrão, o campo Linha é lineString.
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. Normalmente, basta configurar o campo como obrigatório.
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

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 ajuste de configuração posteriormente.

Características do campo

O comportamento padrão do campo Linha é o seguinte:

CaracterísticaDescrição
Field interface padrãolineString.
Field type padrãolineString.
Field type opcionallineString.
Componente da páginaNo modo de edição, usa um componente de desenho de mapas.
FiltragemA capacidade de filtragem espacial depende do plug-in de mapas e dos recursos da fonte de dados.
OrdenaçãoNormalmente, não é usado para ordenação.
ValidaçãoOferece validações básicas, como a obrigatoriedade do preenchimento.

Editar configuração

Após a criação, clique em «Edit» à direita do campo para editar a configuração do campo Linha. A edição do campo é usada principalmente para ajustar a forma como ele é exibido e utilizado no NocoBase, por exemplo, alterando 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 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ãoO nome identificador do campo normalmente não pode ser alterado no formulário de edição após a criação.
Field interfaceCondicionalmenteCampos 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 typeCondicionalmenteCampos do banco de dados principal ou campos sincronizados podem ser ajustados durante o mapeamento de campos. Antes do ajuste, confirme se os dados existentes podem ser usados com o novo tipo.
Default valueSimAjusta o valor padrão para 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 exibido. Isso afeta a forma de armazenamento do campo, o componente de entrada, as regras de validação, as condições de filtragem 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.

Excluir campo

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

Ao excluir um campo Linha criado no banco de dados principal, normalmente a coluna real correspondente no banco de dados e os dados 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.

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 alguma configuração de negócio.

Uso na configuração de páginas

O campo Linha é adequado para cenários de rotas em mapas e análises espaciais. 20260710144453

CenárioUso
Bloco de formulárioDesenhar ou inserir uma rota.
Bloco de detalhesExibir uma rota.
Bloco de mapaExibir um caminho linear no mapa.
Fluxo de trabalhoParticipar do processo como dado relacionado a uma rota.
  • Campo — entender a função, a classificação e a lógica de mapeamento dos campos
  • Tabela comum — criar e gerenciar campos em uma tabela comum
  • Ponto — armazenar uma única localização
  • Polígono — armazenar uma área