Como criar uma nova fonte de dados

Vamos explicar passo a passo como registrar uma nova fonte de dados no Moki utilizando uma planilha do Excel.

A criação e manutenção são realizadas por meio da tela de administração de fontes de dados, que pode ser acessada através da interface web do Moki, disponível para usuários que tenham as permissões necessárias para a gestão de fontes de dados. Para criar uma nova fonte de dados:

1. No menu principal, acesse a opção Admin > Fonte de Dados.
2. Em seguida, selecione a opção Nova Fonte de Dados.

Configurações iniciais

Após selecionar uma nova fonte de dados, é necessário realizar as configurações iniciais da fonte, que incluem os seguintes dados:

1. Nome: Nome que será exibido para identificar esta fonte de dados aos usuários.
2. Origem: Indique de onde os dados desta fonte serão provenientes, sendo:
   1. Excel: Os dados serão carregados manualmente no Moki por meio da importação de arquivos Excel.
   2. API: Os dados serão carregados no Moki por meio de integração com uma API REST.
3. Uso em dispositivos móveis: Selecione de que forma essa fonte de dados estará disponível nos aplicativos móveis. Lembre-se de que o uso offline consome mais memória nos dispositivos e pode afetar o desempenho do aplicativo nesses equipamentos.
4. Ativa: Indique se a fonte de dados está ativa ou inativa, sendo:
   1. Status: Disponível para uso e consulta por parte dos usuários do Moki
   2. Inativa: Não disponível para uso nem consulta

Como importar a planilha do Excel e configurar os campos

Ao selecionar a opção Excel no campo “Origem”, será exibida a alternativa para importar sua planilha para a base de dados do Moki. Clique em "Importar" para carregar seu arquivo.

Após a importação da planilha, será possível verificar as colunas e parametrizá-las:

1. Coluna
   1. Tipo: Texto – não modificável após a importação.
   2. Descrição: Identifica o nome técnico da coluna ou propriedade. Deve ser único dentro da fonte de dados.
2. Apelido
   1. Tipo: Texto
   2. Descrição: Campo obrigatório que define o nome que será exibido aos usuários durante a visualização dos dados. Pode ser mais amigável que o nome técnico.
3. Tipo
   1. Tipo: Opção
   2. Descrição: Define o tipo de dado que será armazenado na coluna. As opções disponíveis são:
      1. Texto: Cadeia de caracteres (letras, símbolos, etc.)
      2. Número: Valores numéricos inteiros ou decimais
      3. Booleano: Valores do tipo Verdadeiro / Falso (Sim / Não)
      4. Data: Valores que representam data, hora ou ambos
4. Nome de Exibição
   1. Tipo: Verdadeiro / Falso
   2. Descrição: Indica se este campo será utilizado como o nome principal visível nas visualizações de dados.

IMPORTANTE:  Deve existir pelo menos um campo com essa opção ativada.

1. Chave
   1. Tipo: Verdadeiro / Falso
   2. Descrição: Determina se o campo funcionará como identificador único do registro. É usado para detectar se os dados devem ser inseridos ou atualizados.
2. Código da Unidade
   1. Tipo: Verdadeiro / Falso
   2. Descrição: (Opcional) Indica se o campo contém códigos de unidades registrados no Moki, permitindo seu uso em filtros e análises cruzadas.
3. Coluna de Pesquisa
   1. Tipo: Verdadeiro / Falso
   2. Descrição: Define se o campo poderá ser utilizado em funcionalidades de busca, como Max Busca ou leitura de códigos de barras/QR.
4. Visível
   1. Tipo: Verdadeiro / Falso
   2. Descrição: Indica se o campo será mostrado nas visualizações dos dados. Se desativado, o campo ficará oculto para os usuários finais.
5. Casas Decimais
   1. Tipo: Lista
   2. Descrição: Aplicável apenas para campos do tipo Número. Especifica a quantidade de casas decimais a serem exibidas na visualização.

IMPORTANTE:  Pelo menos um campo deve ter essa opção habilitada.

1. Máscara
   1. Tipo: Texto
   2. Descrição: Aplicável apenas para campos do tipo Data. Define o formato em que a data será exibida (por exemplo: DD/MM/AAAA, AAAA-MM-DD HH:mm etc.).

Após carregar a planilha e configurar as colunas, clique em Salvar. Aguarde até que a barra de progresso atinja 100% e, por fim, clique em OK.

Como atribuir permissão aos usuários

Ao acessar a aba "Usuários", é possível atribuir a permissão de acesso à fonte de dados, selecionando os usuários desejados. Os usuários poderão visualizar, modificar ou importar a fonte de dados, conforme os níveis de permissão atribuídos.

Como verificar os dados importados

Ao acessar a aba "Dados", é possível visualizar os registros contidos na planilha que foi importada. A partir dessa opção, podem ser realizadas as seguintes ações:

• Baixar o último arquivo importado
• Importar novos dados
• Adicionar um novo registro manualmente, sem necessidade de modificar a planilha já importada
• Baixar um relatório em formato Excel