Nodo Objeto
El nodo "Objeto” permite guardar y consultar información de un flujo en la base de datos. Consta de dos acciones principales: crear y consultar.
Al “crear un objeto”, se pueden guardar los datos capturados o generados en un flujo, en un objeto de la base de datos. Para visualizar estos datos, es necesario crear una “Vista” en la Base de datos.
Al “consultar un objeto”, se puede verificar si los datos del flujo ya se encuentran en un objeto de la base de datos.
Los datos guardados en tus objetos están almacenados en el módulo “Base de datos”.
Este nodo cuenta con dos puntos de conexión:
“Información indefinida”: Para casos donde los datos no se crearon, o no se consultaron, de forma correcta.
“Éxito”: Para casos donde los datos se crearon, o no se consultaron, de forma correcta.
¿Cómo agregar el nodo de Objeto y configurar “Crear Objeto”?
Ingresa a editar tu botón, o componente, e ingresa a la configuración de Business Logic.
Coloca el nodo de "Objeto" y conéctalo.
En el primer campo, despliega la lista y selecciona “Crear un objeto”.
En “Tipo” despliega la lista y selecciona el tipo de objeto donde vas a guardar la información. En la lista verás todos los objetos de tu base de datos.
Selecciona un objeto de la lista para almacenar los datos en ese objeto
Si quieres agregar un nuevo objeto a tu base de datos, desciende al final de la lista y haz click en “+ Añadir opción”. Escribe el nombre del objeto que vas a agregar y haz click en "✓" .
Después de seleccionar el objeto, verás los campos de datos que contiene ese tipo de objeto en la primera celda. En la segunda celda verás un signo de igual (=), y en la tercera celda encontrarás la opción “Seleccionar fuente”.
Esto indica que el valor de la variable de tu fuente, se guardará (tal y como se generó o capturó) en el campo de tu objeto.
En “Seleccionar fuente”, despliega la lista y elige el origen del dato en tu flujo.
Coloca tu cursor sobre la fuente del parámetro y sin hacer click, navega entre las variables que se contienen en esa fuente.
Haz clic en la variable que vas a usar para ese campo del objeto.
(Opcional) Si quieres crear un nuevo campo para el objeto haz click en “+Crear nuevo campo”. Y verás una nueva ventana.
En “nombre de campo” asigna el nombre para el campo.
En tipo de campo selecciona el tipo de dato que se va a capturar. Las opciones son:
Texto
Número
Binario
Fecha
Catálogo
Imagen
Activa las funciones para el campo que deseas aplicar. Las opciones son:
Es solo lectura
Es un campo obligatorio
Es un campo único
Haz clic en “Guardar”.
Si agregaste un nuevo objeto a la base, este no tendrá campos, por lo tanto, tendrás que usar esta función para agregarlos.
En “Guardar en variable” escribe un nombre para el objeto. Con este nombre, podrás identificarlo en otros nodos y componentes de Kosmos. (Este nombre sólo aplica en el flujo, no modifica el nombre del objeto en la base de datos).
¿Cómo agregar el nodo de Objeto y configurar “Consultar Objeto”?
Ingresa a editar tu botón, o componente, e ingresa a la configuración de Business Logic.
Coloca el nodo de "Objeto" y conéctalo.
En el primer campo, despliega la lista y selecciona “Consultar un objeto”.
En “Tipo” despliega la lista y selecciona el tipo de objeto cuyos datos quieres consultar. En la lista verás todos los objetos de tu base de datos.
Haz clic en “+Crear nueva restricción” para agregar los campos del objeto que quieres consultar.
Coloca tu cursor sobre la primera celda y selecciona el campo del objeto que quieres consultar.
Coloca tu cursor sobre la segunda celda y selecciona un operador para hacer la relación del valor de la variable del flujo con el valor del campo del objeto. Las opciones son:
“=”: El valor del campo del objeto es igual al valor de la variable del flujo. Esta opción es ideal para saber si el dato capturado en el flujo ya existe en un objeto.
“< >”: El valor de la variable del flujo no es igual al valor del campo del objeto.
“<”: El valor de la variable del flujo es mayor al valor del campo del objeto.
“>”: El valor de la variable del flujo es menor al valor del campo del objeto.
“is empty”: El campo del objeto no tiene información
“is not empty”: El campo del objeto tiene información
“contains”: El campo del objeto contiene el valor de la variable del flujo.
“does not contains”: El campo del objeto contiene el valor de la variable del flujo.
“< =”: El valor de la variable del flujo es igual o mayor al valor del campo del objeto.
“= >”: El valor de la variable del flujo es igual o menor al valor del campo del objeto.
Coloca tu cursor sobre la tercera celda y selecciona la variable del flujo con la que vas a realizar la consulta.
En “Filtros” puedes filtrar las solicitudes que coincidan con el criterio de consulta. En otras palabras, en vez de consultar todas las solicitudes que contengan el dato que estás consultando, puedes delimitar el número de solicitudes según tus necesidades. Las opciones son las siguientes.
Primer elemento: Se consulta sólo la primera solicitud creada que coincida con el criterio de consulta.
Último elemento: Se consulta sólo la última solicitud creada que coincida con el criterio de consulta.
Objeto al azar: Se consulta una solicitud al azar entre todas las solicitudes que coincidan con el criterio de consulta.
Objeto #: Se consulta la solicitud que indiques. Las solicitudes que coincidan con el criterio de búsqueda se ordenan siguiendo el orden de creación. Para indicar la solicitud, aparece un campo extra donde debes ingresar el número de la solicitud que quieres consultar según su lugar en la lista.
Objeto hasta #: Se consultan todas las solicitudes hasta llegar a la solicitud que indiques. Las solicitudes que coincidan con el criterio de búsqueda se ordenan siguiendo el orden de creación. Para indicar la solicitud donde termina la consulta, aparece un campo extra donde debes ingresar el número de la solicitud según su lugar en la lista.
Objeto desde #: Se consultan todas las solicitudes desde la solicitud que indiques. Las solicitudes que coincidan con el criterio de búsqueda se ordenan siguiendo el orden de creación. Para indicar la solicitud donde empieza la consulta, aparece un campo extra donde debes ingresar el número de la solicitud según su lugar en la lista.
Todos: Se consultan todas las solicitudes que coincidan con el criterio de búsqueda.
En “Guardar en variable” escribe un nombre para el identificar y usar las variables del objeto en la ejecución del flujo. Con este nombre, podrás identificarlo en otros nodos de business logic cómo “Autocompletar”, “Código”, “If”, “Integración” entre otros. (Este nombre sólo aplica en el flujo, no modifica el nombre del objeto en la base de datos).
Ejemplo de uso
Un ejemplo de uso del nodo "Objeto" es para verificar si un usuario ya había iniciado un flujo. Para hacerlo, se puede utilizar la CURP como dato único y personal. Para esto, se puede usar el objeto creado en un flujo anterior que contiene la CURP y el folio.
Para configurar el nodo de objeto, primero se debe elegir la acción de "consultar" y seleccionar el tipo de objeto que contiene la información de la CURP y el folio. Luego, se debe crear una restricción que relacione la variable de la CURP en el objeto con el campo de la CURP en el formulario.
En el primer campo, seleccionar la variable que representa la CURP en el objeto.
En el segundo campo, seleccionar la variable del formulario que contiene la CURP ingresada por el usuario.
En la opción de comparación, seleccionar la igualdad "=".
En filtros elegimos la opción “Todos” para consultar la CURP en cualquiera de las solicitudes. Si la CURP no se encuentra en la base, se puede guardar la información en otro objeto usando el nodo de objeto y seleccionando la opción de "crear". Se deben relacionar las variables del objeto con las variables del flujo, utilizando el campo del formulario para la CURP y el folio de la solicitud que se encuentra en la metadata del flujo.
Con el nodo "Objeto", es posible crear y consultar objetos en una base de datos y utilizar la información guardada en variables para continuar un flujo.
Preguntas frecuentes
¿Qué es el campo "Guardar en variable" del nodo Objeto?
El nombre que asignas en "Guardar en variable" del nodo Objeto sirve para identificar el objeto. Una vez que hayas asignado un nombre a la función, podrás utilizarlo en otros nodos o componentes de tu flujo como una fuente de datos, por ejemplo en “Cambiar componente”. Es importante elegir un nombre descriptivo y único para evitar confusiones y facilitar la gestión y uso de la función en tu experiencia digital.