Delen via


Entiteiten koppelen en ontkoppelen met de web-API

 

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Er zijn verschillende methoden waarmee u entiteiten kunt koppelen en ontkoppelen. Welke methode u toepast is afhankelijk van of u de entiteiten maakt of bijwerkt, en of u werkt in de context van de entiteit waarnaar wordt verwezen of van de verwijzende entiteit.

In dit onderwerp

Een verwijzing toevoegen naar een collection-valued navigatie-eigenschap

Een verwijzing naar een entiteit verwijderen

De verwijzing in een single-valued navigatie-eigenschap wijzigen

Entiteiten koppelen bij het maken

Entiteiten koppelen bij bijwerken

Een verwijzing toevoegen naar een collection-valued navigatie-eigenschap

In dit voorbeeld ziet u hoe u een bestaande verkoopkansentiteit met een opportunityid-waarde van 00000000-0000-0000-0000-000000000001 koppelt aan de collection-valued navigatie-eigenschap opportunity_customer_accounts voor een accountentiteit met de accountid-waarde 00000000-0000-0000-0000-000000000002. Dit is 1:N-relatie, maar u kunt dezelfde bewerkingen uitvoeren voor een N:N-relatie.

  • Aanvraag

    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)"
    }
    
  • Respons

    HTTP/1.1 204 No Content
    OData-Version: 4.0
    

Een verwijzing naar een entiteit verwijderen

Gebruik een DELETE-aanvraag om een verwijzing naar een entiteit te verwijderen. Hoe u dit doet kan verschillen, afhankelijk van of u verwijst naar een collection-valued navigatie-eigenschap of een single-valued navigatie-eigenschap.

  • Aanvraag
    Voor een collection-valued navigatie-eigenschap gebruikt u de volgende opties.

    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
    

    Of u gebruikt dit.

    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
    
  • Aanvraag
    Voor een single-valued navigatie-eigenschap verwijdert u de querytekenreeksparameter $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
    
  • Respons
    In beide gevallen heeft een geslaagde respons de status 204.

    HTTP/1.1 204 No Content
    OData-Version: 4.0
    

De verwijzing in een single-valued navigatie-eigenschap wijzigen

U kunt entiteiten koppelen door de waarde van een single-valued navigatie-eigenschap in te stellen door middel van PUT-aanvragen met het onderstaande patroon.

  • Aanvraag

    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)"
    }
    
  • Respons

    HTTP/1.1 204 No Content
    OData-Version: 4.0
    

Entiteiten koppelen bij het maken

Zoals beschreven in In één bewerking gerelateerde entiteiten maken, kunnen nieuwe entiteiten worden gemaakt met relaties door middel van diep invoegen.

Entiteiten koppelen bij bijwerken

U kunt entiteiten tijdens het bijwerken koppelen door middel van hetzelfde bericht dat is beschreven in Basisbijwerkbewerking, maar u moet de @odata.bind-notatie gebruiken om de waarde van een single-valued navigatie-eigenschap in te stellen. In het volgende voorbeeld wordt de account die aan een verkoopkans is gekoppeld, gewijzigd door middel van de single-valued navigatie-eigenschap customerid_account.

  • Aanvraag

    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)"
    }
    
  • Respons

    HTTP/1.1 204 No Content
    OData-Version: 4.0
    

Zie ook

Voorbeeld van eenvoudige Web API-bewerkingen (C#)
Voorbeeld basisbewerkingen web-API (JavaScript op client)
Bewerkingen uitvoeren met de web-API
HTTP-aanvragen opstellen en fouten afhandelen
Querygegevens met behulp van de web-API
Een entiteit maken met de web-API
Een entiteit ophalen met de web-API
Entiteiten bijwerken en verwijderen met de Web-API
Web-API-functies gebruiken
Web-API-acties gebruiken
Batchbewerkingen uitvoeren met de Web API
Zich als een andere gebruiker voordoen die de Web API gebruikt
Voorwaardelijke bewerkingen uitvoer met de web-API

Microsoft Dynamics 365

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht