Partilhar via

Conjunto de dados

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

Disponível para

Aplicativos orientados a modelos e de tela.

Propriedades

columns

O conjunto de colunas disponíveis neste conjunto de dados. Suportado em aplicativos orientados por modelo e de tela.

Tipo: Coluna[]

erro

Se ocorreu um erro na recuperação de dados. Suportado em aplicativos orientados por modelo e de 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. Suportado em aplicativos orientados por modelo e de 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.

Valor Operador condicional Aplicações condicionadas por modelos Aplicações de tela
-1 Nenhum Yes Yes
0 Igual Yes Yes
1 NotEqual Yes Yes
2 GreaterThan Yes Yes
3 MenosQue Yes Yes
4 MaiorIgual Yes Yes
5 MenosIgual Yes Yes
6 Gosto Yes Yes
7 NotLike Não Yes
8 In Yes Yes
12 Null Yes Yes
13 NotNull Não Yes
14 Ontem Yes Não
15 Hoje Yes Não
16 Tomorrow Yes Não
17 Últimos 7Dias Yes Não
18 Próximo7Dias Yes Não
19 Última Semana Yes Não
20 Esta Semana Yes Não
22 Último Mês Yes Não
23 Este Mês Yes Não
25 On Yes Não
26 OnOrBefore Yes Não
27 OnOrAfter Yes Não
28 Último Ano Yes Não
29 Este Ano Yes Não
33 LastXDays Yes Não
34 PróximoXDays Yes Não
37 LastXMonths Yes Não
38 PróximoXMonths Yes Não
49 Contém Yes Yes
54 Comece com Não Yes
55 DoesNotBeginWidth Não Yes
56 EndsWidth Não Yes
57 DesNotEndWith Não Yes
70 InFiscalPeriodAndYear Yes Não
75 Superior Yes Yes
76 Inferior 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 Dataverse.

Tipo: Filtragem

ligação

Define as informações da tabela vinculada. Suportado apenas em aplicações orientadas por modelos.

Tipo: Ligação

carregando

Indica se o conjunto de dados está sendo carregado ou não. Suportado em aplicativos orientados por modelo e de tela.

Tipo: boolean

paginação

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

Observação

A fonte de dados Dataverse não retorna o totalRecordCount objeto in paging para 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: Paging

registos

Mapa de IDs para o objeto de registro completo. Suportado em aplicativos orientados por modelo e de tela.

Tipo: EntityRecord

sortedRecordIds

IDs dos registros no conjunto de dados, ordenados pelo resultado da resposta da consulta. Suportado em aplicativos orientados por modelo e de tela.

Tipo: string[]

Classificação

O status de classificação da consulta atual. Suportado em aplicativos orientados por modelo e de tela. A classificação pode ser configurada para um conjunto de dados pela configuração 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 Dataverse. Além disso, se a classificação for reconfigurada, o filtro será redefinido context.parameters.[dataset_property_name].filtering

Tipo: SortStatus[]

Methods

Método Description Disponível para
addColumn Adiciona coluna ao conjunto de colunas. Aplicações condicionadas por modelos
clearSelectedRecordIds Limpa a lista de ids de registro selecionada. Aplicativos orientados a modelos e Canvas
delete Exclua os registros da fonte de dados. Aplicações de tela
getCommands Os comandos para o conjunto de dados. Aplicações de tela
getDataSetCapabilities Os recursos para o conjunto de dados. Aplicações de tela
getSelectedRecordIds Recupera todas as IDs de registro selecionadas. Aplicativos orientados a modelos e Canvas
getTargetEntityType Retorna o nome do tipo de tabela de destino. Aplicativos orientados a modelos e Canvas
getTítulo Recupera o nome de exibição usado pela propriedade do conjunto de dados. Aplicativos orientados a modelos e Canvas
getViewId Retorna o Id de exibição usado pelo parâmetro dataset. Aplicativos orientados a modelos e Canvas
novoRecord 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. Aplicações de tela
openDatasetItem Abra o item de conjunto de dados para um determinado EntityReference. Ele verifica se há um comando com o ID Mscrm.OpenRecordItemdo botão de comando. Se existir, ele executa o comando, caso contrário, ele apenas navega para a forma associada do EntityReference. Aplicativos orientados a 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 orientados a modelos e Canvas
retrieveRecordCommand Recuperar comandos associados do registro. Se houver vários conjuntos de dados no manifesto, retrieveRecordCommand retornará os comandos para o primeiro conjunto de dados. Condicionada por modelo
setSelectedRecordIds Defina as ids dos registros selecionados. Aplicativos orientados a 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 referido serão recuperadas. GetFormattedValue retorna a cadeia de caracteres JSON para esta coluna. GetValue método retorna o objeto JSON diretamente.

Example

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

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

  • Last updated on