查询和编辑组织主题

 

发布日期: 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 实体属性:

架构名称

Type

默认主题值

说明

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 为当前主题创建一个主题记录。

导入和导出主题

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

另请参阅

主题实体消息和方法
Theme entity privileges
针对 Microsoft Dynamics CRM 2015 自定义的开发人员指南

© 2017 Microsoft。 保留所有权利。 版权