查詢和編輯組織佈景主題

發行項
03/04/2017

發行︰ 2017年1月

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

您可以針對組織定義和套用視覺佈景主題。這可提供支援的方式，將組織的標誌和色彩選擇套用至應用程式。您可以對未經自訂的 Dynamics 365 系統所提供的預設色彩和視覺項目進行變更，以自訂應用程式的佈景主題。例如，您可以建立個人產品品牌、新增公司標誌，以及提供實體特定著色。佈景主題色彩會在整個應用程式中全域套用，但有些傳統區域除外。

注意

CRM Online 2015 更新 1 和 CRM 2016 (內部部署) 已經引進此功能。

此版本中只支援 Web 應用程式的佈景主題自訂。針對組織佈景主題所做的變更不會包含在從組織匯出的解決方案中。您可以定義多個佈景主體，但只有一個佈景主題可以設定和發行為預設佈景主題。

影片：Microsoft Dynamics CRM 中的佈景主題設定

本主題內容

查詢目前佈景主題

編輯和發行佈景主題資料

匯出和匯入佈景主題

查詢目前佈景主題

您可能需要使用用戶端程式碼查詢目前的佈景主題，如果您的解決方案中包含 HTML Web 資源，而您想讓這些資源配合為組織選擇的佈景主題。您可以使用下列查詢搭配 Web API 擷取該資訊。

要求：

GET <client_URL>/api/data/v8.0/themes?$filter=isdefaulttheme eq true&$select=defaultentitycolor,defaultcustomentitycolor,controlborder,controlshade,selectedlinkeffect,globallinkcolor,processcontrolcolor,headercolor,logotooltip,hoverlinkeffect,navbarshelfcolor,navbarbackgroundcolor

回覆:

    {
        "@odata.context": "<client_URL>/api/data/v8.0/$metadata#themes(defaultentitycolor,defaultcustomentitycolor,controlborder,controlshade,selectedlinkeffect,globallinkcolor,processcontrolcolor,headercolor,logotooltip,hoverlinkeffect,navbarshelfcolor,navbarbackgroundcolor)",
        "value": [
            {
                "defaultentitycolor": "#001CA5",
                "defaultcustomentitycolor": "#006551",
                "controlborder": "#CCCCCC",
                "controlshade": "#F3F1F1",
                "selectedlinkeffect": "#B1D6F0",
                "globallinkcolor": "#1160B7",
                "processcontrolcolor": "#D24726",
                "headercolor": "#1160B7",
                "logotooltip": "Microsoft CRM",
                "hoverlinkeffect": "#D7EBF9",
                "navbarshelfcolor": "#DFE2E8",
                "navbarbackgroundcolor": "#002050",
                "themeid": "f499443d-2082-4938-8842-e7ee62de9a23"
            }
        ]
    }

其他資訊：使用 Web API 查詢資料。

編輯和發行佈景主題資料

佈景主題是利用 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 365	即將做為商標之工具提示和替代文字的文字。
Name	String	Dynamics 365 預設佈景主題	佈景主題實體的名稱。
NavBarBackgroundColor	String	#002050	主要導覽列色彩。
NavBarShelfColor	字串	#DFE2E8	次要導覽列色彩。
ProcessControlColor	字串	#0755BE	處理控制項的主要色彩。
SelectedLinkEffect	字串	#B1D6F0	命令或清單將用來指示選取之項目的色彩。

在套用變更之後，請使用 PublishThemeRequest 訊息將下列其中一個佈景主題記錄設為目前佈景主題。

匯出和匯入佈景主題

由於佈景主題未包含在解決方案中，因此如果您要在組織之間傳送佈景主題，可以使用 Configuration Migration 工具產生結構描述，匯出佈景主題資料，然後將它匯入其他組織。如需如何使用此工具的詳細資訊，請參閱管理設定資料。

另請參閱

佈景主題實體訊息和方法
 自訂 Microsoft Dynamics 365 應用程式

Microsoft Dynamics 365

共用方式為

查詢和編輯組織佈景主題

本主題內容

查詢目前佈景主題

編輯和發行佈景主題資料

匯出和匯入佈景主題

另請參閱

其他資源