Eseguire operazioni specializzate utilizzando l'aggiornamento
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Prima di Aggiornamento 1 di Microsoft Dynamics CRM Online 2015, erano richiesti dei messaggi specializzati per aggiornare determinati valori di attributi di entità. Ora si può utilizzare UpdateRequest 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.
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 il Servizio organizzazione e la codifica degli strumenti standard di integrazione dati utilizzati con Dynamics 365. 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 il Servizio organizzazione 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, vedere Utilizzare l'API Web di Microsoft Dynamics 365.
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
Automatizzare i processi aziendali utilizzando il processo Dynamics 365
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright