Del via

Tilknytte og fjerne tilknytningen af objekter ved hjælp af web-API'et

  • Artikel

 

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