Creador de consultas

El Generador de consultas te permite filtrar datos de las entidades de Data Service, respetando una sintaxis predefinida.

Importante:

Las funciones Fetch, FetchOne, GetChoiceSet y GetChoiceSetValue son asíncronas y no admiten el encadenamiento.

Para mostrar registros de entidad en un control, utiliza una variable de aplicación y la regla Establecer valor .

También puedes vincular el origen de datos de control a tu entidad utilizando el Creador de consultas. Consulta Uso de las funciones Fetch para ver ejemplos prácticos.

Para actualizar una variable de entidad al cargar la página o al hacer clic en un botón, añade una regla Establecer valor . Abre el Generador de consultas en la regla de valor establecido y añade una condición de filtro para UpdateTime <= now( ).

Cómo utilizar el creador de consultas

El Generador de consultas utiliza la función Fetch() para evaluar y ordenar tus entidades de Data Service.

Como requisito previo, debes hacer referencia a las entidades existentes de Data Service en tu aplicación. Para utilizar el Generador de consultas, sigue los siguientes pasos:

1. Para el control deseado, selecciona una propiedad Habilitada VB. Puedes identificar estos tipos de propiedades por el campo Fuente de datos VB en la pestaña General.

   

2. Selecciona Generador de consultas. Esto abre la ventana Generador de consultas.

3. Selecciona la entidad para la que quieres crear la consulta.

4. En la pestaña Condiciones, haz clic:

   Opción	Descripción
   Añadir condición	para añadir una sola condición
   Añadir grupo	para agrupar varias condiciones

   Al añadir dos o más condiciones, la consulta evalúa y devuelve los datos en función de los operadores Y u O:

   • AND : devuelve datos donde se cumplen todas las condiciones
   • OR : devuelve datos donde se cumple cualquier condición

5. Selecciona el campo de la entidad del que quieres consultar datos.

6. Selecciona el operador de evaluación.

7. Introduce el valor para tu condición. El valor debe ser del mismo tipo que el tipo de campo. Por ejemplo, usa cadenas para campos de Texto, usa enteros para campos de Número.

8. Opcionalmente, configura reglas para los datos consultados en la pestaña Configuración adicional .

9. Selecciona Guardar para guardar tu consulta.

Ajustes adicionales

En la pestaña Configuración adicional , puedes configurar reglas para los datos consultados.

La siguiente tabla describe los elementos de la pestaña Configuración adicional .

Elemento	Descripción
Índice de inicio de página (omitir)	Te permite definir cuántos registros omitir antes de comenzar a devolver resultados. Por ejemplo, si introduces 10 , la consulta se inicia desde el registro 11. Establecer un índice de inicio de página puede ser útil para la paginación cuando se utilizan grandes conjuntos de datos.
Límite de página (arriba)	Te permite establecer el número máximo de registros que se devolverán. Por ejemplo, si introduces 50, la consulta devuelve las primeras 50 filas. Establecer un límite de página ayuda a controlar el tamaño de la consulta.
Añadir campo de clasificación	Añade un campo de clasificación que te permite configurar una regla de clasificación para los datos consultados. Se mostrarán los campos Ordenar por y Ordenar de forma ascendente .
Ordenar por campo	Te permite introducir el campo que utilizarás para ordenar los datos.
Orden ascendente	Si es verdadero, ordena los datos consultados en orden ascendente.
Proyección	Te permite definir un campo específico de la entidad que solo debe incluirse en el conjunto de resultados. La proyección puede utilizarse para simplificar los datos de salida. La proyección solo está disponible cuando el Generador de consultas se abre desde la regla Establecer valor.

La función Obtener

El creador de consultas utiliza la función Fetch() para recuperar y manipular los datos de la entidad. La función Fetch() es asíncrona y no admite el encadenamiento.

La función Fetch() tiene los siguientes parámetros:

Parámetro	Descripción
FilterGroup	Un grupo de filtros en Data Service
PaginationProps	Especifica el tamaño de la página y el número de registros que quieres omitir.
SortOption[] sortOptions	Especifica la columna que quieres clasificar y el orden para la clasificación.
string[] selectedFields	Especifica los campos de la entidad que deben devolverse.
ExpansionFieldOption[] expansionFieldOptions	Especifica qué columnas de una entidad de relación debe expandirse y devolverse. Apps permite expansiones de nivel uno, lo que significa que si tienes un campo de relación, las expresiones esperan que un nivel de propiedades sea accesible. El generador de consultas añade automáticamente estas propiedades, y son obligatorias para las entidades no pertenecientes al sistema.

The FetchOne() function

Mientras que Fetch() devuelve un ListSource<T>, que es el mismo tipo que para los controles de lista, FetchOne() devuelve un solo registro de tipo T.

Al igual que la funciónFetch() , la función FetchOne() es asíncrona y no admite el encadenamiento.

Para los siguientes escenarios, debes modificar manualmente la función Fetch(), para obtener resultados más personalizados:

Obtener simple

Obtiene el número de registros para una entidad, por ejemplo SystemUsers.

Fetch(of SystemUsers)()

Obtener con condición del filtro

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10))

Obtener con condición del filtro y orden de clasificación (ascendente)

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date")})

Obtener con condición del filtro y orden de clasificación (descendente)

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), new SortOption(){addSortOption("Date", true)})

Obtener con PaginationProps estático

Fetch(of SystemUsers)(Nothing, new PaginationProps(0, 100))

Obtener con PaginationProps vinculado al control

Por ejemplo, para el control Editar cuadrícula:

Fetch(of SystemUsers)(Nothing, new PaginationProps(MainPage.EditableGrid.PageStart, MainPage.EditableGrid.PageLimit))

Obtener con proyección

Fetch(of SystemUsers)(createFilterGroup(new QueryFilter(){addFilter("Name", "=", "You")}), new PaginationProps(0, 10), Nothing, new string(){"Name"})