Buscar K
Aparência
Criar e estruturar um Cadastro
- Tipo
- Como fazer
- Para
- Analista
- Na tela
- HorusDW › Tabelas › Minha Mesa › Novo Cadastro
A estrutura de um Cadastro é a lista de campos que cada registro tem, com o tipo e as regras de cada um. Ela é montada no editor Estrutura e vale para todo mundo que preencher o Cadastro depois. O que é um Cadastro e quando usar está em Cadastros.
Antes de começar
Qualquer pessoa que tenha a sua Minha Mesa pode criar um Cadastro. Depois de criado, mudar a estrutura é para o dono do Cadastro, para os administradores do Tenant e para quem tem a função de editar tabelas. Para começar de uma planilha pronta, veja Carregar uma planilha.
Criar o Cadastro
- Em HorusDW › Tabelas, entre em Minha mesa e clique em Novo Cadastro.
- Em Nome do Cadastro, escreva o nome que as pessoas vão ver, por exemplo
Metas de Vendas. - Em Como deseja começar?, escolha Começar vazio e clique em Criar Cadastro. O editor de estrutura abre sem nenhum campo.
Adicionar campos
- Clique em Adicionar campo.
- Escreva o rótulo do campo, por exemplo
Meta Mensal, e escolha o tipo. - Marque Obrigatório se o registro não pode ser salvo sem esse campo.
- Para mais opções, abra Configurar no campo (veja a tabela abaixo).
- Repita para os outros campos e clique em Salvar definição. Em Nota da alteração (opcional), diga o que mudou: a nota fica no histórico de versões.
Os seis tipos de campo:
| Tipo | Guarda | Exemplo |
|---|---|---|
| Texto | Texto livre | Observação, nome do responsável |
| Número | Valor numérico, com máscara de formato | Meta, quantidade, percentual |
| Data | Data, na granularidade Ano, Mês, Data ou Data e hora | Competência (Mês), prazo (Data) |
| Lista de valores | Uma opção de uma lista fixa, cada uma com uma cor | Status: Aberto, Aprovado, Recusado |
| Chave externa | Um registro de outra tabela publicada | A filial da meta, escolhida pelo nome |
| Imagem | Um arquivo de imagem enviado pelo usuário | Foto do produto |
A granularidade da data decide o que a pessoa preenche e como o BI agrupa: numa meta mensal, use Mês, e ninguém precisa inventar um dia. Na Lista de valores, a opção escolhida aparece na grade como uma etiqueta da cor que você definiu.
Na Chave externa, configure em Referência (chave externa) a Tabela, a Coluna chave (o que fica gravado) e a Coluna de rótulo (o que a pessoa vê e busca ao preencher). Só tabelas publicadas em Mesas podem ser referenciadas. Se o registro apontado deixar de existir, a grade mostra a chave crua com o aviso de referência não encontrada.
Use Lista de valores quando as opções são poucas, estáveis e só existem neste Cadastro. Use Chave externa quando o valor é algo que já existe em outra tabela (cliente, produto, filial): assim o BI consegue cruzar as duas.
Configurar um campo
O botão Configurar de cada campo abre Configuração do campo:
| Opção | O que faz |
|---|---|
| Nome interno da coluna | O nome da coluna no banco e nas expressões, gerado a partir do rótulo. Desmarque Definir automaticamente a partir do nome para escolher outro |
| Máscara | Formato de exibição e digitação, como moeda ou percentual |
| Dica (tooltip) | Texto de ajuda que aparece ao preencher |
| Valor padrão | Valor que o campo já traz num registro novo |
| Seção | Agrupa campos no formulário, útil quando há muitos |
| Grade de dados | Visível na grade, Largura (px), Alinhamento e Formato de exibição da coluna na grade |
| Validação (JavaScript) | Regra que bloqueia o registro ao salvar. Veja Validações e expressões |
Renomear o rótulo ou o nome interno não perde dado: o campo continua apontando para os mesmos valores. Remover um campo apaga os dados daquela coluna quando você salva a definição, e a tela pede confirmação antes.
Definir o que não pode se repetir
A unicidade é definida para a tabela, como combinações de campos, em Configurações › Restrições de unicidade. Clique em Adicionar restrição e escolha os campos da combinação.
Num Cadastro de metas, a restrição Filial + Mês garante no máximo uma meta por filial em cada mês, e deixa o mesmo mês aparecer uma vez para cada filial. Escolha a menor combinação que identifica um registro de verdade: uma combinação larga demais deixa passar duplicata.
A mesma tela Configurações tem Seções (criar e remover as seções do formulário), Colunas congeladas (quantas colunas ficam fixas à esquerda na grade), Hook ao salvar, Metadados no BI e Retenção.
Se der errado
Corrija os campos destacados antes de salvar.: algum campo está sem rótulo, com nome interno repetido ou inválido, ou incompleto. Os casos mais comuns são Campo de data exige granularidade. e Chave externa exige tabela e colunas de referência (configuração avançada).
Você não tem permissão de alterar a estrutura deste Cadastro.: você pode editar os dados, mas a estrutura é do dono do Cadastro, dos administradores e de quem tem a função de editar tabelas.
Relacionado
Pelo Lumo CLI
Campos, tipos e restrições também podem ser versionados em YAML. Veja a referência de writeback.