Conxunto de datos

Proporciona propiedades e métodos para traballar con datos en cuadrículas e vistas.

Dispoñible para

Aplicacións baseadas en modelos e canvas.

Propiedades

columnas

O conxunto de columnas dispoñibles neste conxunto de datos. Soportado tanto en aplicacións baseadas en modelos como en canvas.

Tipo: Columna[]

erro

Se se produciu un erro na recuperación de datos. Soportado tanto en aplicacións baseadas en modelos como en canvas.

Tipo: boolean

Código de erro

O código de erro asociado ao último erro atopado, se é o caso.

Mensaxe de erro

A mensaxe de erro asociada co último erro atopado, se é o caso.

Tipo: number | string

Filtrado

A columna que filtra a consulta actual. Soportado tanto en aplicacións baseadas en modelos como en canvas. O filtrado pode configurarse para un conxunto de datos configurando context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>). Unha vez establecido o filtro, a chamada context.parameters.[dataset_property_name].refresh() recupera os datos filtrados da fonte de datos.

Valor	Operador condicional	Aplicacións controladas por modelos	Aplicacións de lenzo
-1	Ningunha	Si	Si
0	Igual	Si	Si
1	Not Equal	Si	Si
2	Maior que	Si	Si
3	Menor que	Si	Si
4	Maior igual	Si	Si
5	Menos igual	Si	Si
6	Darlle a gústame	Si	Si
7	NotLike	No	Si
8	En	Si	Si
12	Nulo	Si	Si
13	NotNull	No	Si
14	Onte	Si	No
15	Hoxe	Si	No
16	Mañá	Si	No
17	Últimos 7 días	Si	No
18	Próximos 7 días	Si	No
19	Semana pasada	Si	No
20	Esta semana	Si	No
22	Último mes	Si	No
23	Este mes	Si	No
25	Activado	Si	No
26	OnOrBefore	Si	No
27	OnOrAfter	Si	No
28	Ano pasado	Si	No
29	Este ano	Si	No
33	LastXDays	Si	No
34	SeguinteXDays	Si	No
37	Últimas XMonths	Si	No
38	SeguinteXMonths	Si	No
49	Contén	Si	Si
54	Comezar con	No	Si
55	DoesNotBeginWidth	No	Si
56	Ancho dos extremos	No	Si
57	DesNotEndWith	No	Si
70	Período fiscal e ano	Si	No
75	Enriba	Si	Si
76	Abaixo	Si	Si
77	NotUnder	Si	Si
78	AboveOrEqual	Si	Si
79	UnderOrEqual	Si	Si
87	Valores de contención	Si	Si
88	DoesNotContainValues	No	Si

Nota

A función de filtrado só está dispoñible para a fonte de datos de Dataverse.

Tipo: Filtrado

Ligazón

Define a información da táboa enlazada. Soportado só en aplicacións baseadas en modelos.

Tipo: Ligazón

Cargando

Indica se o conxunto de datos está cargado ou non. Soportado tanto en aplicacións baseadas en modelos como en canvas.

Tipo: boolean

Paginación

Estado e accións de paginación. Soportado tanto en aplicacións baseadas en modelos como en canvas. Pódese acceder á información de paginación e configurarse para un conxunto de datos usando context.parameters.[dataset_property_name].paging .

Nota

A fonte de datos de Dataverse non devolve o obxecto totalRecordCount in paging para as aplicacións de canvas. En vez diso, usa hasNextPage e hasPreviousPage para comprobar se hai máis rexistros para ser obtidos.

Os compoñentes do conxunto de datos poden usar context.parameters.[dataset_property_name].paging.setPageSize(pageSize) para cambiar o número de rexistros recuperados por páxina.

Tipo: Paging

Rexistros

Mapa de IDs ao obxecto de rexistro completo. Soportado tanto en aplicacións baseadas en modelos como en canvas.

Tipo: EntityRecord

sortedRecordIds

ID dos rexistros no conxunto de datos, ordenados polo resultado da resposta á consulta. Soportado tanto en aplicacións baseadas en modelos como en canvas.

Tipo: string[]

Ordenación

O estado de ordenación da consulta actual. Soportado tanto en aplicacións baseadas en modelos como en canvas. A ordenación pode configurarse para un conxunto de datos configurando context.parameters.[dataset_property_name].sorting = [SortStatus]. Unha vez configurada a ordenación, a chamada context.parameters.[dataset_property_name].refresh() recupera os datos ordenados da fonte de datos.

Nota

A función de ordenación só está dispoñible para a fonte de datos de Dataverse. Ademais, se se reconfigura a ordenación, restablecerase o filtro context.parameters.[dataset_property_name].filtering

Tipo: SortStatus[]

Métodos

Método	Descrición	Dispoñible para
Engadir Columna	Engade unha columna ao conxunto de columnas.	Aplicacións controladas por modelos
clearSelectedRecordIds	Limpa a lista de identificadores de rexistro seleccionados.	Aplicacións baseadas en modelos e Canvas
Borrar	Eliminar os rexistros da fonte de datos.	Aplicacións de lenzo
getCommands	Os comandos do conxunto de datos.	Aplicacións de lenzo
getDataSetCapabilities	As capacidades do conxunto de datos.	Aplicacións de lenzo
getSelectedRecordIds	Recupera todos os identificadores de rexistro seleccionados.	Aplicacións baseadas en modelos e Canvas
getTargetEntityType	Devolve o nome do tipo de táboa de destino.	Aplicacións baseadas en modelos e Canvas
getTitle	Recupera o nome de visualización da vista empregado pola propiedade do conxunto de datos.	Aplicacións baseadas en modelos e Canvas
getViewId	Devolve o Id de view usado polo parámetro do conxunto de datos.	Aplicacións baseadas en modelos e Canvas
Novo rexistro	Inicializar un obxecto de rexistro local para que o control estableza o valor. O control debe invocar o save() método no rexistro recentemente creado para manter o cambio.	Aplicacións de lenzo
openDatasetItem	Abrir o elemento do conxunto de datos para unha determinada EntityReference. Comproba se hai un comando co ID Mscrm.OpenRecordItemdo botón de comando. Se existe, executa o comando, se non, simplemente navega ao formulario asociado de EntityReference.	Aplicacións baseadas en modelos e Canvas
Actualizar	Actualiza o conxunto de datos en función de filtros, ordenación, ligazón, nova columna. Ademais, a actualización restablecerá a páxina á páxina 1.	Aplicacións baseadas en modelos e Canvas
retrieveRecordCommand	Recuperar os comandos asociados ao rexistro. Se hai varios conxuntos de datos no manifesto, retrieveRecordCommand devolve os comandos para o primeiro conxunto de datos.	Baseado en modelos
setSelectedRecordIds	Establece os identificadores dos rexistros seleccionados.	Aplicacións baseadas en modelos e Canvas

Buscar columnas

Agora pódense recuperar as columnas de busca da táboa de Dataverse. Para as aplicacións de lenzo, se se inclúe unha columna de busca no conxunto de datos, obscócense todas as columnas do rexistro referido. GetFormattedValue Devolve a cadea JSON para esta columna. GetValue O método devolve directamente o obxecto JSON.

Exemplo

Para obter máis información sobre como implementar os métodos do conxunto de datos, consulte Compoñente DataSet Grid

Artigos relacionados

Referencia da API do marco de compoñentes de Power Apps
Visión xeral do marco de compoñentes de Power Apps