Cadastros

Tipo

Conceito

Para

Analista, Engenharia de dados

Na tela

HorusDW › Tabelas › Novo Cadastro

Um Cadastro é uma tabela que as pessoas preenchem dentro do Lumo, por formulário, por uma grade parecida com planilha ou importando um XLSX, e que o DataViz lê como qualquer outra tabela. Serve para o dado que alguém decide e que nenhum sistema guarda: metas por filial, de-para de categorias, faixas de comissão, parâmetros. No YAML do Lumo CLI, o Cadastro se chama writeback.

Se o dado já existe num sistema, o lugar dele é um Dataflow, que busca sozinho no horário. A escolha entre planilha, Cadastro e Dataflow está em Como o dado entra.

O que muda em relação a uma tabela comum

	Tabela (de Dataflow)	Cadastro
De onde vem o dado	Do sistema de origem, pelo Agente ETL	De quem digita ou importa
Como se corrige uma linha	Na origem, e a próxima carga traz	Na grade, registro a registro
Estrutura	Definida pelo Dataflow	Definida no editor do Cadastro, com versões
Validação	Feita no Dataflow	Regras em JavaScript ao salvar cada registro
Histórico	Não tem	Cada registro guarda quem mudou o quê e quando
Linha excluída	Some na próxima carga	Vai para a lixeira do Cadastro

Por trás, cada registro salvo vai para a Base de Cadastros, um banco dedicado, e é copiado para o DW em seguida. Por isso uma edição pode levar alguns segundos para aparecer no Dashboard. Veja Onde o dado fica.

Do rascunho ao BI

Todo Cadastro nasce como rascunho na Minha Mesa de quem o criou, por Novo Cadastro, vazio ou a partir de um Excel. Ali só o dono e os administradores o enxergam. Quando a estrutura está pronta, ele é publicado numa Mesa de Dados e passa a poder entrar em Aplicações e ser liberado para outras pessoas.

Publicar não dá acesso a ninguém. Quem lê e quem edita as linhas é decidido tabela a tabela, na liberação pelo Datamart, com cinco permissões de dado (Ler, Criar, Atualizar, Excluir, Importar) mais Permite Exportação. Mudar a estrutura (campos, tipos, validações) fica com o dono, os administradores e quem tem a função de editar tabelas; nenhuma das cinco dá esse direito. Veja Permissões de Cadastro.

Depois de publicado, o Cadastro também pode ser editado pelo DataViz, no menu Cadastros, por quem tem permissão de atualizar as linhas. Veja Editar Cadastros no DataViz.

Os Cadastros do Tenant têm um limite de linhas somadas. Ao atingi-lo, criar registro e importar ficam bloqueados. Veja Recursos, limites e cobrança.

Onde isso aparece

Na lista HorusDW › Tabelas, o Cadastro tem a etiqueta Cadastro e dois botões próprios: Dados, que abre a grade, e Estrutura, que abre o editor de campos.

Para	Veja
Montar campos, tipos e unicidade	Criar e estruturar
Validar ao salvar e criar colunas calculadas	Validações e expressões
Preencher, corrigir e recuperar registros	Inserir e editar dados
Importar e exportar XLSX	Importar e exportar
Ver versões da estrutura e publicar	Versões e publicação
Usar o Cadastro num Dashboard	Cadastros no BI

Pelo Lumo CLI

A estrutura do Cadastro também pode ser versionada em YAML. Veja a referência de writeback.