Associer et dissocier les entités à l'aide de l'API Web

Article
10/31/2017

Date de publication : janvier 2017

S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Il existe plusieurs méthodes que vous pouvez utiliser pour associer ou dissocier des entités. La méthode que vous appliquez dépend si vous créez ou mettez les entités à jour et si vous travaillez dans le contexte de l'entité référencée ou de l'entité de référencement.

Contenu de la rubrique

Ajouter une référence à une propriété de navigation avec une valeur de collection

Supprimer une référence à une entité

Modifier la référence dans une propriété de navigation à valeur unique

Associer des entités lors de la création

Associer des entités lors de la mise à jour

Cet exemple explique comment associer une entité d'opportunité existante avec la valeur opportunityid 00000000-0000-0000-0000-000000000001 avec la propriété de navigation avec une valeur de collection opportunity_customer_accounts pour une entité de compte avec la valeur accountid 00000000-0000-0000-0000-000000000002. Il s'agit d'une relation 1 à N mais vous pouvez effectuer la même opération pour une relation N à N.

Demande

POST cc_WebAPI_ServiceURI/accounts(00000000-0000-0000-0000-000000000002)/opportunity_customer_accounts/$ref HTTP/1.1 
Content-Type: application/json 
Accept: application/json 
OData-MaxVersion: 4.0 
OData-Version: 4.0

{
"@odata.id":"cc_WebAPI_ServiceURI/opportunities(00000000-0000-0000-0000-000000000001)"
}

Réponse

HTTP/1.1 204 No Content
OData-Version: 4.0

Supprimer une référence à une entité

Utilisez une demande DELETE pour supprimer une référence à une entité. La manière de procéder est différente selon que vous faites référence à une propriété de navigation avec une valeur de collection ou une propriété de navigation à valeur unique.

Demande
Pour une propriété de navigation avec une valeur de collection, utilisez le suivant.

DELETE cc_WebAPI_ServiceURI/accounts(00000000-0000-0000-0000-000000000002)/opportunity_customer_accounts/$ref?$id=cc_WebAPI_ServiceURI/opportunities(00000000-0000-0000-0000-000000000001) HTTP/1.1
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

Ou, utilisez ceci.

DELETE cc_WebAPI_ServiceURI/accounts(00000000-0000-0000-0000-000000000002)/opportunity_customer_accounts(00000000-0000-0000-0000-000000000001)/$ref HTTP/1.1
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

Demande
Pour une propriété de navigation à valeur unique, supprimez le paramètre de chaîne de requête $id.

DELETE cc_WebAPI_ServiceURI/opportunities(00000000-0000-0000-0000-000000000001)/customerid_account/$ref HTTP/1.1
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

Réponse
Quelle que soit la méthode utilisée, la réponse de réussite a le statut 204.
```
HTTP/1.1 204 No Content
OData-Version: 4.0
```

Vous pouvez associer des entités en définissant la valeur d'une propriété de navigation à valeur unique à l'aide de la demande PUT avec le modèle suivant.

Demande

PUT cc_WebAPI_ServiceURI/opportunities(00000000-0000-0000-0000-000000000001)/customerid_account/$ref HTTP/1.1
Content-Type: application/json
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

{
 "@odata.id":"cc_WebAPI_ServiceURI/accounts(00000000-0000-0000-0000-000000000002)"
}

Réponse

HTTP/1.1 204 No Content
OData-Version: 4.0

Associer des entités lors de la création

Comme décrit dans Créer des entités associées en une opération, des entités peuvent être créées avec les relations avec deep insert.

Associer des entités lors de la mise à jour

Vous pouvez associer des entités lors de la mise à jour avec le message décrit dans Mise à jour de base, mais vous devez utiliser l'annotation @odata.bind pour définir la valeur d'une propriété de navigation à valeur unique. L'exemple suivant modifie le compte associé à une opportunité à l'aide de la propriété de navigation à valeur unique customerid_account.

Demande

PATCH cc_WebAPI_ServiceURI/opportunities(00000000-0000-0000-0000-000000000001) HTTP/1.1
Content-Type: application/json
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0

{
 "customerid_account@odata.bind":"cc_WebAPI_ServiceURI/accounts(00000000-0000-0000-0000-000000000002)"
}

Réponse

HTTP/1.1 204 No Content
OData-Version: 4.0

Voir aussi

Microsoft Dynamics 365

Partager via

Associer et dissocier les entités à l'aide de l'API Web

Contenu de la rubrique

Ajouter une référence à une propriété de navigation avec une valeur de collection

Supprimer une référence à une entité

Modifier la référence dans une propriété de navigation à valeur unique

Associer des entités lors de la création

Associer des entités lors de la mise à jour

Voir aussi

Ressources supplémentaires