Creador de consultas

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

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:

   • Y: devuelve datos donde se cumplen todas las condiciones

   • O: 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. En la pestaña Ajustes adicionales, puedes configurar reglas de clasificación para los datos consultados:

   Opción	Descripción
   Ordenar por campo	Ordena los datos consultados por el campo seleccionado
   Orden ascendente	Si es verdadero, ordena los datos consultados en orden ascendente.

9. Haz clic en Guardar para guardar tu consulta.

La función Obtener

El Generador de consultas utiliza la función Fetch() para recuperar y manipular datos de la entidad.

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.

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"})