Descripción General #
El comando NoSQL pertenece a la categoría de comandos Utilitarios en STELA. Su función principal es consultar una base de datos no relacional (NoSQL) y extraer información basada en un filtro en formato JSON. NoSQL permite acceder a la información que reside en las bases de datos NoSQL de una manera súper sencilla. Teniendo configurada una conexión contra una Base de Datos NoSQL, permite realizar consultas para obtener información directamente de ellas. Los datos recuperados son almacenados automáticamente dentro de un contenedor de variables para que el robot pueda utilizarlos en pasos posteriores del flujo.
Ejemplo de Uso Rápido #
Imagina que en un flujo de procesamiento de pedidos necesitas consultar la base de datos MongoDB para obtener la información de un cliente antes de emitir su factura.
Puedes configurar un paso con el comando noSQL especificando la colección clientes, enviando un filtro JSON con su documento {"documento":"45872123"} y definiendo un contenedor llamado ClienteMongo. STELA ejecutará la búsqueda y almacenará los campos recuperados (como nombre, correo o dirección) en variables listas para ser utilizadas en los siguientes pasos del robot.
Parámetros y Opciones #
- Colección: Aquí debes escribir el nombre exacto de la colección dentro de tu base de datos NoSQL donde se encuentran los datos que quieres consultar. (ejemplo:
clientes,pedidos,inventario) - Consulta: En este campo, introduces tu criterio de búsqueda en formato JSON. (ejemplo:
{"estado":"PENDIENTE"}) - Categoría: Aquí defines un nombre para la categoría dentro de STELA donde se guardarán los resultados de tu consulta.
Actualmente, este comando está optimizado para trabajar con bases de datos MongoDB.
Ejemplo de Uso
Para ver un ejemplo de uso de este comando haz clic aquí
Ejemplos de Uso Avanzado #
- Filtrado por múltiples criterios: Supongamos que en tu colección de «Productos» quieres encontrar todos los productos que pertenecen a la categoría «Electrónica» y cuyo precio sea menor a $100. En el campo «Consulta», podrías escribir:
{"categoría": "Electrónica", "precio": {"$lt": 100}}(sin las comillas exteriores). STELA te devolverá todos los productos que cumplan ambas condiciones. - Búsqueda por texto: Si tu colección contiene descripciones de artículos y quieres encontrar todos los artículos que mencionan la palabra «nuevo», podrías utilizar las funcionalidades de búsqueda de texto de MongoDB (si están configuradas en tu base de datos) dentro del campo «Consulta». Por ejemplo, algo como
{"$text": {"$search": "nuevo"}}(sin las comillas exteriores).
Errores Comunes y Soluciones #
- Error de conexión: Si STELA no puede conectarse a la base de datos NoSQL configurada. Asegúrate de que la configuración de la conexión sea correcta.
- Nombre de colección incorrecto: Si el nombre de la «Colección» que ingresaste no existe en la base de datos. Verifica que el nombre esté escrito correctamente.
- Formato JSON de la consulta inválido: Si la «Consulta» que escribiste no sigue la sintaxis correcta de JSON. Revisa cuidadosamente la estructura de tu consulta, asegurándote de que las llaves, comas y dos puntos estén en su lugar y que los valores coincidan con el tipo de dato esperado.
Casos de Uso #
- Obtención de listados específicos de información: Por ejemplo, obtener una lista de todos los usuarios registrados después de una fecha determinada o todos los productos con un stock bajo.
- Filtrado de datos para informes: Extraer datos específicos basados en ciertos criterios para generar informes personalizados.
- Verificación de datos: Comprobar rápidamente la existencia de ciertos datos o la cantidad de registros que cumplen con ciertas condiciones.