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 | Nr. | Ja |
Anmerkung
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.
Anmerkung
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.
Anmerkung
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 | Eigenschaft | 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
Ähnliche Artikel
Power Apps Component Framework-API-Referenz
Power Apps component framework Übersicht