Teilen über


DataSet

Stellt Eigenschaften und Methoden zum Verwenden von Daten in Rastern und Ansichten bereit.

Verfügbar für

modellgesteuerte und Canvas-Apps.

Eigenschaften

Spalten

Der Satz von Spalten, die in diesem Dataset verfügbar sind. Sowohl für modellgesteuerte Apps als auch für Canvas-Apps unterstützt.

Typ: Spalte[]

error

Ob ein Fehler im Datenabruf aufgetreten ist. Sowohl für modellgesteuerte Apps als auch für Canvas-Apps unterstützt.

Typ: boolean

errorCode

Die Fehlercode im Zusammenhang mit dem letzten aufgetretenen Fehler, sofern anwendbar.

errorMessage

Die Fehlermeldung im Zusammenhang mit dem letzten aufgetretenen Fehler, sofern anwendbar.

Typ: number | string

filtering

Die Spaltenfilterung für die aktuelle Abfrage. Sowohl für modellgesteuerte Apps als auch für Canvas-Apps unterstützt. Die Filterung kann für ein DataSet konfiguriert werden, indem Sie context.parameters.[dataset_property_name].filtering.setFilter(<filterExpression>) festlegen. Sobald der Filter festgelegt ist, werden durch Aufrufen von context.parameters.[dataset_property_name].refresh() die gefilterten Daten aus der Datenquelle abgerufen.

Wert Bedingter Operator Modellgesteuerte Apps Canvas-Apps
-1 Kein Wert Ja Ja
0 Gleich Ja Ja
1 NotEqual Ja Ja
2 GreaterThan Ja Ja
3 KleinerAls Ja Ja
4 GreaterEqual Ja Ja
5 LessEqual Ja Ja
6 Wie Ja Ja
7 Gefällt mir nicht Nein Ja
8 In Ja Ja
12 Null Ja Ja
13 NotNull Nein Ja
14 Gestern Ja Nein
15 Heute Ja Nein
16 Morgen Ja Nein
17 Last7Days Ja Nein
18 Next7Days Ja Nein
19 LastWeek Ja Nein
20 ThisWeek Ja Nein
22 LastMonth Ja Nein
23 ThisMonth Ja Nein
25 am Ja Nein
26 OnOrBefore Ja Nein
27 OnOrAfter Ja Nein
28 LastYear Ja Nein
29 ThisYear Ja Nein
33 LastXDays Ja Nein
34 NextXDays Ja Nein
37 LastXMonths Ja Nein
38 NextXMonths Ja Nein
49 Enthält Ja Ja
54 BeginWith Nein Ja
55 DoesNotBeginWidth Nein Ja
56 EndsWidth Nein Ja
57 DesNotEndWith Nein Ja
70 InFiscalPeriodAndYear Ja Nein
75 Oberhalb Ja Ja
76 Unter Ja Ja
77 Nicht unter Ja Ja
78 AboveOrEqual Ja Ja
79 UnderOrEqual Ja Ja
87 ContainValues Ja Ja
88 DoesNotContainValues Nein Ja

Hinweis

Die Filterfunktion ist nur für die Dataverse-Datenquelle verfügbar.

Typ: Filtering

linking

Definiert Informationen zu verknüpften Tabelle. Nur in modellgesteuerten Apps unterstützt.

Typ: Linking

Wird geladen

Gibt an, ob das Dataset geladen wird oder nicht. Sowohl für modellgesteuerte Apps als auch für Canvas-Apps unterstützt.

Typ: boolean

paging

Status vom Blättern und von Aktionen. Sowohl für modellgesteuerte Apps als auch für Canvas-Apps unterstützt. Auf Paging-Informationen kann zugegriffen werden und sie können für ein DataSet mithilfe von context.parameters.[dataset_property_name].paging konfiguriert werden.

Hinweis

Die Dataverse-Datenquelle gibt die totalRecordCount im Paging-Objekt für Canvas-Apps nicht zurück. Stattdessen verwendet sie hasNextPage und hasPreviousPage, um zu prüfen, ob weitere Datensätze abgerufen werden müssen.

DataSet-Komponenten können context.parameters.[dataset_property_name].paging.setPageSize(pageSize) verwenden, um die Anzahl der pro Seite abgerufenen Datensätze zu ändern.

Typ: Paging

Einträge

