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

AssignRequest

<entity>.OwnerId*

SetStateRequest

<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.

SetParentSystemUserRequest

SystemUser.ParentSystemUserId

SetParentTeamRequest

Team.BusinessUnitId

SetParentBusinessUnitRequest

BusinessUnit.ParentBusinessUnitId

SetBusinessEquipmentRequest

Equipment.BusinessUnitId

SetBusinessSystemUserRequest

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