Freigeben über

Entitäten zuordnen und Zuordnungen aufheben mithilfe der Web API

  • Artikel

 

Veröffentlicht: Januar 2017

Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Es gibt einige Methoden, die Sie anwenden können, um Entitäten zuzuordnen und solche Zuordnungen wieder aufzuheben. Welche Methode Sie anwenden, hängt davon ab, ob Sie die Entitäten erstellen oder aktualisieren, und davon, ob Sie im Kontext der referenzierten oder der referenzierenden Entität arbeiten.

In diesem Thema

Fügen Sie eine Referenz auf eine sammlungswertige Navigationseigenschaft hinzu

Entfernen Sie eine Referenz auf eine Entität

Ändern Sie die Referenz in einer einzelwertigen Navigationseigenschaft

Entitäten bei Erstellung zuordnen

Entitäten beim Update zuordnen

Fügen Sie eine Referenz auf eine sammlungswertige Navigationseigenschaft hinzu

Das folgende Beispiel zeigt, wie man eine vorhandene Verkaufschancenentität mit dem Wert opportunityid von 00000000-0000-0000-0000-000000000001 zur sammlungwertigen Navigationseigenschaft opportunity_customer_accounts für eine Firmenentität mit dem Wert accountid von 00000000-0000-0000-0000-000000000002 verbindet. Dieses ist eine 1:n-Beziehung, aber Sie können die gleiche Operation für eine N:N-Beziehung durchführen.

  • Anforderung

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

  • Antwort

    HTTP/1.1 204 No Content
OData-Version: 4.0

Entfernen Sie eine Referenz auf eine Entität

Nutzen Sie eine DELETE-Anfrage, um eine Referenz auf eine Entität zu entfernen. Die Weise, wie Sie dies tun, ist unterschiedlich, abhängig davon, ob Sie sich auf eine sammlungswertige Navigationseigenschaft oder auf eine einzelwertige Navigationseigenschaft beziehen.

  • Anforderung
    Für eine sammlungswertige Navigationseigenschaft verwenden Sie das Folgende.

    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

    Oder, verwenden Sie dieses.

    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

  • Anforderung
    Für eine einzelwertige Navigationseigenschaft entfernen Sie den $id Querystring-Parameter.

    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

  • Antwort
    Eine erfolgreiche Antwort hat auf jeden Fall Status 204.

    HTTP/1.1 204 No Content
OData-Version: 4.0

Ändern Sie die Referenz in einer einzelwertigen Navigationseigenschaft

Sie können Entitäten zuweisen, indem Sie den Wert einer einzelwertigen Navigationseigenschaft unter Verwendung einer PUT-Anfrage mit dem folgenden Muster einstellen.

  • Anforderung

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

  • Antwort

    HTTP/1.1 204 No Content
OData-Version: 4.0

Entitäten bei Erstellung zuordnen

Wie beschrieben in Erstellen verknüpfter Entitäten in einem Vorgang, können neue Entitäten mit Verhältnissen unter Verwendung des tiefen Einfügens hergestellt werden.

Entitäten beim Update zuordnen

Sie können Entitäten beim Update unter Verwendung der gleichen Message verbinden, die in Grundlegende Aktualisierung beschrieben wird, aber Sie müssen die Anmerkung @odata.bind verwenden, um den Wert einer einzelwertigen Navigationseigenschaft einzustellen. Das folgende Beispiel ändert die Firma, die mit einer Verkaufschance verknüpft ist, unter Verwendung der einzelwertigen customerid_account Navigationseigenschaft.

  • Anforderung

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

  • Antwort

    HTTP/1.1 204 No Content
OData-Version: 4.0

Siehe auch

Beispiel grundlegender Web-API-Operationen (C#)
Beispiele grundlegender Web API-Operationen (clientseitiges JavaScript)
Vorgänge mithilfe der Web-API ausführen
HTTP-Anforderungen verfassen und Fehler beheben
Datenabfrage mit Web-API
Erstellen einer Entität mithilfe des Web-API
Abrufen einer Entität mithilfe des Web-API
Entitäten aktualisieren und löschen mithilfe der Web API
Nutzen von Web-API-Funktionen
Nutzen von Web-API-Aktionen
Ausführen von Batchbetrieben mithilfe der Web-API
Annehmen eines anderen Benutzerkontos mit Web API
Bedingte Vorgänge mithilfe der Web-API ausführen

Microsoft Dynamics 365

© 2017 Microsoft. Alle Rechte vorbehalten. Copyright