使用站点地图更改应用程序导航

 

发布日期: 2016年11月

适用于: Dynamics CRM 2015

SiteMap 是已导出的非托管解决方案的 customizations.xml 文件中的一个节点。 通过使用安全角色权限和编辑 SiteMap 可以编辑 Microsoft Dynamics 365 提供的导航选项。详细信息:编辑站点地图

在本主题中

应用程序导航

使用站点地图时可用的配置选项

应用程序导航

站点地图提供 Microsoft Dynamics 365 中的导航结构, 会将其与您的安全权限一起进行评估,以在应用程序中显示导航选项。 如果您的安全权限不提供对站点地图中指定实体的读取访问权限,将不向您显示导航选项。<Privilege> (SiteMap) 元素也可用于指定查看与特定实体不相关的页面的权限要求。

若要了解定义应用程序导航选项的数据,请将您在应用程序中看到的内容与 Default SiteMap XML 或从组织导出的自定义sitemap元素进行比较。

Web 应用程序导航栏

下图显示 Web 应用程序导航栏。 显示的默认区域有 SFA(“销售”)、CS(“服务”)、MA(“营销”)、Settings(“设置”)和HLP(“帮助”)。

站点地图在 Dynamics CRM 显示区域

可选择区域显示在导航栏的底部。 当选择区域时,区域显示为所选区域。 该区域中最近使用的任何子区域会自动显示。 在选择所选区域时,会显示可用组和子区域,如下图所示。

站点地图在 CRM 中显示组和子区域

在该图中,选中 SFA 区域,组 MyWork(“我的工作”)、Customers(“客户”)和 SFA(“销售”)可见。 要查看其余组和子区域,用户必须滚动到右边。

每个组包含大量子区域。 选择子区域时,该子区域的站点地图中定义的内容将显示在导航栏下面。

Microsoft Dynamics CRM for Outlook 导航

下图显示 Dynamics CRM for Outlook 导航。Microsoft Outlook 在 SiteMap 中按字母顺序而不是站点地图中指定的顺序呈现每个导航区域。 每个人可以选择将阅读窗格放置在底部(如图所示)还是放置在侧面。 他们也可以选择不显示该窗格。 可对每个实体进行配置,以确定它是否显示阅读窗格。详细信息:可编辑实体属性

Outlook 中的站点地图

使用站点地图时可用的配置选项

以下各节介绍可以使用站点地图执行的常见任务。

编辑标签

默认SiteMap中显示的所有文本都使用 ResourceId 属性以指定文本。 您不应更改或删除 ResourceId 属性值。 如果要更改元素中显示的标签,请使用 <Titles> (SiteMap)<Title> (SiteMap) 元素指定要用于组织或解决方案的文本。 任何标题元素都将覆盖 ResourceId 属性值。

添加或更改图标

<Area> (SiteMap)<SubArea> (SiteMap) 元素都有一个 Icon 属性,用于指定图像的大小和其它特性以显示为图标。

在 CRM 2015 SP1 中,<Area> (SiteMap) 的图标是 85x71 (宽度 x 高度)像素的图像,颜色为白色,不透明度为 18%。<SubArea> (SiteMap) 菜单使用 32x32 像素的图像作为实体图标。

CRM 中的图标像素大小

应使用 GIF、PNG 或 JPG 图像 Web 资源作为图标源。 在您引用 Web 资源时,请确保使用 Web 资源指令 ($webresource:)。 例如,当 Web 资源的名称为 “sample_/icons/MyAreaIcon1.png” 时,应使用 Icon="$webresource:sample_/icons/MyAreaIcon1.png"。 使用该指令将会创建一个依赖项,因此只要您的 SiteMap 元素需要该 Web 资源,您就不能将其删除。

添加或删除元素

  • 添加元素
    SiteMap 中编辑 XML 元素时,复制并粘贴现有 XML 元素以提供更高起点是很常见的事情。

    重要

    如果创建新元素,该元素必须具有唯一的 Id 属性值,否则导入解决方案将失败。 应为您添加的任何新元素的 Id 值预置适当的解决方案发布商自定义前缀。
    详细信息:向区域中添加新页面

  • 移除元素
    SiteMap 中移除元素之前,请考虑编辑用户的安全角色权限是否会实现您的目标。 与实体页关联的每个 <SubArea> (SiteMap) 元素均使用用户的权限进行评估,并且仅在允许用户查看该实体的记录时显示。

    如果某个子区域显示页面(如不与特定实体关联的 Web 资源),则可将 <Privilege> (SiteMap) 元素添加到该子区域,以使该页面与特定操作的权限或某实体的访问权限相关联。

    如果因安全权限的原因,用户无法查看 <Group> (SiteMap)<Area> (SiteMap) 中的任何子区域元素,则不显示该元素。

    如果使用 <SubArea> (SiteMap)AvailableOffine 属性禁止在 Dynamics CRM for Outlook 用户脱机工作时显示子区域,用户仍然可以导航到该子区域,但会对其显示一条消息,指示要显示的页面在脱机时不可用。

    备注

    建议您使用安全角色权限来控制对应用程序区域的访问。
    如果不想编辑安全角色,则可在 SiteMap XML 中注释掉该节点。 注释掉节点好于删除节点,因为如果将来要恢复该节点,则始终可以取消对该节点的注释。

区域中的组链接

“工作区”和“设置”区域包括多组链接。 可按类似方式使用 <Group> (SiteMap) 元素在其他区域中创建组。 必须具有一个组元素,但必须包括 <Title> (SiteMap)<Description> (SiteMap) 元素,该元素才能显示为组。 最后,必须编辑 <Area> (SiteMap) 元素,以添加 ShowGroups 属性并将其设置为 true

向区域中添加新页面

使用 <SubArea> (SiteMap) 元素可向区域中添加新页面。 如果要为实体包括一个网格,则应包括唯一 ID,使用 Entity 属性指定该实体,然后使用 <Title> (SiteMap)<Description> (SiteMap) 元素提供标题和描述。

若要在应用程序中显示自定义页面,则必须设置 Url 属性,而不是 Entity 属性。Url 属性可以引用外部网站或 HTML Web 资源中的页面。

在引用 HTML Web 资源时,请确保使用 Web 资源指令 ($webresource:)。 例如,当 HTML Web 资源的名称为 “sample_/Pages/MyCustomPage.htm” 时,应使用 Icon="$webresource:sample_/Pages/MyCustomPage.htm"。 使用该指令将会创建一个依赖项,因此只要您的 SiteMap 元素需要该 HTML Web 资源,您就不能将其删除。

备注

若要在实体窗体或图表外显示 Silverlight Web 资源,请创建 HTML Web 资源作为 Silverlight Web 资源的宿主页。 然后使用 $webresource: 指令打开 HTML Web 资源。

SiteMap 添加外部页面时,通常要求以查询字符串的形式向页面传递数据。 若要传递有关组织名称以及用户和组织所用语言的信息,请使用 PassParams 属性。详细信息:使用站点地图将参数传递给 URL

另请参阅

针对 Microsoft Dynamics CRM 2015 自定义的开发人员指南
编辑站点地图
使用站点地图将参数传递给 URL
控制对帮助和培训网站的访问
扩展元数据模型
自定义实体窗体
自定义可视化和仪表板
自定义实体视图
配置全局选项集
自定义命令和功能区
服务日历外观配置
发布自定义项
何时编辑 customizations.xml 文件

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