Descubre cómo consultar tus tablas de Tulip y crear agregaciones a las que se puede acceder desde las aplicaciones de Tulip
En este artículo aprenderás...
- Las capacidades de las consultas y agregaciones de tablas
- Cómo crear consultas y agregaciones
- Cómo utilizar consultas y agregaciones en las aplicaciones
Descripción general
Las consultas y agregaciones de tablas te permiten interactuar con las tablas de forma dinámica, filtrando y resumiendo tus datos para utilizarlos en las aplicaciones.
Para este artículo, tomaremos como referencia la siguiente tabla de pedidos, que tiene 10 filas:
En la esquina superior derecha, puedes ver los botones «Consultas » y «Agregaciones». Haz clic en «Consultas » para añadir una nueva consulta.
En el siguiente ejemplo se utiliza un filtro para mostrar únicamente los registros que aún no se han enviado:
Las agregaciones se añaden sobre una consulta y se crean a nivel de tabla, al igual que las consultas. Haz clic en «Agregaciones» para crear una nueva agregación.
El siguiente ejemplo sumará el campo de la tabla «Cantidad de producto»:
Consultas
Una consulta te permite filtrar y ordenar los datos de una tabla. Las consultas pueden utilizar valores estáticos o valores dinámicos basados en la entrada de la aplicación.
Filtros
Filtra los registros comparando una columna específica, o varias columnas, con un valor estático o con una entrada de la aplicación.
Algunos ejemplos de opciones de comparación son:
- igual a / no igual a
- es nulo / no es nulo
- contiene / no contiene
- empieza por / no empieza por
- termina en / no termina en
- está en
- es mayor o igual que / es menor o igual que
- está después o en / está antes o en
El «Valor estático» se establecerá de forma estática al crear la consulta, pero la «Entrada de la aplicación» se configurará en la propia aplicación. La «Entrada de la aplicación » se puede configurar como:
- Variable
- Valor estático
- Información de la aplicación
- Registro de la tabla de Tulip
Ahora puedes utilizar los campos «Creado el » y «Actualizado el » en las consultas de tabla.
Ordenación
Personaliza la visualización de los registros configurando la opción «Ordenar ». Algunos ejemplos son:
- De la A a la Z / De la Z a la A
- Del 0 al 9 / Del 9 al 0
Límites
El número máximo de registros devueltos por una consulta.
- Por defecto: 1.000
- Máximo: 1.000
:::(Advertencia) (Comportamiento al alcanzar el límite)
Si en tu tabla hay más « records » que coincidan con los filtros de la consulta (o, en general, si no configuras ningún filtro) que el límite establecido, solo se incluirán en el resultado de la consulta tantos como especifique dicho límite.
Si la consulta incluye una ordenación, se incluirán los primeros « records » según dicha ordenación.
:::
Prueba
Tras configurar la consulta estableciendo las opciones de filtro, ordenación y límite, la consulta se puede probar directamente en la tabla haciendo clic en «Probar». Esto simulará lo que la consulta devolvería en una aplicación.
Usar consultas en aplicaciones
Para añadir una consulta a una aplicación, primero añade la tabla a la aplicación haciendo clic en la pestaña «Registros» y, a continuación, en «+Añadir tabla». A continuación, haz clic en «Consulta».
En la ventana modal que aparece, asigna un «Nombre de consulta» a la consulta y, si procede, configura la «Entrada de la aplicación» asociada al filtro. En este ejemplo, fíjate en la consulta «Productos no enviados»:
Ahora que la consulta está configurada en la aplicación, incrusta una tabla interactiva y selecciona la consulta como fuente de datos.
La tabla incrustada mostrará los resultados de la consulta. En este ejemplo, se devuelven 3 registros que cumplen el filtro**«Enviado» igual a «No»:**
Agregaciones
Las agregaciones son valores de resumen que se aplican sobre las consultas y pueden calcular uno de los siguientes valores para una columna concreta:
Promedio* Devuelve el promedio de números o enteros
Recuento* Devuelve el recuento de registros; no se requiere ningún campo
Máx.* Devuelve el máximo de números o enteros
Mín.* Devuelve el mínimo de números o enteros
Moda* Devuelve el valor más frecuente* Nota: si dos valores tienen la misma frecuencia, siempre se devolverá el valor más bajo.
Suma* Devuelve la suma de números o enteros
Valores únicos* Devuelve una matriz con los valores únicos individuales de la consulta dada, de cualquier tipo de datos
Límites
Las agregaciones pueden tener en cuenta un máximo de 1.000 registros.
Las agregaciones se realizan sobre los registros devueltos por la consulta configurada. El límite establecido para la consulta principal de una agregación también se aplica a la propia agregación (1.000 registros).
Una agregación puede mostrar resultados inesperados si la tabla tiene más registros para los filtros especificados que el límite y el usuario no conoce el límite de la consulta.
Si necesitas agregar más de 1.000 registros para utilizarlos en una aplicación, utiliza el punto final runAggregation de la API de Tulip, que admite hasta 100.000 registros, a través de una función de conector.
Si solo necesitas visualizar una agregación de más de 1 000 registros, crea un análisis de «valor único» con Analytics, que permite agregar todos los registros de una tabla.
Utilizar agregaciones en las aplicaciones
De forma similar a como se añade una consulta a una aplicación, añade una agregación haciendo clic en «+Añadir agregación» y asigna un nombre a la agregación.
En este ejemplo, la agregación «Cantidad total de productos pedidos» se aplica a la consulta que devuelve únicamente los registros que no se han enviado. Por este motivo, el nombre de la agregación es «Cantidad de productos pendientes de envío»:
Para integrar la agregación en una aplicación, arrastra una variable a la aplicación y selecciona la fuente de datos «Tulip Table Aggregation». A continuación, selecciona el nombre de la agregación que se configuró al añadirla a la aplicación.
En este ejemplo, la agregación «Suma de la cantidad de productos » se aplicó a la consulta que devuelve los registros que deben enviarse. Esto devuelve un total de 17:
Uso de agregaciones en la lógica de la aplicación
Con las agregaciones, tienes la posibilidad de crear lógica de la aplicación en torno al valor de una agregación. Consulta el ejemplo siguiente:
Ten en cuenta que, actualmente, no se puede acceder a los análisis de Tulip de un solo número desde una aplicación, por lo que no se pueden aprovechar directamente en la lógica de la aplicación. Al ejecutar una agregación a partir de una consulta, podrás utilizar este valor y, de este modo, crear la lógica de la aplicación en torno a él.
{{snippet.¿Has encontrado lo que buscabas?}}