Limitations relatives aux API Web Microsoft Dynamics 365
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
L'API Web Microsoft Dynamics 365 assurera une parité complète avec les fonctionnalités du service de l'organisation. Pour Microsoft Dynamics 365 (Online et local), cette rubrique décrit certaines restrictions.
Contenu de la rubrique
Limitations dans Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local)
Limitations résolues dans Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local)
Limitations résolues dans Mise à jour 1 de Microsoft Dynamics CRM Online 2016 et Microsoft Dynamics CRM 2016 Service Pack 1
Limitations résolues dans Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM 2016
Limitations dans Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local)
Cette section fournit des informations sur les limitations dans Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local).
Certaines actions personnalisées non disponibles dans l'API Web
Fonctionnalités et actions manquantes pour certains messages de service de l'organisation
Certaines actions personnalisées non disponibles dans l'API Web
Si vous définissez une action personnalisée contenant une valeur renvoyée complexe et une valeur renvoyée simple, aucune action correspondante n'est disponible dans l'API Web mais sera disponible en utilisant le point de terminaison SOAP 2011. 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 :Créer vos propres actions
Fonctionnalités et actions manquantes pour certains messages de service de l'organisation
Le tableau suivant répertorie les messages qui n'ont pas de fonctionnalité ou d'action correspondante lorsque Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local) sont appliqués.
Pour obtenir la liste des fonctionnalités et actions manquantes de la version initiale, combinez cette liste à la liste sous Nouvelles fonctionnalités et actions dans Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM 2016 et Nouvelles fonctionnalités et actions dans Mise à jour 1 de Microsoft Dynamics CRM Online 2016 et Microsoft Dynamics CRM 2016 Service Pack 1.
Limitations résolues dans Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local)
Cette section fournit des informations sur les limitations traitées dans Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local).
API Web non activée pour Microsoft Dynamics 365 pour Outlook avec accès hors connexion lorsque l'utilisateur est hors connexion
Impossible d'interroger les valeurs de date
Lorsque vous appelez des actions avec les paramètres de collection d'entités ainsi que d'autres paramètres, un paramètre de collection doit être transmis comme dernier paramètre dans le corps
Impossible de créer un attribut de recherche client
Impossible de récupérer des métadonnées non publiées
Nouvelle opération ajoutée
Les opérations suivantes ont été ajoutées à l'API Web pour Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local).
API Web non activée pour Microsoft Dynamics 365 pour Outlook avec accès hors connexion lorsque l'utilisateur est hors connexion
Notes
Ce problème est résolu dans Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local).
Le code JavaScript s'exécutant dans des scripts de formulaire, les commandes du ruban, ou les ressources Web HTML ne peuvent pas utiliser l'API Web. C'est désormais activé sur le serveur local utilisé lorsque l'utilisateur est hors connexion.
Impossible d'interroger les valeurs de date
Ce problème n'était pas réellement une question de limitation, mais un problème de syntaxe. N'utilisez pas de guillemets simples lors de la spécification d'une date comme valeur pour un filtre.
Lorsque vous interrogez une propriété de date, telle que la date de naissance d'un contact, la syntaxe de requête suivante fonctionne :
/contacts?$select=fullname,birthdate&$filter=birthdate eq 1990-01-01
La syntaxe suivante ne fonctionnera pas :
/contacts?$select=fullname,birthdate&$filter=birthdate eq '1990-01-01'
Lorsque vous appelez des actions avec les paramètres de collection d'entités ainsi que d'autres paramètres, un paramètre de collection doit être transmis comme dernier paramètre dans le corps
Notes
Ce problème est résolu dans Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local).
Les actions suivantes contiennent un paramètre de collection d'entités, outre d'autres paramètres.
Avant Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local), lorsque vous utilisiez ces actions, le paramètre qui incluait la collection d'entités devait être transmis comme dernier paramètres dans JSON ou le système renvoyait une erreur. Par exemple, vous recevrez un message d'erreur lorsque vous utilisez QualifyMemberList Action et transmettez les valeurs de paramètre de la façon suivante.
{
"ListMember": [
{
"@odata.type": "Microsoft.Dynamics.CRM.account",
"accountid": "483F8080-6976-E511-9172-0024E8436263"
},
{
"@odata.type": "Microsoft.Dynamics.CRM.account",
"accountid": "4D3F8080-6976-E511-9172-0024E8436263"
}
],
"OverrideorRemove": true
}
Mais les étapes suivantes devraient réussir.
{
"OverrideorRemove": true,
"ListMember": [
{
"@odata.type": "Microsoft.Dynamics.CRM.account",
"accountid": "483F8080-6976-E511-9172-0024E8436263"
},
{
"@odata.type": "Microsoft.Dynamics.CRM.account",
"accountid": "4D3F8080-6976-E511-9172-0024E8436263"
}
]
}
Impossible de créer un attribut de recherche client
Notes
Ce problème est résolu dans Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local).
La création d'attribut de recherche client à l'aide de l'API Web n'est pas prise en charge dans Mise à jour 1 de Microsoft Dynamics CRM Online 2016 et Microsoft Dynamics CRM 2016 Service Pack 1.
Pour créer un attribut de recherche client avec l'API Web à l'aide de Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local), voir Créer un attribut de recherche client.
Impossible de récupérer des métadonnées non publiées
Notes
Ce problème est résolu dans Mise à jour de décembre 2016 pour Microsoft Dynamics 365 (en ligne) et Service Pack de décembre 2016 pour Microsoft Dynamics 365 (local).
Les messages de service de l'organisation qui récupèrent des métadonnées incluent un paramètre RetrieveAsIfPublished qui offre la possibilité de consulter les définitions des métadonnées qui n'ont pas encore été validées par la publication. Cette fonctionnalité est utile pour créer une application pour modifier des métadonnées et autoriser l'enregistrement de modifications non engagées. Dans Mise à jour 1 de Microsoft Dynamics CRM Online 2016 et Microsoft Dynamics CRM 2016 Service Pack 1, toutes les opérations de récupération sur les métadonnées renvoient uniquement les métadonnées publiées.Pour plus d'informations :Utiliser l'API Web avec les métadonnées Dynamics 365 et Publier les personnalisations.
Limitations résolues dans Mise à jour 1 de Microsoft Dynamics CRM Online 2016 et Microsoft Dynamics CRM 2016 Service Pack 1
Mise à jour 1 de Microsoft Dynamics CRM Online 2016 et Microsoft Dynamics CRM 2016 Service Pack 1 ont de nouvelles fonctionnalités et actions, et ont résolu les problèmes suivants avec l'API Web :
Nouvelles fonctionnalités et actions dans Mise à jour 1 de Microsoft Dynamics CRM Online 2016 et Microsoft Dynamics CRM 2016 Service Pack 1
Impossible de filtrer les requêtes selon la valeur d'une propriété de navigation à valeur unique
Nouvelles fonctionnalités et actions dans Mise à jour 1 de Microsoft Dynamics CRM Online 2016 et Microsoft Dynamics CRM 2016 Service Pack 1
Le tableau suivant répertorie les fonctionnalités et les actions ajoutées pour Mise à jour 1 de Microsoft Dynamics CRM Online 2016 et Microsoft Dynamics CRM 2016 Service Pack 1.
Impossible de filtrer les requêtes selon la valeur d'une propriété de navigation à valeur unique
Notes
Ce problème est partiellement résolu dans Mise à jour 1 de Microsoft Dynamics CRM Online 2016 et Microsoft Dynamics CRM 2016 Service Pack 1. Vous pouvez désormais filtrer des requêtes dans la propriété de navigation à valeur unique si la propriété de navigation fait référence à la valeur d'attribut principal de l'entité référencée.Pour plus d'informations :Filtrer les enregistrements en fonction de la propriété de navigation à valeur unique
Si vous utilisez la propriété d'une propriété de navigation à valeur unique comme filtre dans une requête, une erreur 501 s'affiche. Par exemple, les tentatives de requête suivantes pour retourner tous les comptes où la valeur de propriété firstname du contact principal associé est « Sylvie ».
Demande
GET [Organization URI]/api/data/v8.0/accounts?$select=name&$filter=primarycontactid/firstname eq 'Renee' HTTP/1.1 Accept: application/json OData-MaxVersion: 4.0 OData-Version: 4.0Réponse
HTTP/1.1 501 Not Implemented Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "error": { "code": "", "message": "The query node (0) is not supported", "innererror": { "message": "The query node (0) is not supported", "type": "Microsoft.Crm.CrmHttpException", "stacktrace": <stacktrace value removed for brevity> } } }
Limitations résolues dans Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM 2016
Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 ont de nouvelles fonctionnalités et actions, et ont résolu les problèmes suivants avec l'API Web.
Nouvelles fonctionnalités et actions dans Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM 2016
Erreur lors de l'interrogation des relations plusieurs-à-plusieurs auto-référentielles
$select sur certaines expressions $expand peut être ignoré
Les propriétés de navigation à valeur unique ne peuvent pas être retournées d'une requête $expand si elles ont une valeur nulle
Les requêtes FetchXML liées à activitypointer ne peuvent pas inclure les champs associés
Les propriétés à valeur null ne peuvent pas être retournées dans les résultats de propriété de navigation développés
Nouvelles fonctionnalités et actions dans Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM 2016
Le tableau suivant répertorie les fonctionnalités et les actions ajoutées pour Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM 2016.
Erreur lors de l'interrogation des relations plusieurs-à-plusieurs auto-référentielles
Notes
Ce problème est résolu dans Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM 2016.
Il existe deux entités système avec des relations plusieurs-à-plusieurs auto-référentielles : connectionrole EntityType a connectionroleassociation_association et campaign EntityType a campaigncampaign_association. Si vous tentez une requête qui utilise ces propriétés de navigation à valeur de collection, l'erreur suivante HTTP Status 400 est attendue : Reflexive relationship must specify direction using ReflexiveManyToManyRelationship.
Si vous devez interroger des données à l'aide de ces relations plusieurs-à-plusieurs, vous pouvez utiliser les entités avec intersection à la place. Pour la propriété de navigation à valeur de collection campaigncampaign_association, l'entité campaignitem EntityType est l'entité avec intersection spéciale qui définit la relation. Pour connectionroleassociation_association, connectionroleassociation correspond à l'entité avec intersection ordinaire contenant les données qui définissent ce relations plusieurs-à-plusieurs. les entités avec intersection ordinaires ne sont pas inclus dans la documentation de référence mais sont disponibles dans l'API Web. Vous pouvez accéder à l'entité connectionroleassociation à l'aide de cette URI : /api/data/v8.0/connectionroleassociations.Pour plus d'informations :Propriétés de navigation à valeur de collection
$select sur certaines expressions $expand peut être ignoré
Notes
Ce problème est résolu dans Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM 2016.
Lorsque vous récupérez deux propriétés de navigation, si la dernière propriété de navigation n'a pas l'option de requête $select, toutes les propriétés de la première propriété de navigation sont retournées. Par exemple, si vous créez la requête suivante :
GET
[Organization URI]/api/data/v8.0/accounts(0495779B-F67F-E511-80C2-00155DB09B03)$select=name&$expand=contact_customer_accounts($select=lastname),opportunity_customer_accounts
Vous attendez la propriété name du compte, le lastname des contacts associés à l'aide des contact_customer_accounts et toutes les propriétés des opportunités associées à l'aide des opportunity_customer_accounts.
Toutefois, vous recevrez toutes les propriétés pour les contacts ainsi que toutes les propriétés des opportunités associées. Il est recommandé de toujours utiliser $select pour limiter les propriétés dans les opérations de récupération, suivre cette meilleure pratique vous assurera ainsi de toujours obtenir les meilleures performances et de ne pas récupérer plus de données que nécessaire.
Les propriétés de navigation à valeur unique ne peuvent pas être retournées d'une requête $expand si elles ont une valeur nulle
Notes
Ce problème est résolu dans Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM 2016.
Selon la Spécification OData, lorsque vous développez une propriété de navigation unique et qu'elle ne contient aucune valeur, la propriété doit être incluse avec l'ensemble null. Le comportement actuel est que la propriété ne sera pas incluse dans la réponse JSON. Dans l'exemple suivant, la propriété de navigation à valeur unique primarycontactid du compte est requise, mais comme il n'y a aucun contact associé à cette propriété de navigation, la valeur est null.
Demande
GET [Organization URI]/api/data/v8.0/accounts(25DD0B31-ED8B-E511-80D2-00155D2A68D4)?$select=name&$expand=primarycontactid($select=fullname) HTTP/1.1 Accept: application/json Content-Type: application/json; charset=utf-8 OData-MaxVersion: 4.0 OData-Version: 4.0Réponse attendue
HTTP/1.1 200 OK OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name,primarycontactid,primarycontactid(fullname))/$entity", "@odata.etag": "W/\"504724\"", "name": "A. Datum Corporation (sample)", "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4", "primarycontactid": null }Réponse réelle
HTTP/1.1 200 OK OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name,primarycontactid,primarycontactid(fullname))/$entity", "@odata.etag": "W/\"504724\"", "name": "A. Datum Corporation (sample)", "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4" }
Les requêtes FetchXML liées à activitypointer ne peuvent pas inclure les champs associés
Notes
Ce problème est résolu dans Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM 2016.
Lorsque vous créez une requête avec FetchXML incluant activitypointer en tant qu'entité associée, les valeurs de propriété sont null. Par exemple, si vous utilisez la valeur fetchXML suivante :
<fetch version="1.0"
output-format="xml-platform"
mapping="logical"
distinct="true">
<entity name="account">
<attribute name="name" />
<link-entity name="activitypointer"
from="regardingobjectid"
to="accountid"
link-type="inner">
<attribute name="subject" />
</link-entity>
</entity>
</fetch>
Vous demandez l'activitypointer associé. Valeur subject à retourner. Elle est retournée avec une valeur null lorsqu'une valeur réelle existe.
Demande
GET [Organization URI]/api/data/v8.0/accounts?fetchXml=%3Cfetch%20version=%221.0%22%20output-format=%22xml-platform%22%20mapping=%22logical%22%20distinct=%22true%22%3E%3Centity%20name=%22account%22%3E%3Cattribute%20name=%22name%22%20/%3E%3Clink-entity%20name=%22activitypointer%22%20from=%22regardingobjectid%22%20to=%22accountid%22%20link-type=%22inner%22%3E%3Cattribute%20name=%22subject%22%20/%3E%3C/link-entity%3E%3C/entity%3E%3C/fetch%3E HTTP/1.1 Accept: application/json OData-MaxVersion: 4.0 OData-Version: 4.0Réponse attendue
HTTP/1.1 200 OK Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name)", "value": [ { "name": "A. Datum Corporation (sample)", "activitypointer1.subject": "Task Subject Value" } ] }Réponse réelle
HTTP/1.1 200 OK Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name)", "value": [ { "name": "A. Datum Corporation (sample)", "activitypointer1.subject": null } ] }
Pour plus d'informations :Utiliser la requête FetchXML personnalisée
Les propriétés à valeur null ne peuvent pas être retournées dans les résultats de propriété de navigation développés
Notes
Ce problème est résolu dans Mise à jour 0.1 de Microsoft Dynamics CRM Online 2016 et Mise à jour 0.1 de Microsoft Dynamics CRM 2016.
Lorsqu'une des propriétés développées dans une propriété de navigation à valeur de collection est null, la propriété développée ne sera pas incluse dans les résultats. Le premier exemple illustre les données lorsque l'un des contacts associés à un compte comporte une valeur null pour la propriété emailaddress1 développée. La propriété emailaddress1 n'est pas retournée même pour le contact qui a une valeur.
Demande
GET [Organization URI]/api/data/v8.0/accounts(25DD0B31-ED8B-E511-80D2-00155D2A68D4)?$select=name&$expand=contact_customer_accounts($select=emailaddress1,lastname,firstname) HTTP/1.1 Accept: application/json Content-Type: application/json; charset=utf-8 OData-MaxVersion: 4.0 OData-Version: 4.0Réponse attendue
HTTP/1.1 200 OK Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name,contact_customer_accounts,contact_customer_accounts(emailaddress1,lastname,firstname))/$entity", "@odata.etag": "W/\"504724\"", "name": "A. Datum Corporation (sample)", "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4", "contact_customer_accounts": [ { "@odata.etag": "W/\"504749\"", "emailaddress1": null, "lastname": "Valdes (sample)", "firstname": "Rene", "contactid": "8bdd0b31-ed8b-e511-80d2-00155d2a68d4" }, { "@odata.etag": "W/\"503647\"", "emailaddress1": someone_l@example.com, "lastname": "Burk (sample)", "firstname": "Susan", "contactid": "91dd0b31-ed8b-e511-80d2-00155d2a68d4" } ] }Réponse réelle
HTTP/1.1 200 OK Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#accounts(name,contact_customer_accounts,contact_customer_accounts(emailaddress1,lastname,firstname))/$entity", "@odata.etag": "W/\"504724\"", "name": "A. Datum Corporation (sample)", "accountid": "25dd0b31-ed8b-e511-80d2-00155d2a68d4", "contact_customer_accounts": [ { "@odata.etag": "W/\"504749\"", "lastname": "Valdes (sample)", "firstname": "Rene", "contactid": "8bdd0b31-ed8b-e511-80d2-00155d2a68d4" }, { "@odata.etag": "W/\"503647\"", "lastname": "Burk (sample)", "firstname": "Susan", "contactid": "91dd0b31-ed8b-e511-80d2-00155d2a68d4" } ] }
La requête suivante utilisant directement la propriété de navigation à valeur de collection contact_customer_accounts sans développement retourne les données attendues.
Demande
GET [Organization URI]/api/data/v8.0/accounts(25DD0B31-ED8B-E511-80D2-00155D2A68D4)/contact_customer_accounts?$select=emailaddress1,lastname,firstname HTTP/1.1 Accept: application/json Content-Type: application/json; charset=utf-8 OData-MaxVersion: 4.0 OData-Version: 4.0Réponse
HTTP/1.1 200 OK Content-Type: application/json; odata.metadata=minimal OData-Version: 4.0 { "@odata.context": " [Organization URI]/api/data/v8.0/$metadata#contacts(emailaddress1,lastname,firstname)", "value": [ { "@odata.etag": "W/\"504749\"", "emailaddress1": null, "lastname": "Valdes (sample)", "firstname": "Rene", "contactid": "8bdd0b31-ed8b-e511-80d2-00155d2a68d4" }, { "@odata.etag": "W/\"503647\"", "emailaddress1": "someone_l@example.com", "lastname": "Burk (sample)", "firstname": "Susan", "contactid": "91dd0b31-ed8b-e511-80d2-00155d2a68d4" } ] }
Voir aussi
Utilisez l'API Web Microsoft Dynamics 365
Authentification Microsoft Dynamics 365 avec l'API Web
Types d'API Web et opérations
Effectuer des opérations à l'aide de l'API Web
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright