Udostępnij przez

Dataset

Udostępnia właściwości i metody do pracy z danymi w siatkach i widokach.

Dostępne dla

Aplikacje oparte na modelu i kanwy.

Właściwości

columns

Zestaw kolumn dostępnych w tym zestawie danych. Obsługiwane w aplikacjach opartych na modelu i kanwie.

Typ: Kolumna[]

błąd

Czy wystąpił błąd podczas pobierania danych. Obsługiwane w aplikacjach opartych na modelu i kanwie.

Typ: boolean

kod błędu

Kod błędu skojarzony z ostatnim napotkanym błędem, jeśli ma to zastosowanie.

errorMessage

Jeśli ma to zastosowanie, komunikat o błędzie skojarzony z ostatnim napotkanym błędem.

Typ: number | string

Filtrowanie

Filtrowanie kolumn dla bieżącego zapytania. Obsługiwane w aplikacjach opartych na modelu i kanwie. Filtrowanie można skonfigurować dla zestawu danych, ustawiając wartość context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>). Po ustawieniu filtru wywołanie context.parameters.[dataset_property_name].refresh() pobiera przefiltrowane dane ze źródła danych.

Wartość Operator warunkowy Aplikacje oparte na modelu Aplikacje kanwy
-1 Żaden Tak Tak
0 Równy Tak Tak
1 NotEqual Tak Tak
2 GreaterThan Tak Tak
3 LessThan Tak Tak
4 GreaterEqual Tak Tak
5 LessEqual Tak Tak
6 Lubić Tak Tak
7 NotLike Nie. Tak
8 In Tak Tak
12 Null Tak Tak
13 NotNull Nie. Tak
14 Wczoraj Tak Nie.
15 Dzisiaj Tak Nie.
16 Jutro Tak Nie.
17 Last7Days Tak Nie.
18 Next7Days Tak Nie.
19 LastWeek Tak Nie.
20 ThisWeek Tak Nie.
22 Ostatni miesiąc Tak Nie.
23 Ten miesiąc Tak Nie.
25 On Tak Nie.
26 OnOrBefore Tak Nie.
27 OnOrAfter Tak Nie.
28 LastYear Tak Nie.
29 Ten Year Tak Nie.
33 LastXDays Tak Nie.
34 NextXDays Tak Nie.
37 LastXMonths Tak Nie.
38 NextXMonths Tak Nie.
49 Zawiera Tak Tak
54 BeginWith Nie. Tak
55 DoesNotBeginWidth Nie. Tak
56 EndsWidth Nie. Tak
57 DesNotEndWith Nie. Tak
70 InFiscalPeriodAndYear Tak Nie.
75 Ponad Tak Tak
76 Pod Tak Tak
77 NotUnder Tak Tak
78 AboveOrEqual Tak Tak
79 UnderOrEqual Tak Tak
87 ContainValues Tak Tak
88 DoesNotContainValues Nie. Tak

Uwaga / Notatka

Funkcja filtrowania jest dostępna tylko dla źródła danych Dataverse.

Typ: filtrowanie

Łączenie

Definiuje informacje o tabeli połączonej. Obsługiwane tylko w aplikacjach opartych na modelu.

Typ: Łączenie

Ładowania

Wskazuje, czy zestaw danych jest ładowany, czy nie. Obsługiwane w aplikacjach opartych na modelu i kanwie.

Typ: boolean

stronicowanie

Stan i akcje stronicowania. Obsługiwane w aplikacjach opartych na modelu i kanwie. Dostęp do informacji o stronicowaniu można uzyskać i skonfigurować dla zestawu danych przy użyciu polecenia context.parameters.[dataset_property_name].paging .

Uwaga / Notatka

Źródło danych Usługi Dataverse nie zwraca totalRecordCount obiektu stronicowania dla aplikacji kanwy. Zamiast tego używa hasNextPage metody i hasPreviousPage do sprawdzania, czy jest więcej rekordów do pobrania.

Składniki zestawu danych mogą służyć context.parameters.[dataset_property_name].paging.setPageSize(pageSize) do zmiany liczby rekordów pobranych na stronę.

