Compartir a través de

DataSet

  • Artículo

Proporciona propiedades y métodos para trabajar con los datos en cuadrículas y vistas.

Disponible para

Aplicaciones de lienzo y basadas en modelo.

Propiedades

columnas

El conjunto de columnas disponibles en este conjunto de datos. Se admite tanto en las aplicaciones basadas en modelos como en las de lienzo.

Tipo: Columna[]

error

Si se ha producido un error en recuperación de datos. Se admite tanto en las aplicaciones basadas en modelos como en las de lienzo.

Tipo: boolean

errorCode

El código de error asociado al último error encontrado, si es aplicable.

errorMessage

El mensaje de error asociado al último error encontrado, si procede.

Tipo: number | string

filtering

El filtro de columnas de la consulta actual. Se admite tanto en las aplicaciones basadas en modelos como en las de lienzo. El filtrado se puede configurar para un conjunto de datos estableciendo context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>). Una vez que el filtro está configurado, al llamar a context.parameters.[dataset_property_name].refresh(), se recuperan los datos filtrados del origen de datos.

valor Operador condicional Aplicaciones basadas en modelos Aplicaciones de lienzo
-1 Nada Sí Sí
0 Es igual a Sí Sí
1 NotEqual Sí Sí
2 GreaterThan Sí Sí
3 Menor que Sí Sí
4 GreaterEqual Sí Sí
5 LessEqual Sí Sí
6 Como Sí Sí
7 NotLike No Sí
8 En Sí Sí
12 Null Sí Sí
13 NotNull No Sí
14 Ayer Sí No
15 Hoy Sí No
16 Mañana Sí No
17 Last7Days Sí No
18 Next7Days Sí No
19 LastWeek Sí No
20 ThisWeek Sí No
22 LastMonth Sí No
23 ThisMonth Sí No
25 Activado Sí No
26 OnOrBefore Sí No
27 OnOrAfter Sí No
28 LastYear Sí No
29 ThisYear Sí No
33 LastXDays Sí No
34 NextXDays Sí No
37 LastXMonths Sí No
38 NextXMonths Sí No
49 Contiene Sí Sí
54 BeginWith No Sí
55 DoesNotBeginWidth No Sí
56 EndsWidth No Sí
57 DesNotEndWith No Sí
70 InFiscalPeriodAndYear Sí No
75 Por encima Sí Sí
76 Por debajo Sí Sí
77 NotUnder Sí Sí
78 AboveOrEqual Sí Sí
79 UnderOrEqual Sí Sí
87 ContainValues Sí Sí
88 DoesNotContainValues No Sí

Nota

La función de filtrado solo está disponible para el origen de datos de Dataverse.

Tipo: Filtering

linking

Define la información de la tabla vinculada. Solo se admite en aplicaciones basadas en modelos.

Tipo: Linking

cargando

Indica si el conjunto de datos se está cargando o no. Se admite tanto en las aplicaciones basadas en modelos como en las de lienzo.

Tipo: boolean

paging

Estado y acciones de paginación. Se admite tanto en las aplicaciones basadas en modelos como en las de lienzo. Se puede acceder a la información de paginación y configurarla para un conjunto de datos usando context.parameters.[dataset_property_name].paging .

Nota

El origen de datos de Dataverse no devuelve totalRecordCount en el objeto de paginación para aplicaciones de lienzo. En cambio, usa hasNextPage y hasPreviousPage para comprobar si hay más registros que recuperar.

Los componentes del conjunto de datos pueden utilizar context.parameters.[dataset_property_name].paging.setPageSize(pageSize) para cambiar el número de registros recuperados por página.

Tipo: Paging

records

Asignación de identificadores al objeto de registro completo. Se admite tanto en las aplicaciones basadas en modelos como en las de lienzo.

Tipo: EntityRecord

sortedRecordIds

ID de los registros en conjunto de datos, ordenados por el resultado de la respuesta a la consulta. Se admite tanto en las aplicaciones basadas en modelos como en las de lienzo.

Tipo: string[]

sorting

El estado de clasificación de la consulta actual. Se admite tanto en las aplicaciones basadas en modelos como en las de lienzo. La ordenación se puede configurar para un conjunto de datos estableciendo context.parameters.[dataset_property_name].sorting = [SortStatus]. Una vez que la ordenación está configurada, al llamar a context.parameters.[dataset_property_name].refresh(), se recuperan los datos ordenados del origen de datos.

Nota

La característica de ordenación solo está disponible para el origen de datos de Dataverse. Además, si se reconfigura la ordenación, se restablecerá el filtro context.parameters.[dataset_property_name].filtering

Tipo: SortStatus[]

Métodos

Método Descripción Disponible para
addColumn Agrega una columna al conjunto de columnas. Aplicaciones basadas en modelo
clearSelectedRecordIds Borra la lista de id. de registros seleccionados. Aplicaciones de lienzo y basadas en modelo
delete Eliminación de todos los registros de un origen de datos. Aplicaciones de lienzo
getCommands Los comandos para el conjunto de datos. Aplicaciones de lienzo
getDataSetCapabilities Las funcionalidades del conjunto de datos. Aplicaciones de lienzo
getSelectedRecordIds Recupera todos los Id. de registros seleccionados. Aplicaciones de lienzo y basadas en modelo
getTargetEntityType Devuelve el nombre del tipo de tabla de destino. Aplicaciones de lienzo y basadas en modelo
getTitle Recupera la vista nombre utilizada por la propiedad conjunto de datos. Aplicaciones de lienzo y basadas en modelo
getViewId Devuelve el id. de vista utilizado por el parámetro conjunto de datos. Aplicaciones de lienzo y basadas en modelo
newRecord Inicializa un objeto de registro local para que el control establezca el valor. El control necesita invocar el método save() en el registro recién creado para persistir el cambio. Aplicaciones de lienzo
openDatasetItem Abre el elemento conjunto de datos para una EntityReference determinada. Comprueba si hay un comando con el Id. de botón de comando en Mscrm.OpenRecordItem. Si existe, ejecuta el comando, en caso contrario navega al formulario asociado de la EntityReference. Aplicaciones de lienzo y basadas en modelo
refresh Actualiza el conjunto de datos basado en filtros, clasificación, vinculación, nueva columna. Además, la actualización restablecerá la paginación a la página 1. Aplicaciones de lienzo y basadas en modelo
retrieveRecordCommand Recupera los comandos asociados al registro. Si hay varios conjuntos de datos en el manifiesto, retrieveRecordCommand devuelve los comandos para el primer conjunto de datos. Basada en modelo
setSelectedRecordIds Establece los identificadores de los registros seleccionados. Aplicaciones de lienzo y basadas en modelo

Columnas de búsqueda

Ahora se pueden recuperar las columnas de búsqueda de la tabla de Dataverse. Para las aplicaciones de lienzo, si se incluye una columna de búsqueda en el conjunto de datos, se recuperan todas las columnas del registro referido. GetFormattedValue devuelve la cadena JSON para esta columna. El método GetValue devuelve el objeto JSON directamente.

Ejemplo

Para obtener más información sobre cómo implementar métodos del conjunto de dato, consulte Componente de cuadrícula de DataSet

Referencia de la API de Power Apps component framework
Información general sobre Power Apps component framework

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).