Associa e annulla associazione entità con l'API Web
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Esistono diversi metodi che puoi utilizzare per associare e annullare l'associazione delle entità. Il metodo applicato dipende da se stai creando o aggiornando le entità e se lavori nel contesto dell'entità di riferimento o a cui si fa riferimento.
In questo argomento
Aggiungi un riferimento a una proprietà di navigazione con i valori della raccolta
Rimuovi un riferimento a un'entità
Modifica il riferimento in una proprietà di navigazione a valore singolo
Associare le entità in fase di creazione
Associa le entità in fase di aggiornamento
Aggiungi un riferimento a una proprietà di navigazione con i valori della raccolta
Nell'esempio seguente viene illustrato come associare un'entità di opportunità esistente con il valore opportunityid di 00000000-0000-0000-0000-000000000001 alla proprietà di navigazione opportunity_customer_accounts con i valori della raccolta per un'entità di account con il valore accountid di 00000000-0000-0000-0000-000000000002. È una relazione 1:N ma puoi eseguire la stessa procedura per una relazione N:N.
Richiesta
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)" }
Risposta
HTTP/1.1 204 No Content OData-Version: 4.0
Rimuovi un riferimento a un'entità
Utilizza una richiesta DELETE per rimuovere un riferimento a un'entità. Il modo per farlo è diverso a seconda se si sta facendo riferimento a una proprietà di navigazione con i valori della raccolta o una proprietà di navigazione a valore singolo.
Richiesta
Per una proprietà di navigazione con i valori della raccolta, utilizza le opzioni seguenti.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
In alternativa, utilizzare quanto segue.
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
Richiesta
Per una proprietà di navigazione a valore singolo, rimuovi il parametro di stringa della query $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
Risposta
In qualsiasi modo, una corretta risposta ha uno stato 204.HTTP/1.1 204 No Content OData-Version: 4.0
Modifica il riferimento in una proprietà di navigazione a valore singolo
Puoi associare le entità impostando il valore di una proprietà di navigazione a valore singolo utilizzando la richiesta PUT con il seguente modello.
Richiesta
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)" }
Risposta
HTTP/1.1 204 No Content OData-Version: 4.0
Associare le entità in fase di creazione
Come descritto in Creare entità correlate con un'unica operazione, le nuove entità possono essere create con le relazioni utilizzando deep insert.
Associa le entità in fase di aggiornamento
Puoi associare le entità al momento dell'aggiornamento utilizzando lo stesso messaggio descritto nell'annotazione Aggiornamento di base ma devi utilizzare l'annotazione @odata.bind per impostare il valore di una proprietà di navigazione a valore singolo. Il seguente esempio modifica l'account associato a un'opportunità utilizzando la proprietà di navigazione a valore singolo customerid_account.
Richiesta
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)" }
Risposta
HTTP/1.1 204 No Content OData-Version: 4.0
Vedere anche
Esempio di operazioni di base dell'API Web (C#)
Esempio di operazioni di base API Web (JavaScript lato client)
Eseguire operazioni tramite l'API Web
Comporre richieste HTTP e gestire gli errori
Query di dati tramite l'API Web
Creare un'entità utilizzando l'API Web
Recupera un'entità utilizzando l'API Web
Aggiorna ed elimina le entità con l'API Web
Utilizzare le funzioni API Web
Utilizzare le azioni API Web
Eseguire operazioni in batch usando l'API Web
Rappresentare un altro utente usando l'API Web
Eseguire operazioni condizionali tramite l'API Web
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright