Vordefinierte Abfragen abrufen und ausführen

Microsoft Dataverse bietet Administratoren eine Möglichkeit, Systemansichten zu erstellen, die allen Benutzern zur Verfügung stehen. Einzelne Benutzer können die Erweiterten Suchabfragen für die erneute Verwendung in der Anwendung speichern. Beide stellen vordefinierte Abfragen dar, die Sie mithilfe der Web-API abrufen und ausführen können.

Hinweis

Im Gegensatz zu Abfragen, die die OData-Syntax verwenden, geben daten, die von vordefinierten Abfragen oder fetchXml zurückgegeben werden, keine Eigenschaften mit null Werten zurück. Wenn der Wert ist null, wird die Eigenschaft nicht in die Ergebnisse einbezogen.

Wenn eine Abfrage mithilfe der 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"
}

Wenn sie mithilfe einer vordefinierten Abfrage oder mit FetchXml abgerufen werden, enthält derselbe Datensatz die accountnumber Eigenschaft nicht, da er wie folgt lautet null:

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

Vordefinierte Abfragen

Dataverse ermöglicht es Ihnen, zwei Arten von Abfragen zu definieren, zu speichern und auszuführen, wie hier aufgeführt.

Abfragetyp	Description
Gespeicherte Abfrage	Systemdefinierte Ansichten für eine Tabelle (Entität). Diese Ansichten werden im savedquery EntityType gespeichert. Weitere Informationen: Anpassen von Tabellenansichten
Benutzerabfrage	Erweiterte Suchvorgänge, die von Benutzern für eine Tabelle (Entität) gespeichert wurden. Diese Ansichten werden im Userquery EntityType gespeichert. Weitere Informationen: UserQuery -Tabelle (gespeicherte Ansicht)

Datensätze für beide Typen von Entitäten enthalten die FetchXML-Definition für die zurückzugebenden Daten. Sie können den jeweiligen Entitätstyp abfragen, um den Primärschlüsselwert abzurufen. Mit dem Primärschlüsselwert können Sie die Abfrage ausführen, indem Sie den Primärschlüsselwert übergeben. Um beispielsweise die gespeicherte Abfrage " Aktive Konten " auszuführen, müssen Sie zuerst den Primärschlüssel mithilfe 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 denselben Ansatz, um userqueryid abzurufen, und übergeben Sie den Wert als userQuery-Parameter an den Entitätssatz, der mit dem 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 beliebige Auflistung des entsprechenden Typs

Zusätzlich zum einfach Anwenden der gespeicherten Abfrage auf die Hauptentitätssatzsammlung können Sie auch eine gespeicherte Abfrage oder Benutzerabfrage verwenden, um dieselbe Filterung auf jede Sammlung des entsprechenden Entitätstyps anzuwenden. Wenn Sie beispielsweise eine Abfrage nur für die Entitäten anwenden möchten, die sich auf eine bestimmte Entität beziehen, 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-Abfragedatenbeispiel (clientseitiges JavaScript)
Ausführen von Vorgängen mithilfe der Web-API
HTTP-Anforderungen verfassen und Fehler beheben
Datenabfrage mit Web-API
Erstellen einer Tabellenzeile mithilfe der Web-API
Abrufen einer Tabellenzeile über die Web-API
Tabellenzeilen über die Web-API aktualisieren und löschen
Zuordnen und Aufheben der Zuordnung von Tabellenzeilen über die Web-API
Web-API-Funktionen verwenden
Nutzen von Web-API-Aktionen
Ausführen von Batchvorgängen mithilfe der Web-API
Annehmen eines anderen Benutzerkontos mit der Web-API
Bedingte Vorgänge mithilfe der Web-API ausführen