查詢和編輯組織佈景主題
發佈日期： 2016年11月
適用對象： Dynamics CRM 2015
在 Microsoft Dynamics CRM Online 2015 更新 1 中，您可以針對組織定義和套用視覺佈景主題。 這可提供支援的方式，將組織的標誌和色彩選擇套用至應用程式。 您可以對未經自訂的 CRM 系統所提供的預設色彩和視覺項目進行變更，以自訂應用程式的佈景主題。 例如，您可以建立個人產品品牌、新增公司標誌，以及提供實體特定著色。 佈景主題色彩會在整個應用程式中全域套用，但有些傳統區域除外。
重要
如果是 Microsoft Dynamics CRM Online 組織，只有在組織已更新至 Dynamics CRM Online 2015 更新 1 時，才能使用此功能。 這項功能不適用於 Dynamics CRM (內部部署)。
此版本中只支援 Web 應用程式的佈景主題自訂。 針對組織佈景主題所做的變更不會包含在從組織匯出的解決方案中。 您可以定義多個佈景主體，但只有一個佈景主題可以設定和發行為預設佈景主題。
影片：Microsoft Dynamics CRM 中的佈景主題設定
本主題內容
查詢目前佈景主題
編輯和發行佈景主題資料
匯出和匯入佈景主題
查詢目前佈景主題
您可能需要使用用戶端程式碼查詢目前的佈景主題，如果您的解決方案中包含 HTML Web 資源，而您想讓這些資源配合為組織選擇的佈景主題。 您可以使用下列查詢搭配 OData 端點擷取該資訊。
<client_URL>/xrmservices/2011/organizationdata.svc/ThemeSet?$select=ControlBorder,ControlShade,DefaultCustomEntityColor,Name,DefaultEntityColor,GlobalLinkColor,HeaderColor,HoverLinkEffect,NavBarBackgroundColor,LogoToolTip,NavBarShelfColor,ProcessControlColor,SelectedLinkEffect&$filter=IsDefaultTheme eq true
其他資訊：使用 OData 端點搭配 Web 資源。
編輯和發行佈景主題資料
佈景主題是利用 UI 中的自訂工具所建立，不需要開發人員撰寫程式碼。 有關如何套用這些自訂的詳細資料，可在 TechNet：變更色彩配置或新增標誌以符合組織的品牌中找到。
大部分佈景主題資料都儲存在 [佈景主題] 實體內。 特定實體的自訂色彩包含在 EntityMetadata.EntityColor 屬性中。 如果實體包含在解決方案中，則此資料會隨實體匯出。
下表說明可有效更新並且包含佈景主題所套用資料的 Theme 實體屬性：
結構描述名稱 |
類型 |
預設佈景主題的值 |
描述 |
|---|---|---|---|
ControlBorder |
字串 |
#CCCCCC |
控制項將用於框線的色彩。 |
ControlShade |
字串 |
#F3F1F1 |
當您暫留在項目上時控制項用來指示的色彩。 |
DefaultCustomEntityColor |
字串 |
#006551 |
預設自訂實體色彩 (如果未指派色彩)。 |
DefaultEntityColor |
字串 |
#8B98AB |
系統實體的預設色彩 (如果未指派色彩)。 |
GlobalLinkColor |
字串 |
#1160B7 |
連結 (例如電子郵件地址或查詢) 的色彩。 |
HeaderColor |
字串 |
#1160B7 |
標題文字 (例如表單索引標籤的標籤) 的色彩。 |
HoverLinkEffect |
字串 |
#D7EBF9 |
當您暫留在項目上時命令或清單將使用的色彩。 |
LogoId |
字串 |
null |
做為商標使用的 Web 資源名稱。 建議維度為高度 50 個像素和最大寛度 400 個像素。 |
LogoToolTip |
字串 |
Microsoft Dynamics CRM |
即將做為商標之工具提示和替代文字的文字。 |
Name |
字串 |
CRM 預設佈景主題 |
佈景主題實體的名稱。 |
NavBarBackgroundColor |
字串 |
#002050 |
主要導覽列色彩。 |
NavBarShelfColor |
字串 |
#DFE2E8 |
次要導覽列色彩。 |
ProcessControlColor |
字串 |
#0755BE |
處理控制項的主要色彩。 |
SelectedLinkEffect |
字串 |
#B1D6F0 |
命令或清單將用來指示選取之項目的色彩。 |
在套用變更之後，請使用 PublishThemeRequest 訊息將下列其中一個佈景主題記錄設為目前佈景主題。
匯出和匯入佈景主題
由於佈景主題未包含在解決方案中，因此如果您要在組織之間傳送佈景主題，可以使用 Configuration Migration 工具產生結構描述，匯出佈景主題資料，然後將它匯入其他組織。 如需如何使用此工具的詳細資訊，請參閱管理設定資料。
另請參閱
佈景主題實體訊息和方法
Theme entity privileges
Microsoft Dynamics CRM 2015 開發人員自訂指南
© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權