Compartir a través de


DataSet

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

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).