Zuordnen der IDs zum gesamten Datensatzobjekt Sowohl für modellgesteuerte Apps als auch für Canvas-Apps unterstützt.

Typ: EntityRecord

sortedRecordIds

Kennungen der Datensätze im Dataset in Reihenfolge des Ergebnisses der Abfrageantwort. Sowohl für modellgesteuerte Apps als auch für Canvas-Apps unterstützt.

Typ: string[]

sorting

Die Sortierungsstatus für die aktuelle Abfrage. Sowohl für modellgesteuerte Apps als auch für Canvas-Apps unterstützt. Die Sortierung kann für ein DataSet konfiguriert werden, indem Sie context.parameters.[dataset_property_name].sorting = [SortStatus] festlegen. Sobald der Sortierung konfiguriert ist, werden durch Aufrufen von context.parameters.[dataset_property_name].refresh() die sortierten Daten aus der Datenquelle abgerufen.

Hinweis

Die Sortierfunktion ist nur für die Dataverse-Datenquelle verfügbar. Wenn die Sortierung außerdem neu konfiguriert wird, wird der Filter context.parameters.[dataset_property_name].filtering zurückgesetzt

Typ : SortStatus[]

Methoden

Methode Beschreibung des Dataflows Verfügbar für
addColumn Fügt dem Spaltensatz eine Spalte hinzu. Modellbasierte Apps
clearSelectedRecordIds Löscht die Liste der ausgewählten Datensatz-IDs. Modellgesteuerte und Canvas-Apps
Löschen Löschen die Datensätze aus einer Datenquelle. Canvas-Apps
getCommands Die Befehle für das DataSet. Canvas-Apps
getDataSetCapabilities Die Fähigkeiten für das DataSet. Canvas-Apps
getSelectedRecordIds Ruft alle ausgewählten Datensatz-IDs ab. Modellgesteuerte und Canvas-Apps
getTargetEntityType Gibt den Namen des Zieltabellentyps zurück. Modellgesteuerte und Canvas-Apps
getTitle Ruft den Anzeigenamen der Ansicht ab, der von der DataSet-Eigenschaft verwendet wird. Modellgesteuerte und Canvas-Apps
getViewId Gibt die ID der Ansicht zurück, die vom DataSet-Parameter verwendet wird. Modellgesteuerte und Canvas-Apps
newRecord Initialisieren Sie ein lokales Datensatzobjekt für das Steuerelement, um den Wert festzulegen. Das Steuerelement muss die save() -Methode für den neu erstellten Datensatz aufrufen, um die Änderung beizubehalten. Canvas-Apps
openDatasetItem Öffnen Sie das DataSet-Element für eine bestimmte EntityReference. Es wird überprüft, ob es einen Befehl mit der Befehlsschaltflächen-ID Mscrm.OpenRecordItem gibt. Wenn vorhanden, wird der Befehl ausgeführt; andernfalls wird nur wird nur zum zugeordneten Formular von EntityReference navigiert. Modellgesteuerte und Canvas-Apps
refresh Aktualisiert das DataSet basierend auf Filtern, Sortierung, Verknüpfungen, neuer Spalte. Außerdem setzt die Aktualisierung die Paging-Funktion auf Seite 1 zurück. Modellgesteuerte und Canvas-Apps
retrieveRecordCommand Rufen Sie die zugehörigen Befehle des Datensatzes ab. Wenn das Manifest mehrere Datasets enthält, gibt retrieveRecordCommand die Befehle für das erste DataSet zurück. Modellgesteuert
setSelectedRecordIds Legen Sie die IDs der ausgewählten Datensätze fest. Modellgesteuerte und Canvas-Apps

Nachschlagespalten

Die Nachschlagespalten Dataverse-Tabelle können jetzt abgerufen werden. Wenn bei Canvas-Apps eine Nachschlagespalte im DataSet enthalten ist, werden alle Spalten im referenzierten Datensatz abgerufen. GetFormattedValue gibt die JSON-Zeichenfolge für diese Spalte zurück. Die Methode GetValue gibt das JSON-Objekt direkt zurück.

Beispiel

Weitere Informationen zum Implementieren der dataset-Methoden finden Sie unter DataSet-Gitterkomponente

Power Apps Component Framework-API-Referenz
Power Apps Component Framework Übersicht

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).