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