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
Ähnliche Artikel
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).