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.

Consejo: 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:

   • 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. Optionally, configure rules for the queried data on the Additional settings tab.
9. Select Save to save your query.

Ajustes adicionales

On the Additional settings tab, you can configure rules for the queried data.

The following table describes the elements of the Additional settings tab.

Elemento	Descripción
Page start index (skip)	Enables you to define how many records to skip before starting to return results. For example, if you enter 10, the query starts from the 11th record. Note: Setting a Page start index can be useful for pagination when using large datasets.
Page limit (top)	Enables you to set the maximum number of records to return. For example, if you enter 50, the query returns the first 50 rows. Note: Setting a Page limit helps control query size.
Add sort field	Adds a sort field that allows you to configure a sorting rule for the queried data. The Sort by field and the Sort ascending elements display.
Ordenar por campo	Enables you to enter the field you to use for sorting the data.
Orden ascendente	Si es verdadero, ordena los datos consultados en orden ascendente.
Projection	Enables you to define a specific field from the entity that only should be included in the result set. Nota: Projection can can be used to simplify output data.

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