Freigeben über


Vordefinierte Abfragen abrufen und ausführen

Microsoft Dataverse bietet Administratoren eine Möglichkeit, Systemansichten zu erstellen, die für alle Benutzer verfügbar sind. Einzelne Benutzer können die erweiterten Suchanfragen speichern und in der Anwendung wiederverwenden. Beide stellen vordefinierte Abfragen dar die Sie mit der Web-API abrufen und ausführen können.

Hinweis

Im Gegensatz zu Abfragen, die die OData-Syntax verwenden, werden Daten, die von vordefinierten Abfragen oder fetchXml zurückgegeben werden, keine Eigenschaften mit null-Werten zurückgeben. Wenn der Wert null ist, wird die Eigenschaft nicht in den Ergebnissen enthalten sein.

Wenn eine Abfrage mit OData-Syntax zurückgegeben wird, enthält ein Datensatz eine Eigenschaft mit einem null-Wert wie folgt:

{
    "@odata.etag": "W/\"46849433\"",
    "name": "Contoso, Ltd. (sample)",
    "accountnumber": null,
    "accountid": "7a4814f9-b0b8-ea11-a812-000d3a122b89"
}

Beim Abrufen mit einer vordefinierten Abfrage oder mit FetchXml enthält derselbe Datensatz die Eigenschaft accountnumber nicht, da sie den Wert null hat, wie hier:

{
    "@odata.etag": "W/\"46849433\"",
    "name": "Contoso, Ltd. (sample)",
    "accountid": "7a4814f9-b0b8-ea11-a812-000d3a122b89"
}

Vordefinierte Abfragen

Dataverse erlaubt Ihnen, zwei Arten von Abfragen zu definieren, zu speichern und durchzuführen, wie hier aufgelistet.

Abfragetyp Beschreibung
Gespeicherte Abfrage Systemdefinierte Ansichten für eine Tabelle (Entität). Diese Ansichten werden in savedquery EntityType gespeichert. Mehr Informationen finden Sie unter Anpassen von Tabellenansichten
Benutzerabfrage Erweiterte Suche sucht von Benutzern gespeicherte Daten für eine Tabelle (Entität). Diese Ansichten werden in userquery EntityType gespeichert. Weitere Informationen: UserQuery-Tabelle (gespeicherte Ansicht)

Datensätze für beide Entitätstypen enthalten die FetchXML Definition der zurückzugebenden Daten. Sie können den jeweiligen Entitätstyp abfragen, um den Wert des Primärschlüssels abzurufen. Mit dem Primärschlüsselwert können Sie die Abfrage durchführen, indem Sie den Primärschlüsselwert übergeben. Um beispielsweise die gespeicherte Abfrage Aktive Firmen auszuführen, müssen Sie erst den Primärschlüssel mit einer Abfrage wie dieser abrufen.

GET [Organization URI]/api/data/v9.2/savedqueries?$select=name,savedqueryid&$filter=name eq 'Active Accounts'

Sie können dann den savedqueryid-Wert verwenden und als Wert an den savedQuery-Parameter an den Firmen-Entitätssatz übergeben.

GET [Organization URI]/api/data/v9.2/accounts?savedQuery=00000000-0000-0000-00aa-000010001002

Verwenden Sie den gleichen Ansatz, um die userqueryid zu erhalten und sie als Wert an den userQuery-Parameter an den Entity-Satz zu übergeben, der mit der entsprechenden returnedtypecode der gespeicherten Abfrage übereinstimmt.

GET [Organization URI]/api/data/v9.2/accounts?userQuery=121c6fd8-1975-e511-80d4-00155d2a68d1

Anwenden einer Abfrage auf eine Sammlung des entsprechenden Typs

Neben dem einfachen Anwenden der gespeicherten Abfrage auf die hauptsächliche Entitätssatz-Sammlung können Sie auch eine gespeicherte Abfrage oder gespeicherte Benutzerabfrage nutzen, um dieselbe Filterung auf eine Sammlung des entsprechenden Typs der Entitäten anzuwenden. Wenn Sie beispielsweise eine Abfrage auf die Entitäten anwenden möchten, die mit einer bestimmten Entität zusammenhängen, können Sie dasselbe Muster anwenden. Zum Beispiel wendet die folgende URL die Abfrage Offene Verkaufschancen auf die Verkaufschancen an, die mit einem bestimmen Konto über eine als Sammlung bewertete Navigationseigenschaft von opportunity_parent_account zusammenhängen.

GET [Organization URI]/api/data/v9.2/accounts(8f390c24-9c72-e511-80d4-00155d2a68d1)/opportunity_parent_account/?savedQuery=00000000-0000-0000-00aa-000010003001

Siehe auch

Web API-Abfragedatenbeispiel (C#)
Web API-Abfragedatenbeispiele (clientseitiges JavaScript)
Vorgänge mithilfe der Web-API ausführen
HTTP-Anforderungen verfassen und Fehler beheben
Abfragen von Daten mithilfe der Web-API
Erstellen einer Tabellenzeile über die Web-API
Abrufen einer Tabellenzeile über die Web-API
Aktualisieren und Löschen von Tabellenzeilen über die Web-API
Zuordnen und Aufheben der Zuordnung von Tabellenzeilen über die Web-API
Nutzen von Web-API-Funktionen
Web-API-Aktionen verwenden
Ausführen von Batchbetrieben mithilfe der Web-API
Annehmen eines anderen Benutzerkontos mit Web API
Bedingte Vorgänge mithilfe der Web-API ausführen

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).