Base de datos

Tipos de datos

En “Tipos de datos” puedes gestionar, o crear los tipos de objetos que vas a usar en tus flujos. Esta página se conforma de dos columnas: “Objetos” y “Campos para objeto”

En la columna de “Objetos” se muestran listados todos los tipos de objetos que has creado. Haz clic sobre cada tipo de objeto para ver los campos que conforman ese tipo de objeto.

En la columna de “Campos para objetos” verás los campos que conforman el tipo de objeto.  Esta columna tiene subcolumnas que son: 

• Campo: Nombre del dato o parámetro. (También se conoce como propiedad).

• Tipo de dato: Se define el tipo de dato que se almacena en ese campo. Puede ser:

  • “Texto” 

  • “Número”

  • “Binario”

• Roles que pueden editar: Aquí se determinan los roles cuyos usuarios asociados pueden almacenar datos de flujo en este tipo de objeto.

Vistas

En “Vistas” puedes visualizar los datos almacenados en cada objeto de tu base de datos. Una vista es necesaria para cargar y almacenar datos a través de “Carga de datos”. Existen vistas para el ambiente QA y para el ambiente Producción. 

La página de “Vistas” en base de datos, se compone de varios botones:

• “Nueva vista”: Con este botón puedes crear una nueva vista.

• “Vista previa”: Con este botón puedes ver las vistas creadas en el ambiente QA, y si mantienes este botón seleccionado, puedes crear vistas para el ambiente QA.

• “Publicar”: Con este botón puedes ver las vistas creadas en el ambiente Producción, y si mantienes este botón seleccionado, puedes crear vistas para el ambiente Producción.

• “Nueva entrada”: Con este botón, puedes acceder a la “Carga de datos” para subir un archivo .csv.

• “Eliminar”: Con este botón, puedes eliminar la vista seleccionada.

• “Subir archivo”: Con este botón, puedes acceder a la “Carga de datos” para subir un archivo .csv.

Debajo de los botones, encontrarás la columna “Vistas”, en estas columnas verás listadas todas las vistas que has configurado. Las vistas que puedes ver, dependen del ambiente que selecciones en los botones anteriores.

Haz clic sobre una vista para ver la información que almacena. Del lado izquierdo verás una tabla donde cada columna corresponde a los campos, o propiedades, que contiene el objeto, y en las filas verás los datos almacenados a través de la “Carga de datos” o del “nodo Objeto” en un flujo. En esta tabla, se agregan automáticamente las columnas “CREATEDAT” y “UPDATEDAT”, para indicar la fecha y hora de creación y actualización, así como un ID para los datos almacenados de cada objeto. 

La tabla muestra toda la información almacenada en un tipo de objeto. Cada columna representa los campos del tipo de objeto. Y cada fila son los datos de un objeto, cada objeto se identifica con su ID.

¿Cómo agregar una nueva vista a la base de datos?

1. Haz clic en la opción “Base de datos” del menú de módulos.

2. Haz clic en la pestaña “Vistas”. 

3. Selecciona el ambiente donde se podrá visualizar esta información.

1. Haz clic en “Vista previa” para crear tu vista en el ambiente QA.

2. Haz clic en “Publicar” para crear tu vista en el ambiente Producción.

4. Haz clic en “Nueva vista”. Verás la ventana de creación de vista.

5. En “Nombre” escribe un nombre para identificar tu vista. Este nombre es el que aparece en la columna “Vistas”.

6. En “Tipo de data”, despliega la lista y elige el tipo de objeto cuyos datos quieres ver o cargar en esta vista. Sólo puedes seleccionar un objeto por cada vista.

7. En “Ordenar por”, despliega la lista y selecciona uno de los campos del tipo de objeto, del cuál depende la organización de los datos.

• Por ejemplo, si eliges “createdAt”, los objetos se organizan comenzando con el que tenga la fecha de creación más reciente en su fila.

8. En “Campos para mostrar en esta vista” verás los campos o propiedades del tipo de objeto. Marca el checkbox de los campos que quieres incluir en tu vista.

   1. Los campos que no marques, no aparecerán en la tabla de datos de la vista.

9. (Opcional) En “Restricciones de búsqueda para la vista” puedes delimitar los datos que se verán en tu tabla, en función de los datos almacenados en los campos de un objeto y su relación con un valor que determinas.

1. Haz clic en “+Agregar restricción”.

2. En “Selecciona un campo” despliega la lista y selecciona el campo del objeto que va a servir como referencia para delimitar los datos.

3. En “Selecciona” despliega la lista y elige la relación entre las siguientes opciones. 

   1. “=”: Para mostrar objetos que tengan el valor que determinas en el campo que seleccionaste.

   2. “< >”: Para mostrar objetos que tengan un valor diferente al valor que determinas en el campo que seleccionaste.

   3. “<”: Para mostrar objetos que tengan un valor menor al valor que determinas en el campo que seleccionaste.

   4. “>”: Para mostrar objetos que tengan un valor mayor al valor que determinas en el campo que seleccionaste.

   5. “is empty”: Para mostrar objetos que no contengan un valor en el campo que seleccionaste.

   6. “is not empty”: Para mostrar objetos que contengan algún valor en el campo que seleccionaste.

   7. “contains”: Para mostrar objetos que contengan el valor que determinas en el campo que seleccionaste.

   8. “does not contains”: Para mostrar objetos que no contengan el valor que determinas en el campo que seleccionaste.

   9. “< =”: Para mostrar objetos que tengan un valor igual o menor al valor que determinas en el campo que seleccionaste.

   10. “= >”: Para mostrar objetos que tengan un valor igual o mayor al valor que determinas en el campo que seleccionaste.

