Compartilhar via

Dataset

Fornece propriedades e métodos para trabalhar com dados em grades e exibições.

Disponível para

Aplicativos baseados em modelo e tela.

Propriedades

columns

O conjunto de colunas disponíveis neste conjunto de dados. Com suporte em aplicativos baseados em modelo e tela.

Tipo: Coluna[]

erro

Se ocorreu um erro na recuperação de dados. Com suporte em aplicativos baseados em modelo e tela.

Tipo: boolean

código de erro

O código de erro associado ao último erro encontrado, se aplicável.

errorMessage

A mensagem de erro associada ao último erro encontrado, se aplicável.

Tipo: number | string

filtragem

A filtragem de coluna para a consulta atual. Com suporte em aplicativos baseados em modelo e tela. A filtragem pode ser configurada para um conjunto de dados definindo context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>). Depois que o filtro é definido, a chamada context.parameters.[dataset_property_name].refresh() recupera os dados filtrados da fonte de dados.

Value Operador condicional Aplicativos baseados em modelo Aplicativos de tela
-1 None Yes Yes
0 Igual Yes Yes
1 NotEqual Yes Yes
2 GreaterThan Yes Yes
3 LessThan Yes Yes
4 GreaterEqual Yes Yes
5 LessEqual Yes Yes
6 Gostar Yes Yes
7 NotLike Não Yes
8 In Yes Yes
12 Nulo Yes Yes
13 NotNull Não Yes
14 Ontem Yes Não
15 Hoje Yes Não
16 Amanhã Yes Não
17 Last7Days Yes Não
18 Next7Days Yes Não
19 LastWeek Yes Não
20 ThisWeek Yes Não
22 LastMonth Yes Não
23 ThisMonth Yes Não
vinte e cinco Por Yes Não
26 OnOrBefore Yes Não
27 OnOrAfter Yes Não
28 LastYear Yes Não
29 ThisYear Yes Não
33 LastXDays Yes Não
34 NextXDays Yes Não
37 LastXMonths Yes Não
38 NextXMonths Yes Não
49 Contém Yes Yes
54 BeginWith Não Yes
55 DoesNotBeginWidth Não Yes
56 EndsWidth Não Yes
57 DesNotEndWith Não Yes
70 InFiscalPeriodAndYear Yes Não
75 Acima Yes Yes
76 Sob Yes Yes
77 NotUnder Yes Yes
78 AboveOrEqual Yes Yes
79 UnderOrEqual Yes Yes
87 ContainValues Yes Yes
88 DoesNotContainValues Não Yes

Observação

O recurso de filtragem só está disponível para a fonte de dados do Dataverse.

Tipo: Filtragem

Ligando

Define as informações da tabela vinculada. Com suporte apenas em aplicativos controlados por modelos.

Tipo: Vinculação

a carregar

Indica se o conjunto de dados está carregando ou não. Com suporte em aplicativos baseados em modelo e tela.

Tipo: boolean

Paginação

Status e ações de paginação. Com suporte em aplicativos baseados em modelo e tela. As informações de paginação podem ser acessadas e configuradas para um conjunto de dados usando context.parameters.[dataset_property_name].paging .

Observação

A fonte de dados do Dataverse não retorna o totalRecordCount objeto de paginação em aplicativos de tela. Em vez disso, ele usa hasNextPage e hasPreviousPage para verificar se há mais registros a serem buscados.

Os componentes do conjunto de dados podem ser usados context.parameters.[dataset_property_name].paging.setPageSize(pageSize) para alterar o número de registros recuperados por página.

Tipo: Paginação

arquivo

Mapa de IDs para o objeto de registro completo. Com suporte em aplicativos baseados em modelo e tela.

Tipo: EntityRecord

sortedRecordIds

IDs dos registros no conjunto de dados, ordem pelo resultado da resposta da consulta. Com suporte em aplicativos baseados em modelo e tela.

Tipo: string[]

Classificação

O status de classificação da consulta atual. Com suporte em aplicativos baseados em modelo e tela. A classificação pode ser configurada para um conjunto de dados definindo context.parameters.[dataset_property_name].sorting = [SortStatus]. Depois que a classificação é configurada, a chamada context.parameters.[dataset_property_name].refresh() recupera os dados classificados da fonte de dados.

Observação

O recurso de classificação só está disponível para a fonte de dados do Dataverse. Além disso, se a classificação for configurada novamente, ela redefinirá o filtro context.parameters.[dataset_property_name].filtering

Tipo: SortStatus[]

Methods

Método Description Disponível para
addColumn Adiciona a coluna ao conjunto de colunas. Aplicativos baseados em modelo
clearSelectedRecordIds Limpa a lista de IDs de registro selecionadas. Aplicativos baseados em modelos e canvas
delete Exclua os registros da fonte de dados. Aplicativos de tela
getCommands Os comandos do conjunto de dados. Aplicativos de tela
getDataSetCapabilities Os recursos do conjunto de dados. Aplicativos de tela
getSelectedRecordIds Recupera todas as IDs de registro selecionadas. Aplicativos baseados em modelos e canvas
getTargetEntityType Retorna o nome do tipo de tabela de destino. Aplicativos baseados em modelos e canvas
getTitle Recupera o nome de exibição de exibição usado pela propriedade do conjunto de dados. Aplicativos baseados em modelos e canvas
getViewId Retorna a ID da exibição usada pelo parâmetro de conjunto de dados. Aplicativos baseados em modelos e canvas
newRecord Inicialize um objeto de registro local para controle para definir o valor. O controle precisa invocar o save() método no registro recém-criado para persistir a alteração. Aplicativos de tela
openDatasetItem Abra o item do conjunto de dados para uma determinada EntityReference. Ele verifica se há um comando com a ID Mscrm.OpenRecordItemdo botão de comando. Se existir, ele executará o comando, caso contrário, ele navegará apenas para a forma associada da EntityReference. Aplicativos baseados em modelos e canvas
atualizar Atualiza o conjunto de dados com base em filtros, classificação, vinculação, nova coluna. Além disso, a atualização redefinirá a paginação para a página 1. Aplicativos baseados em modelos e canvas
retrieveRecordCommand Recupere os comandos associados do registro. Se houver vários conjuntos de dados no manifesto, retrieveRecordCommand retornará os comandos do primeiro conjunto de dados. Baseado em modelo
setSelectedRecordIds Defina as IDs dos registros selecionados. Aplicativos baseados em modelos e canvas

Colunas de pesquisa

As colunas de pesquisa da tabela dataverse agora podem ser recuperadas. Para aplicativos de tela, se uma coluna de pesquisa for incluída no conjunto de dados, todas as colunas no registro referenciado serão recuperadas. GetFormattedValue retorna a cadeia de caracteres JSON para esta coluna. GetValue O método retorna o objeto JSON diretamente.

Example

Para saber mais sobre como implementar os métodos de conjunto de dados, consulte o componente Grade do DataSet

Referência da API da estrutura de componentes do Power Apps
Visão geral da estrutura de componentes do Power Apps

  • Last updated on