Lire en anglais

Partager via

Microsoft DataverseContrôle de versions API Web

  • Article

À compter de la version v9.0 de Dynamics 365, l’API Web prend en charge les différences spécifiques aux versions dans le même environnement.

Cela diffère du comportement des versions v8.x. Dans les versions antérieures, les nouvelles fonctionnalités étaient disponibles à n’importe quelle version du service en fonction de la mise à jour appliquée à l’environnement. Après une mise à niveau à la version v8.2, les services v8.0 et v8.1 restaient identiques. C’était possible car toutes les modifications étaient additives. Rien n’était supprimé ni n’introduisait de modification de rupture. Par conséquent, la version spécifique référencée dans l’URL du service pour la version v8.x n’avait pas vraiment d’importance.

À présent, les fonctionnalités du service peuvent évoluer, en incluant notamment des modifications révolutionnaires telles que la suppression d’opérations spécifiques. Cela permettra d’appliquer des améliorations de manière continue. Cette rubrique répertorie toutes les différences spécifiques aux versions et toutes les limitations lorsque l’API web n’a pas encore atteint la parité avec le SDK pour .NET.

Notes

Bien que les versions v9.x puissent prendre en charge des différences spécifiques, aucune modification majeure n’a été ajoutée aux versions v9.0, v9.1 ou v9.2. Chacune de ces versions a des comportements d’API Web identiques.

Les différences de comportement des API sont davantage dues aux solutions installées dans le système plutôt qu’à la version du produit. Cependant, si nous devons apporter un changement fondamental qui n’est pas rétrocompatible, il sera inclus dans un nouveau numéro de version.

Conseils : utilisez le numéro de version qui était en cours lorsque votre code a été écrit. N’utilisez pas automatiquement une version plus récente sans rechercher les différences documentées ici et tester. Ne présumez pas qu’une version plus récente sera entièrement rétrocompatible.

Différences spécifiques aux versions de l’API web

Les différences ci-dessous concernent les modifications apportées aux versions v8.2 et v9.0 de l’API Web.

Encodage des caractères spéciaux dans FetchXML réponse à la requête

Pour les versions v8.x, la réponse des FetchXML requêtes contenant des entités de lien et leurs attributs contient des caractères spéciaux Unicode tels que ’.’ devient ’x002e’ et ’@’ devient ’x0040’. Cet encodage des caractères spéciaux n’est pas présent en réponse aux FetchXML requêtes pour la version v9.x .

Même nom pour la table et la colonne

Si le nom d’une table (entité) et celui d’une de ses colonnes (attributs) est identique, alors « 1 » est ajouté au nom de l’attribut dans les instances de v8.x. Par exemple, si une entité new_zipcode contient un attribut avec un nom comme new_zipcode, le nom de l’attribut passe à new_zipcode1.

Pour les instances de v9.x, aucun élément n’est ajouté au nom de l’attribut.

Nouvelle opération ajoutée

Les opérations suivantes ont été ajoutées à l’API Web pour la version v9.x.

Operations Opérations (suite) Opérations (suite)
GrantAccessRequest ModifyAccessRequest RetrieveSharedPrincipalsAndAccessRequest

Limitations relatives aux API web

L’API Web Dataverse assure une parité complète avec les fonctionnalités du SDK pour .NET. Pour Dataverse, cette rubrique décrit les limitations héritées de la version Dataverse v8.x. Pour les versions antérieures, voir Limitations de l’API web Dynamics CRM 2016.

Notes

Si vous avez défini une action personnalisée qui contenait une valeur renvoyée complexe et une valeur renvoyée simple, aucune action correspondante n’était disponible dans l’API Web mais était disponible en utilisant le service de l’organisation. Une valeur renvoyée complexe est une EntityReference, une Entity, ou une EntityCollection. Vous pouvez avoir une combinaison des valeurs de retour simples ou d’une valeur de retour complexe unique. Pour plus d’informations, voir : Créer vos propres actions.

Voir aussi

Utilisation de l’API web Dataverse
Authentification Dataverse avec l’API Web
Types d’API Web et opérations
Effectuer des opérations à l’aide de l’API web

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).