4. En “Escribe” determina el valor con el que se va a hacer la relación.

   1. Para los campos de objeto creados por ti, puedes escribir texto o número para determinar el valor.

   2. Para los campos de objeto predeterminados; “createdAt” y “updatedAt”, determina el calor con el formato de fecha.

5. Repite el proceso para agregar más restricciones.

6. Si quieres eliminar una restricción haz clic en “Eliminar” representado con un ícono de papelera.

10. Haz clic en “Finalizar” para guardar tu vista.

11. Para eliminar una vista en la columna de vistas, selecciona la vista y haz clic en el botón “Eliminar”.

 Editar vistas

1. Selecciona la vista que quieres editar en la columna de vistas.

2. Haz clic en el botón “Editar vista” que se habilita a un lado del botón “Nueva vista”.

3. Verás la ventana de creación de Vista con la configuración actual de la vista.

4. Realiza tus modificaciones.

5. Haz clic en “Finalizar”.

Asociar Roles a Vista

Puedes asociar roles a una vista de la base de datos, para delimitar la visibilidad de la información entre tus usuarios operativos según el rol que tienen asociado. Para asociar un rol a una vista sigue los siguientes pasos.

1. Selecciona la vista que quieres editar en la columna de vistas.

2. En “Roles” despliega la lista y selecciona el rol, o los roles, que tendrán acceso a la información de esta vista.

Es importante que los usuarios que tengan asociado el rol que seleccionaste, pertenezcan al mismo ambiente de la vista. En otras palabras, si tu vista es de ambiente producción, los usuarios en ambiente QA no podrán visualizar la información, aunque tengan el rol asociado.

Carga de datos

En “Carga de datos” puedes subir archivos en formato .csv para almacenar los datos en los objetos de tu propia base de datos. Estos datos son visibles a través de las “Vistas” de la base de datos.

¿Cómo almacenar tus bases de datos en objetos de Kosmos?

Si cuentas con una base de datos, puedes subirla rápidamente a Kosmos. Tu base de datos debe estar guardada como archivo .csv.

Antes de cargar datos, recuerda que es necesario crear un tipo de objeto y una vista con la configuración necesaria para almacenar los datos. Es decir, que los campos de tu tipo de objeto y los parámetros de tu vista coincidan con los datos de tu base. Para cargar tu base de datos sigue los siguientes pasos.

1. Haz clic en la opción “Base de datos” del menú de módulos.

2. Haz clic en la pestaña “Carga de datos”. 

3. Selecciona el ambiente donde se va a almacenar esta información. Este ambiente está ligado al ambiente en el que se creó la Vista.

1. Haz clic en “Vista previa” para subir tus datos al ambiente QA.

2. Haz clic en “Publicar” para subir tus datos al ambiente Producción.

4. Haz clic en “Selecciona un archivo”. Se mostrará una ventana emergente de carga de datos: 

5. En “Tipo de data” despliega la lista y elige el tipo objeto donde vas a almacenar los datos del archivo .csv.

6. En “Delimitador de data” despliega la lista y elige cómo se separan los datos en tu archivo .csv. Las opciones son:

   1. .

   2. ,

   3. ;

   4. Tab

   5. |

El más común es la coma “,”.

7. Haz clic en “Elegir archivo a subir CSV”. 

   1. Selecciona un archivo de tu equipo y súbelo.

8. Vincula las columnas. Se mostrarán dos columnas. “Parámetro(s)” a la izquierda y “Valor del parámetro a la derecha”.

1. La columna de la izquierda muestra los campos o propiedades que contiene el tipo de objeto seleccionado.

2. La columna de la derecha muestra las datos reconocidos el archivo .csv. 

1. El nombre del dato se reconoce por los valores en las celdas de la fila 1 del archivo. Te recomendamos crear un archivo .csv donde las primeras celdas de cada columna tengan el nombre de tus parámetros.

3. Despliega la lista, y selecciona el dato que se va a almacenar en el parámetro de la fila en la que estás.

9. Haz clic en “Finalizar”. Verás el mensaje “Se crearon con éxito las instancias de objeto.” si se cargaron los datos correctamente.

10. Después de cargar tus datos, podrás visualizarlos en la pestaña “Vistas”.

    1. En Vistas, las columnas “CREATEDAT”, “UPDATEDAT” y “ID” se generan de forma automática.

Errores en carga de datos

• “Error en fila [___] en la columna [_____] se esperaba un valor de tipo _____________”

Este error aparece cuando el tipo de valor del archivo en una celda del archivo .csv, no coincide con el tipo de valor que configuraste para el parámetro de esa columna. El error te indica la fila y la columna para ubicar la celda donde se encuentra el error, y el tipo de valor esperado.

• “No existe definición de objeto con el nombre [____] en ambiente [______]”

Preguntas frecuentes

¿Cuál es la diferencia entre un “tipo de objeto” y un “objeto”?

Tipo de objeto: hace referencia a la estructura o plantilla que se define para los datos que se van a almacenar en la base de datos. Es decir, es un conjunto de campos que tienen un nombre y un tipo de dato definido (texto, número, binario) en los que se puede almacenar información. Los tipos de objeto se crean en la sección de "Tipos de datos" de la página de la base de datos.

Objeto: es un ejemplar de un tipo de objeto. Es decir, una vez que se ha definido un tipo de objeto con sus campos, se pueden crear múltiples objetos de ese tipo, cada uno con sus propios valores para los campos definidos

Ejemplo: si se está creando una base de datos para almacenar información de usuarios, se podría definir un "Tipo de objeto" llamado "Usuario" con campos como "Nombre", "Apellido", "Correo electrónico", etc. Luego, se podrían crear múltiples "Objetos" de ese tipo para almacenar la información de diferentes usuarios en la base de datos, cada uno con sus propios valores para los campos definidos.