Tilknytte og fjerne tilknytningen af objekter ved hjælp af web-API'et
Udgivet: januar 2017
Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Der er flere metoder, du kan bruge til at tilknytte og fjerne tilknytningen af objekter. Hvilken metode du anvender, afhænger af, om du opretter eller opdaterer objekterne, og om du opererer inden for rammerne af det refererede objekt eller det objekt, der refererer.
Dette emne indeholder
Føj en reference til en navigationsegenskab med gruppeværdi
Fjern en reference til et objekt
Skift referencen i navigationsegenskab med enkeltværdi
Tilknyt objekter ved oprettelse
Tilknyt objekter ved opdatering
Føj en reference til en navigationsegenskab med gruppeværdi
Følgende eksempel viser, hvordan du knytter en eksisterende salgsmulighed enhed med opportunityid-værdien 00000000-0000-0000-0000-000000000001 til opportunity_customer_accounts-navigationsegenskaben med gruppeværdi for et kontoobjekt med accountid-værdien 00000000-0000-0000-0000-000000000002. Dette er en 1:N-relation, men du kan udføre den samme handling for en N:N -relation.
Anmodning
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)" }
Svar
HTTP/1.1 204 No Content OData-Version: 4.0
Fjern en reference til et objekt
Brug en DELETE-anmodning til at fjerne en reference til et objekt. Den måde, du gør det på, er forskellig, afhængigt af om du refererer til en navigationsegenskab med gruppeværdi eller en navigationsegenskab med enkeltværdi.
Anmodning
Brug følgende til navigationsegenskab med gruppeværdi.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
Eller brug denne.
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
Anmodning
Fjern $id-forespørgselsstrengparameteren for en navigationsegenskab med enkeltværdi.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
Svar
I begge tilfælde har et vellykket svar statussen 204.HTTP/1.1 204 No Content OData-Version: 4.0
Skift referencen i navigationsegenskab med enkeltværdi
Du kan tilknytte objektiver ved at angive værdien for en navigationsegenskab med enkeltværdi ved hjælp af PUT-anmodning med følgende mønster.
Anmodning
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)" }
Svar
HTTP/1.1 204 No Content OData-Version: 4.0
Tilknyt objekter ved oprettelse
Som beskrevet i Oprette relaterede objekter på én gang kan nye objekter oprettes med relationer ved hjælp af dyb indsætning.
Tilknyt objekter ved opdatering
Du kan knytte objekter ved opdatering ved hjælp af den samme meddelelse, der er beskrevet i Grundlæggende opdatering , men du skal bruge @odata.bind-anmærkningen til at angive værdien for navigationsegenskab med en enkeltværdi. Følgende eksempel ændrer den konto, der er knyttet til en salgsmulighed, ved hjælp af den customerid_account-navigationsegenskaben med enkeltværdi.
Anmodning
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)" }
Svar
HTTP/1.1 204 No Content OData-Version: 4.0
Se også
Eksempel på Web API Basic-operationer (C#)
Eksempel på Web API Basic operationer (JavaScript på klientsiden)
Udføre operationer ved hjælp af web-API
Skrive HTTP-anmodninger og håndtere fejl
Forespørg på data ved hjælp af Web-API'en
Oprette et objekt ved hjælp af Web-API
Hente et objekt ved hjælp af web-API'et
Opdatere og slette objekter ved hjælp af web-API'et
Bruge Web-API-funktioner
Brug Web API-handlinger
Udføre batchhandlinger ved hjælp af Web-API
Efterligne en anden bruger ved hjælp af Web-API'en
Udfør betingede operationer ved hjælp af web-API
Microsoft Dynamics 365
© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret