Dinaup DocsConsulta con IA
Compón una consulta IAQuery sobre una sección, con agregados, filtros, agrupación y orden, y comprueba el resultado y el SQL generado.
Desarrollo → Herramientas → Consulta con IA es el editor visual de IAQuery: una consulta definida en la propia llamada, sin crear un informe. Eliges la sección, los campos, los filtros, la agrupación y el orden; el servidor genera el SQL, lo ejecuta y devuelve las filas. La cabecera de la pantalla la llama IAQuery.
La misma consulta se lanza desde código con el SDK .NET: IAQuery documenta los operadores, las funciones y los límites del servidor.
Antes de empezar
- La aplicación Desarrollo en la licencia y el interruptor Desarrollador en tu usuario. Ver Desarrollo.
- Saber qué sección y qué campos quieres consultar. Sus nombres internos están en Esquema.
Los cuatro pasos
La cabecera resume el recorrido: 1. Elige una sección, 2. Selecciona campos, 3. Añade filtros, 4. Ejecuta. Todo ocurre en la tarjeta Playground.
Elige la sección
En Sección, pulsa la caja y elige la sección en la ventana Elegir la sección a consultar. Salen las secciones de datos, ordenadas por título; no las plantillas base ni las tablas de líneas. Hasta entonces, la tarjeta dice Selecciona una sección para construir tu consulta. Cambiar de sección vacía la consulta.
Si acabas de crear la sección y no aparece, la ventana avisa: Esa sección no está en el esquema. El esquema se guarda 24 horas.
Compón el SELECT
En Campos (SELECT), pulsa Añadir por cada columna. Cada fila tiene:
- El selector de campo (Seleccionar campo). Abre una lista con buscador (Buscar campo). Primero van los campos de la sección, con
idynombredelante y los campos del sistema marcados. Después, un grupo por cada campo de referencia (Campo → Sección relacionada), que se despliega para elegir un campo de la sección relacionada. El campoeliminadono se ofrece. Sin coincidencias, la lista dice Sin resultados para el texto buscado. - Función: vacía, COUNT, SUM, AVG, MAX o MIN.
- Agrupar: marca el campo como GROUP BY.
Si algún campo está agrupado, los demás necesitan función: la fila muestra un aviso (Necesita función agregada o marcar «Agrupar») y Ejecutar no lanza la consulta: avisa con Los campos no agrupados necesitan una función agregada. Sin ningún campo, la tarjeta dice Añade al menos un campo. El aspa de cada fila la quita.
Filtra y ordena
- WHERE: Añadir crea una condición con campo, operador (
=,<>,>,<,>=,<=,LIKE,NOT LIKE,IN,NOT IN,IS NULL,IS NOT NULL) y Valor. Desde la segunda condición eliges and u or. Sin condiciones: Sin filtros WHERE. - ORDER BY: Añadir crea un orden sobre uno de los campos del SELECT (Campo), asc o desc. Sin campos en el SELECT, la tarjeta dice Selecciona campos primero y el botón avisa; sin orden: Sin ordenación.
- HAVING: aparece solo con algún campo agrupado. Igual que WHERE, pero el campo se escribe a mano (Campo o alias). Sin condiciones: Sin filtros HAVING.
Ejecuta
Límite (de 1 a 1000, inicial 100) y Página (inicial 1) paginan el resultado. Pulsa Ejecutar. Sin campos, Play avisa Añade al menos un campo en SELECT.
Los resultados
Si el servidor devuelve error, aparece en rojo con el texto tal cual. Si no:
| Contador | Qué es |
|---|---|
| Filas devueltas | El total de filas de la consulta. |
| Página | La página devuelta. |
| Tiempo | Lo que tardó el servidor, en milisegundos. |
| Columnas | Cuántas columnas tiene el resultado. |
Debajo, la tabla Resultados (N filas), con 25 filas por página, orden y filtro por columna. Sin filas: La consulta no devolvió resultados. Al final, SQL generado muestra la consulta que ejecutó el servidor: es la forma de comprobar que los filtros y la agrupación se tradujeron como esperabas.
Límites
Los límites del servidor (filas por página, funciones admitidas, tiempo) están en IAQuery.