Eseguire operazioni specializzate utilizzando l'aggiornamento
Data di pubblicazione: novembre 2016
Si applica a: Dynamics CRM 2015
Prima di questa versione, i messaggi specializzati dovevano aggiornare alcuni valori di attributi di entità. In questa versione, UpdateRequest può ora essere utilizzato per impostare questi attributi. Nella tabella vengono seguente sono indicate le richieste specializzate di messaggi deprecati e i relativi attributi di messaggio che possono essere aggiornati utilizzando UpdateRequest.
Richiesta di messaggio deprecato |
Attributo da aggiornare |
|---|---|
<entity>.OwnerId* |
|
<entity>.StateCode* Importante Per le entità Contratto di servizio e RoutingRule, la modifica di OwnerId e StateCode in un'unica chiamata di messaggio Update non è supportata e restituisce un'eccezione. |
|
SystemUser.ParentSystemUserId |
|
Team.BusinessUnitId |
|
BusinessUnit.ParentBusinessUnitId |
|
Equipment.BusinessUnitId |
|
SystemUser.BusinessUnitId |
*<entity> fa riferimento a ogni entità che fornisce questo attributo.
Nota
Per le organizzazioni di Microsoft Dynamics CRM Online, questa funzionalità è disponibile solo se nell'organizzazione è stato eseguito l'Aggiornamento 1 di Dynamics CRM Online 2015. Questa funzionalità non è disponibile per Dynamics CRM (locale).
Questi messaggi specializzati continueranno a utilizzare l'endpoint 2011. Tuttavia, si consiglia di utilizzare il metodo Update o UpdateRequest quando possibile per impostare questi attributi. Il messaggio Update semplifica l'API SDK e la codifica degli strumenti standard di integrazione dati utilizzati con Dynamics CRM. Inoltre, è più semplice codificare e registrare un plug-in da eseguire per un singolo messaggio Update anziché più messaggi specializzati. La proprietà AttributeMetadata.IsValidForUpdate per gli attributi elencati in precedenza è stata modificata in true in questa versione per abilitare la funzionalità.
Puoi continuare a utilizzare i messaggi specializzati dell'endpoint 2011 nel codice. Tuttavia, l'API Web che eventualmente sostituisce l'endpoint 2011 supporta solo il messaggio Update per questi tipi di operazioni. Se lo desideri, puoi a questo punto sperimentare la modifica del codice per allinearti all'API Web. Per ulteriori informazioni, vedi Anteprima dell'API Web.
Impatto di questa modifica sui plug-in
Quando le richieste di aggiornamento vengono elaborate in modo da includere i campi del proprietario e altri campi standard per le entità di proprietà aziendale, i plug-in registrati per il messaggio Update nella fase 20 e/o 40 della pipeline vengono eseguiti una volta per tutti i campi non del proprietario e una volta per i campi del proprietario. Esempi di campi del proprietario sono businessunit e manager, per un'entità SystemUser. Esempi di entità di proprietà aziendale sono SystemUser, BusinessUnit, Equipment e Team.
Quando le richieste di aggiornamento vengono elaborate in modo da includere i campi dello stato e altri campi standard, i plug-in registrati per il messaggio Update nella fase 20 e/o 40 della pipeline vengono eseguiti una volta per tutti i campi non di stato e una volta per i campi di stato.
Affinché il codice del plug-in riceva le modifiche complete dei dati dell'aggiornamento, devi registrare il plug-in nella fase 10 e quindi archiviare le informazioni rilevanti in SharedVariables nel contesto del plug-in per i successivi plug-in della pipeline da utilizzare.
Impatto di questa modifica sui flussi di lavoro
Quando le richieste di aggiornamento vengono elaborate in modo da includere i campi del proprietario e altri campi standard, i flussi di lavoro registrati per il messaggio Update vengono eseguiti una volta per tutti i campi non del proprietario e una volta per i campi del proprietario. I flussi di lavoro registrati per il messaggio Assign dagli utenti continuano ad essere attivati dagli aggiornamenti ai campi del proprietario.
Quando le richieste di aggiornamento vengono elaborate in modo da includere i campi dello stato e altri campi standard, i flussi di lavoro registrati per il messaggio Update vengono eseguiti una volta per tutti i campi non dello stato e una volta per i campi dello stato. I flussi di lavoro registrati per il passaggio Cambia stato continuano ad essere attivati dagli aggiornamenti ai campi di stato.
Vedere anche
Scrivere plug-in per estendere i processi aziendali
Scrivere i flussi di lavoro per automatizzare i processi aziendali.
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright