使用 Update 執行特製化作業
發行︰ 2017年1月
適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online
在 Microsoft Dynamics CRM Online 2015 更新 1 以前，必須有特製化訊息才能更新某些實體屬性值。 現在，UpdateRequest 可用來設定這些屬性。 下表列出已取代的特製化訊息要求以及可使用 UpdateRequest 更新的相關訊息屬性。
已取代的訊息要求 |
更新的屬性 |
|---|---|
<entity>.OwnerId* |
|
<entity>.StateCode* 重要 對於 SLA 和 RoutingRule 實體，不支援在單一 Update 訊息引動模式中變更 OwnerId 和 StateCode，這會導致例外。 |
|
SystemUser.ParentSystemUserId |
|
Team.BusinessUnitId |
|
BusinessUnit.ParentBusinessUnitId |
|
Equipment.BusinessUnitId |
|
SystemUser.BusinessUnitId |
*<entity> 參照提供此屬性的任何實體。
這些特製化的訊息將繼續用於 2011 端點。 不過，建議盡可能使用 UpdateRequest 或 Update 方法來設定這些屬性。Update 訊息簡化組織服務，更輕鬆編碼標準資料整合工具用於 Dynamics 365。 此外，為單一 Update 訊息執行 (而不是多個特製化的訊息) 編碼及登錄外掛程式也會比較容易。 上列屬性的 AttributeMetadata.IsValidForUpdate 屬性在此版本已變更為 true，以啟用此功能。
您可以繼續在您的程式碼使用 2011 端點的這些特製化的訊息。 不過，最後取代組織服務的 Web API 只支援這些作業類型的 Update 訊息。 若要開始變更程式碼以配合 Web API，現在可以這麼做。 如需詳細資訊，請參閱使用 Microsoft Dynamics 365 Web API。
此變更對外掛程式的影響
當處理的更新要求包括負責人欄位和商務擁有的實體的其他標準欄位時，註冊 Update 訊息的外掛程式會在準銷售案源階段 20 和/或階段 40 對所有非負責人欄位執行一次，然後對負責人欄位執行一次。 負責人欄位的範例是 businessunit 和 manager (用於 SystemUser 實體)。 商務擁有的實體範例包括 SystemUser、BusinessUnit、Equipment 和 Team。
當處理的更新要求包括狀態/狀態 (State/Status) 欄位和其他標準欄位時，註冊 Update 訊息的外掛程式會在準銷售案源階段 20 和/或階段 40 對所有非狀態/狀態 (State/Status) 欄位執行一次，然後對狀態/狀態 (State/Status) 欄位執行一次。
為了讓外掛程式碼收到更新的完整資料變更，您必須在階段 10 註冊外掛程式，然後在外掛程式碼的內容中儲存相關資訊於 SharedVariables 以供稍後外掛程式 (在準銷售案源) 使用。
此變更對工作流程的影響
當處理的更新要求包括負責人欄位和其他標準欄位時，註冊 Update 訊息的工作流程會對所有非負責人欄位執行一次，然後對負責人欄位執行一次。 由使用者註冊 Assign 訊息的工作流程繼續由負責人欄位更新觸發。
當處理的更新要求包括狀態/狀態 (State/Status) 欄位和其他標準欄位時，註冊 Update 訊息的工作流程會對所有非狀態/狀態 (State/Status) 欄位執行一次，然後對狀態/狀態 (State/Status) 欄位執行一次。 註冊 [變更狀態] 步驟的工作流程繼續由狀態/狀態 (State/Status) 欄位更新觸發。
另請參閱
撰寫可擴充商務程序的外掛程式
使用 Dynamics 365 程序自動化商務程序
Microsoft Dynamics 365
© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權