共用方式為

視覺效果 (圖表) 的動作

  • 發行項

 

發行︰ 2017年1月

適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

使用 Microsoft Dynamics 365 SDK，您可以在視覺效果實體上執行下列動作。

組織擁有的視覺效果上的動作

若要在組織擁有的視覺效果 (SavedQueryVisualization) 上執行動作，您必須有系統管理員或系統自訂員角色。 您可以在組織擁有的視覺效果上執行下列動作：

  • 建立、擷取、更新和刪除組織擁有的視覺效果。其他資訊：建立視覺效果 (圖表)

    注意

    在您更新組織擁有的視覺效果之後，必須發行中繼資料變更，讓整個組織都能使用 PublishAllXmlRequest 訊息看見視覺效果。 或者，當您發行實體，附加至實體的所有未發行的組織擁有的視覺效果會自動發行。

  • 使用 SavedQueryVisualization.PrimaryEntityTypeCode 屬性，查詢及擷取附加至實體的所有組織擁有的視覺效果。 多個組織擁有的視覺效果可以附加至單一實體。 如需可以附加視覺效果的實體清單，請參閱 視覺效果支援的實體。 如需程式碼範例，示範如何擷取附加至實體的所有組織擁有視覺效果，請參閱 範例：擷取附加至實體的所有圖表。

    注意

    在建立視覺效果之後，您無法變更或更新視覺效果將它附加至不同的實體。 這意謂著 SavedQueryVisualization.PrimaryEntityTypeCode 屬性針對組織擁有的視覺效果的更新動作無效。

  • 透過將 SavedQueryVisualization.IsDefault 屬性設定為 true，指定組織擁有的視覺效果為相關實體的預設視覺效果。 當您設定組織擁有的視覺效果為實體的預設視覺效果，當您在 Microsoft Dynamics 365 選取檢視此實體的視覺效果時，此視覺效果根據預設會顯示。

    注意

    使用 Microsoft Dynamics 365 SDK，如果您針對已經設定其他視覺效果實體做為預設的實體設定組織的視覺效果為預設，兩個視覺效果標示為實體的預設視覺效果。 若要設定視覺效果為實體的預設視覺效果，請確定其他視覺效果未設定為實體的預設視覺效果。

如需組織擁有的視覺效果實體上支援的訊息清單，請參閱SavedQueryVisualization (系統圖表) 實體訊息和方法。

使用者擁有的視覺效果上的動作

您可以在使用者擁有的視覺效果 (UserQueryVisualization) 上執行下列動作：

  • 建立、擷取、更新和刪除使用者擁有的視覺效果。其他資訊：建立視覺效果 (圖表)

  • 使用 UserQueryVisualization.PrimaryEntityTypeCode 屬性，查詢及擷取附加至實體的所有使用者擁有的視覺效果。 多個使用者擁有的視覺效果可以附加至一個實體。 如需可以附加視覺效果的實體清單，請參閱 視覺效果支援的實體。

    注意

    在建立視覺效果之後，您無法變更或更新視覺效果將它附加至不同的實體。 這意謂著 UserQueryVisualization.PrimaryEntityTypeCode 屬性針對使用者擁有的視覺效果的更新動作無效。

  • 使用 AssignRequest 將使用者擁有的視覺效果指派給另一位使用者或另一個團隊，就可以變更該視覺效果的擁有權。

  • 使用 RetrievePrincipalAccessRequest 擷取特定安全性主體 (使用者或團隊) 對使用者擁有之視覺效果的存取權限。 您也可以使用 RetrieveSharedPrincipalsAndAccessRequest 訊息同時擷取對使用者擁有之視覺效果具有存取權限的所有安全性主體 (使用者或團隊)，與他們對使用者擁有之視覺效果的存取權限。

  • 使用 GrantAccessRequest、ModifyAccessRequest 和 RevokeAccessRequest，就可以透過於特定區域上共用使用者擁有之視覺效果的方式與其他使用者和團隊共同作業。

如需使用者擁有的視覺效果實體上支援的訊息清單，請參閱UserQueryVisualization (使用者圖表) 實體訊息和方法。

另請參閱

檢視具有視覺效果 (圖表) 的資料
了解圖表：基礎資料以及表示圖表
建立視覺效果 (圖表)
範例圖表
範例：建立、擷取、更新和刪除圖表
範例：擷取附加至實體的所有圖表
範例：指派圖表給另一位使用者
SavedQueryVisualization (系統圖表) 實體訊息和方法
UserQueryVisualization (使用者圖表) 實體訊息和方法

Microsoft Dynamics 365

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權