Typ: stronicowanie

Rekordy

Mapuj identyfikatory na obiekt pełnego rekordu. Obsługiwane w aplikacjach opartych na modelu i kanwie.

Typ: EntityRecord

sortedRecordIds

Identyfikatory rekordów w zestawie danych uporządkowane według wyniku odpowiedzi zapytania. Obsługiwane w aplikacjach opartych na modelu i kanwie.

Typ: string[]

Sortowania

Stan sortowania dla bieżącego zapytania. Obsługiwane w aplikacjach opartych na modelu i kanwie. Sortowanie można skonfigurować dla zestawu danych, ustawiając wartość context.parameters.[dataset_property_name].sorting = [SortStatus]. Po skonfigurowaniu sortowania wywołanie context.parameters.[dataset_property_name].refresh() pobiera posortowane dane ze źródła danych.

Uwaga / Notatka

Funkcja sortowania jest dostępna tylko dla źródła danych Dataverse. Ponadto jeśli sortowanie zostanie ponownie skonfigurowane, zresetuje filtr context.parameters.[dataset_property_name].filtering

Typ: SortStatus[]

Methods

Metoda Description Dostępne dla
addColumn Dodaje kolumnę do zestawu kolumn. Aplikacje oparte na modelu
clearSelectedRecordIds Czyści zaznaczoną listę identyfikatorów rekordów. Aplikacje oparte na modelu i kanwy
delete Usuń rekordy ze źródła danych. Aplikacje kanwy
getCommands Polecenia dla zestawu danych. Aplikacje kanwy
getDataSetCapabilities Możliwości zestawu danych. Aplikacje kanwy
getSelectedRecordIds Pobiera wszystkie wybrane identyfikatory rekordów. Aplikacje oparte na modelu i kanwy
getTargetEntityType Zwraca nazwę typu tabeli docelowej. Aplikacje oparte na modelu i kanwy
getTitle Pobiera nazwę wyświetlaną widoku używaną przez właściwość zestawu danych. Aplikacje oparte na modelu i kanwy
getViewId Zwraca identyfikator widoku używanego przez parametr zestawu danych. Aplikacje oparte na modelu i kanwy
newRecord Zainicjuj obiekt rekordu lokalnego dla kontrolki, aby ustawić wartość. Kontrolka musi wywołać metodę save() na nowo utworzonym rekordzie, aby utrwała zmianę. Aplikacje kanwy
openDatasetItem Otwórz element zestawu danych dla danej jednostkiReference. Sprawdza, czy istnieje polecenie z identyfikatorem Mscrm.OpenRecordItemprzycisku polecenia . Jeśli istnieje, wykonuje polecenie, w przeciwnym razie po prostu przechodzi do skojarzonej formy EntityReference. Aplikacje oparte na modelu i kanwy
odświeżyć Odświeża zestaw danych na podstawie filtrów, sortowania, łączenia, nowej kolumny. Ponadto odświeżanie spowoduje zresetowanie stronicowania do strony 1. Aplikacje oparte na modelu i kanwy
retrieveRecordCommand Pobieranie skojarzonych poleceń rekordu. Jeśli w manifeście istnieje wiele zestawów danych, funkcja retrieveRecordCommand zwraca polecenia dla pierwszego zestawu danych. Oparta na modelu
setSelectedRecordIds Ustaw identyfikatory wybranych rekordów. Aplikacje oparte na modelu i kanwy

Kolumny odnośników

Kolumny odnośników tabeli Dataverse można teraz pobrać. W przypadku aplikacji kanwy, jeśli kolumna odnośnika jest uwzględniona w zestawie danych, pobierane są wszystkie kolumny w rekordzie. GetFormattedValue Zwraca ciąg JSON dla tej kolumny. GetValue metoda zwraca bezpośrednio obiekt JSON.

Example

Aby dowiedzieć się więcej na temat implementowania metod zestawu danych, zobacz Składnik usługi DataSet Grid

Dokumentacja interfejsu API platformy składników usługi Power Apps
Omówienie struktury składników usługi Power Apps

  • Last updated on