查询和编辑组织主题
发布日期: 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。 保留所有权利。 版权