Creare annotazione per un'entità di contatto in Microsoft Dynamics CRM tramite API

Question

Questa domanda è correlata a Microsoft Dynamics CRM 2015, che sto chiamando tramite API.

creo un'entità contatto:

POST [organization URI]/api/data/contacts 
Content-Type: application/json; charset=utf-8 
Accept: application/json 
{ 
    "emailaddress1": "myemail@example.com", 
} 

Funziona, vedo nuovo record, dopo annoto nel pannello. E posso chiamarlo attraverso l'API:

[organization URI]/api/data/contacts(f76e4e7c-ea61-e511-80fd-3863bb342b00) 
{ 
    "@odata.context":"[organization URI]/api/data/$metadata#contacts/$entity", 
    "@odata.etag":"W/\"460199\"", 
    ... 
    "contactid":"f76e4e7c-ea61-e511-80fd-3863bb342b00", 
    "emailaddress1":"myemail@example.com", 
    .... 
} 

La prossima cosa che voglio fare, è quello di aggiungere record di annotazione associato con quel contatto. A seguito della guide io chiamo:

POST [organization URI]/api/data/annotations 
Content-Type: application/json; charset=utf-8 
Accept: application/json 
{ 
    "notetext": "TEST", 
    'contact@odata.bind': 'contacts(f76e4e7c-ea61-e511-80fd-3863bb342b00)' 
} 

ma restituisce 400 errore:

An undeclared property 'contact' which only has property annotations in the payload but no property value was found in the payload. In OData, only declared navigation properties and declared named streams can be represented as properties without values.

Quando chiamo: si crea

POST [organization URI]/api/data/annotations 
Content-Type: application/json; charset=utf-8 
Accept: application/json 
{ 
    "notetext": "TEST", 
} 

nuova entità, ma senza una relazione da contattare.

Come comporre correttamente questa richiesta POST? Cosa mi manca qui? Sospetto che il contact@odata.bind debba essere presentato in qualche modo diverso, ho provato contactid@odata.bind, object@odata.bind, objectid@odata.bind - ma nessun effetto.

Qualche idea?

Answer 1

ho trovato questo lavoro, ma in due richieste: la risposta è preso

annotation_id_from_first_request valore modulo prima di richiesta:

POST [organization URI]/api/data/annotations 
Content-Type: application/json; charset=utf-8 
Accept: application/json 
{ 
    "notetext": "TEST" 
} 

POST [organization URI]/api/data/contacts(f76e4e7c-ea61-e511-80fd-3863bb342b00)/Contact_Annotation/$ref 
Content-Type: application/json; charset=utf-8 
Accept: application/json 
{ 
    "@odata.id": "[organization URI]/annotations(annotation_id_from_first_request)" 
} 

Modifica.

Answer 2

Invece di utilizzare objectid@odata.bind, è necessario utilizzare objectid_contact@odata.bind. Questi risultati sono in:

"objectid_contact@odata.bind": "/contacts(f76e4e7c-ea61-e511-80fd-3863bb342b00)" 

per ottenere l'elenco delle proprietà, guardate sotto le proprietà a valore singolo di navigazione nel documentation.

Answer 3

Sto usando questo codice C# per la creazione e il collegamento (la roba Task.Await non è molto intelligente, quindi ... attenzione):

 dynamic testAno = new ExpandoObject(); 
     testAno.NoteText = "Hello World!"; 
     testAno.Subject = "Note Subject"; 

     dynamic refAccount = new ExpandoObject(); 
     refAccount.LogicalName = "account"; 
     refAccount.Id = "003CCFC2-4012-DE11-9654-001F2964595C"; 

     testAno.ObjectId = refAccount; 
     testAno.ObjectTypeCode = refAccount.LogicalName; 

     var demo = JsonConvert.SerializeObject(testAno); 

     HttpContent content = new StringContent(demo, Encoding.UTF8, "application/json"); 

     var handler = new HttpClientHandler { UseDefaultCredentials = true }; 

     HttpClient client = new HttpClient(handler); 
     var test = client.PostAsync(new Uri("http://crm/.../XRMServices/2011/OrganizationData.svc/AnnotationSet"), content).Result; 

Il JSON è simile a questo:

{"NoteText":"Hello World!", 
"Subject":"Note Subject", 
"ObjectId": {"LogicalName":"account", 
       "Id":"003CCFC2-4012-DE11-9654-001F2964595C"} 
,"ObjectTypeCode":"account"} 

Answer 4

Questa risposta vale per il web l'utilizzo dell'API:

Se la proprietà riferimenti è stato definito usando le lettere maiuscole, è necessario utilizzare le lettere maiuscole nella proprietà aggiornata e inserire. Guarda il nome dello schema nell'elenco delle proprietà dell'entità primaria.

Diciamo che avere un'entità chiamata myprefix_entity con un riferimento all'entità conto, e si chiamarono Account, e il nome dello schema è diventato myprefix_AccountId, si dovrebbe fare riferimento come:

"myprefix_AccountId@odata.bind":"/accounts(f76e4e7c-ea61-e511-80fd-000000000000)" 

Il maiuscolo A e il maiuscolo I in myprefix_AccountId sono importanti, se è così che è stato definito il nome dello schema.

Answer 5

Parte 1:
MSDN Riferimento: Deep Insert

You can create entities related to each other by defining them as navigation properties values. This is known as deep insert. As with a basic create, the response OData-EntityId header contains the Uri of the created entity. The URIs for the related entities created aren’t returned.

Di seguito il codice è quello di creare account (1), creare + associato contatto principale (2), creare & Opportunità Associate (3) e creare + associato Task (4)

POST [Organization URI]/api/data/v8.2/accounts HTTP/1.1 
Content-Type: application/json; charset=utf-8 
OData-MaxVersion: 4.0 
OData-Version: 4.0 
Accept: application/json 

{ 
"name": "Sample Account", 
"primarycontactid": 
{ 
    "firstname": "John", 
    "lastname": "Smith" 
}, 
"opportunity_customer_accounts": 
[ 
    { 
     "name": "Opportunity associated to Sample Account", 
     "Opportunity_Tasks": 
     [ 
     { "subject": "Task associated to opportunity" } 
     ] 
    } 
] 
} 

Parte 2:
L'associazione dell'annotazione al contatto utilizza la seguente sintassi.

note["objectid_contact@odata.bind"] = "/contacts(C5DDA727-B375-E611-80C8-00155D00083F)"; 

consultare SO link & blog

Parte 3:
risposta al tuo commento su un'altra risposta su annotation_id_from_first_request:

per vedere la scheda creata Id in risposta da parte dell'ultima richiesta, è possibile analizzare come di seguito:

   //get Response from Created Record 
       entityIdWithLink = XMLHttpRequest.getResponseHeader("OData-EntityId"); 

       //get EntityId from ResponseHeader of Created Record 
       getEntityId = entityIdWithLink.split(/[()]/); 
       getEntityId = getEntityId[1]; 

Puoi read more

You can compose your POST request so that data from the created record will be returned with a status of 201 (Created).
To get this result, you must use the return=representation preference in the request headers. To control which properties are returned, append the $select query option to the URL to the entity set.
The $expand query option will be ignored if used. When an entity is created in this way the OData-EntityId header containing the URI to the created record is not returned

Note: This capability was added with December 2016 update for Dynamics 365

MSDN Riferimento: Create with data returned