查询和编辑组织主题

项目
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 实体属性：

架构名称	Type	默认主题值	说明
ControlBorder	字符串	#CCCCCC	控件将用于边框的颜色。
ControlShade	字符串	#F3F1F1	控件用于指示鼠标悬停在项上时的颜色。
DefaultCustomEntityColor	字符串	#006551	默认自定义实体颜色（如果未分派颜色）。
DefaultEntityColor	字符串	#8B98AB	系统实体的默认颜色（如果未分派颜色）。
GlobalLinkColor	字符串	#1160B7	链接的颜色，例如电子邮件地址或查找。
HeaderColor	字符串	#1160B7	标题文本的颜色，例如窗体选项卡标签。
HoverLinkEffect	字符串	#D7EBF9	命令或列表将在您的鼠标悬停在项上时使用的颜色。
LogoId	字符串	null	用作徽标的 Web 资源的名称。建议大小为高度 50 像素，最大宽度 400 像素。
LogoToolTip	字符串	Microsoft Dynamics 365	将用作徽标的提示和替换文本的文本。
Name	字符串	Dynamics 365 默认主题	主题实体的名称。
NavBarBackgroundColor	字符串	#002050	主导航栏颜色。
NavBarShelfColor	字符串	#DFE2E8	辅助导航栏颜色。
ProcessControlColor	字符串	#0755BE	处理控件的主颜色。
SelectedLinkEffect	字符串	#B1D6F0	命令或列表将用于指示选定项的颜色。

在应用更改后，请使用 PublishThemeRequest 为当前主题创建一个主题记录。

导入和导出主题

由于主题未作为解决方案的一部分包含在内，如果要将主题从一个组织转移到另一个，可使用配置迁移工具生成架构，导出主题数据，然后将其导入其他组织。有关如何使用该工具的详细信息，请参阅管理配置数据。

另请参阅

主题实体消息和方法
 自定义 Microsoft Dynamics 365 应用程序

Microsoft Dynamics 365

通过

查询和编辑组织主题

在本主题中

查询当前主题

编辑和发布数据主题

导入和导出主题

另请参阅

其他资源