Extraire et exécuter des requêtes prédéfinies

Microsoft Dataverse permet aux administrateurs de créer des vues système disponibles pour tous les utilisateurs. Les utilisateurs individuels peuvent enregistrer les requêtes De recherche avancée pour une réutilisation dans l’application. Ces deux requêtes représentent des requêtes prédéfinies que vous pouvez récupérer et exécuter à l’aide de l’API web.

Note

Contrairement aux requêtes utilisant la syntaxe OData, les données retournées par des requêtes prédéfinies ou fetchXml ne contiendront pas de propriétés avec des valeurs null. Lorsque la valeur est null, la propriété ne sera pas incluse dans les résultats.

Lorsqu’une requête est retournée à l’aide de la syntaxe OData, un enregistrement inclut une propriété avec une null valeur comme suit :

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

Lors de la récupération à l’aide d’une requête prédéfinie ou avec FetchXml, le même enregistrement n’inclut pas la accountnumber propriété, car il s’agit null, comme suit :

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

Requêtes prédéfinies

Dataverse vous permet de définir, d’enregistrer et d’exécuter deux types de requêtes, comme indiqué ici.

Type de requête	Descriptif
Requête enregistrée	Vues définies par le système pour une table (entité). Ces vues sont stockées dans l’EntityType savedquery. Plus d’informations : Personnaliser les vues de table
Requête utilisateur	Recherches avancées enregistrées par les utilisateurs pour une table (entité). Ces vues sont stockées dans l’EntityType userquery. Plus d'informations : Table UserQuery (vue sauvegardée)

Les enregistrements de ces deux types d’entités contiennent la définition FetchXML pour les données à retourner. Vous pouvez interroger le type d’entité respectif pour récupérer la valeur de clé primaire. Avec la valeur de clé primaire, vous pouvez exécuter la requête en passant la valeur de clé primaire. Par exemple, pour exécuter la requête enregistrée comptes actifs, vous devez d’abord obtenir la clé primaire en utilisant une requête telle que celle-ci.

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

Vous pouvez ensuite utiliser la valeur savedqueryid et la transmettre comme valeur au paramètre savedQuery à l'ensemble d’entités de comptes.

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

Utilisez la même approche pour obtenir le userqueryid et transmettez-le comme valeur du paramètre userQuery à l’ensemble d’entités qui correspond au returnedtypecode de la requête enregistrée.

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

Appliquer une requête à n’importe quelle collection du type approprié

En plus d’appliquer simplement la requête enregistrée à la collection d’ensembles d’entités principale, vous pouvez également utiliser une requête enregistrée ou une requête utilisateur pour appliquer le même filtrage sur n’importe quelle collection du type d’entités approprié. Par exemple, si vous souhaitez appliquer une requête uniquement aux entités associées à une entité spécifique, vous pouvez appliquer le même modèle. Par exemple, l’URL suivante applique la requête Open Opportunities aux opportunités associées à un compte spécifique via la opportunity_parent_account propriété de navigation à valeur de collection.

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

Voir aussi

Rétroaction

Cette page vous a-t-elle été utile ?

Last updated on 2025-10-22