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

 

发布日期： 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（“帮助”）。

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

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

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

Microsoft Dynamics CRM for Outlook 导航

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

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

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

编辑标签

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

添加或更改图标

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

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

应使用 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。 保留所有权利。 版权