Cómo crear una nueva fuente de datos

Vamos a explicar paso a paso cómo registrar una nueva fuente de datos en Moki utilizando una hoja de cálculo de Excel.

La creación y el mantenimiento se realizan a través de la pantalla de administración de fuentes de datos, que puede ser accesada mediante la interfaz web de Moki, disponible para usuarios que tengan los permisos necesarios para la gestión de fuentes de datos. Para crear uma nueva fuente de datos:

1. En el menú principal, acceda a la opción ADMIN → Fuente de Datos.
2. A continuación, seleccione la opción la opción Nuevo Origen de Datos.

Configuraciones iniciales

Después de seleccionar una nueva fuente de datos, es necesario realizar las configuraciones iniciales de la fuente, que incluyen los seguientes datos:

1. Nombre: Es el nombre que se mostrará para identificar esta fuente de datos a los usuarios. 
2. Origen: Indique de dónde provendrán los datos para esta fuente, siendo:
   1. Excel: Los datos serán cargados manualmente en Moki a través de la importación de archivos Excel. 
   2. API: Los datos se cargarán en Moki mediante integración con una API REST. 
3. Uso en dispositivos móviles: Seleccione de qué forma esta fuente de datos estará disponible en las aplicaciones móviles. Recuerde que el uso offline consume más memoria en los dispositivos y puede afectar el rendimiento de la aplicación en estos equipos.
4. Activa: Indique si la fuente de datos está activa o inactiva, siendo:
   1. Status: Disponible para el uso y consulta por parte de los usuarios de Moki
   2. Inactiva: No disponible para el uso ni consulta.
      
      

Cómo importar la hoja de cálculo de Excel y configurar los campos

Al seleccionar la opción de Excel en el campo “origen”, se mostrará la alternativa para importar su hoja de cálculo a la base de datos de Moki. Haga clic en "Importar" para cargar su archivo.

Después de la importación de la hoja de cálculo, será posible verificar las columnas y parametrizarlas:

1. Columna:
   1. Tipo: Texto – no modificable después de la importación.
   2. Descripción: Identifica el nombre técnico de la columna o propiedad. Debe ser único dentro de la fuente de datos. 
2. Alias:
   1. Tipo: Texto
   2. Descripción: Campo obligatorio que define el nombre que se mostrará a los usuarios durante la visualización de los datos. Puede ser más amigable que el nombre técnico. 
3. Tipo:
   1. Tipo: Opción
   2. Descripción: Define el tipo de dato que se almacenará en la columna. Las opciones disponibles son: 
      1. Texto: Cadena de caracteres (letras, símbolos, etc.)
      2. Número: Valores numéricos enteros o decimales
      3. Booleano: Valores de tipo VERDADERO / FALSO (Sí / No)
      4. Fecha: Valores que representan fecha, hora o ambos
4. Nombre de Exibición:
   1. Tipo: Verdadero / Falso
   2. Descripción: Indica si este campo será utilizado como el nombre visible principal en las vistas de datos. 
      
      Importante: Debe existir al menos un campo con esta opción activada.
5. Clave:
   1. Tipo: Verdadero / Falso
   2. Descripción: Determina si el campo funcionará como identificador único del registro. Se usa para detectar si los datos deben ser insertados o actualizados. 
      
      Importante: Al menos un campo debe tener esta opción habilitada.
6. Código de la Unidad:
   1. Tipo: Verdadero / Falso
   2. Descripción: (Opcional) Indica si el campo contiene códigos de unidades registrados en Moki, permitiendo el uso en filtros y análisis cruzados.
7. Columna de búsqueda:
   1. Tipo: Verdadero / Falso
   2. Descripción: Define si el campo podrá ser utilizado en funcionalidades de búsqueda, como MaxBusca o escaneo de códigos de barras/QR.
8. Visible:
   1. Tipo: Verdadero / Falso
   2. Descripción: Indica si el campo será mostrado en las vistas de los datos. Si está desactivado, el campo estará oculto para los usuarios finales.
9. Casas decimales:
   1. Tipo: Lista
   2. Descripción: Solo aplicable para campos del tipo Número. Especifica la cantidad de decimales que se deben mostrar en la visualización.
10. Máscara:
    1. Tipo: Texto
    2. Descripción: Solo aplicable para campos del tipo “fecha”. Define el formato en que se mostrará la fecha (por ejemplo: DD/MM/AAAA, AAAA-MM-DD HH:mm, etc.).

Una vez cargada la planilla y configuradas las columnas, haga clic en Guardar. Espera a que la barra de progreso llegue al 100% y, finalmente, haga clic en OK.

Cómo asignar permiso a los usuários

Al acceder a la pestaña "usuarios", es posible asignar el permiso de acceso a la fuente de datos seleccionando los usuarios deseados. Los usuarios podrán ver, modificar o importar la fuente de datos, según los permisos asignados.

Cómo verificar los datos importados

Al acceder a la pestaña "datos", es posible visualizar los registros contenidos en la hoja de cálculo que fue importada. Desde esta opción, se pueden realizar las siguientes acciones:

• Descargar el último archivo importado.
• Importar nuevos datos.
• Agregar un nuevo registro manualmente, sin necesidad de modificar la hoja ya importada.
• Descargar un informe en formato Excel.