使用 SiteMap 更改应用程序导航

网站地图使你能够控制 Dynamics 365 for Customer Engagement 中的应用程序导航(菜单)和其他选项,例如编辑标签、添加或更改图标,以及添加或更改元素。

应用程序导航

SiteMap 提供了 Dynamics 365 for Customer Engagement 中的导航结构。 该功能将结合您的安全权限进行评估,以在应用程序中显示导航选项。 如果安全特权不提供对 SiteMap 中指定的实体的读取访问权限,则不会向你显示该导航选项。 该 <Privilege> 元素还可用于指定特权要求,以查看与特定实体无关的页面。

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

Web 应用程序导航栏

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

SiteMap 显示 Dynamics 365 Customer Engagement 中的区域。

可选择的区域显示在导航栏底部。 选择 区域 后,该区域将显示为 所选区域。 将自动显示该区域最近使用的 子区域 。 选择所选区域后,将显示可用的组和子区域,如下图所示。

SiteMap 显示 Dynamics 365 Customer Engagement 中的组和子区域。

在此图中,已选择“销售”(SFA)区域,并显示“我的工作”、“客户”、“销售”(SFA)、附件市场营销(MA)、目标和工具组。

每个组包含多个子区域。 选择子区域后,该子区域的网站地图中定义的内容将显示在导航栏下方。

Dynamics 365 for Outlook 导航

下图显示了 Dynamics 365 for Outlook 导航。 Outlook 按字母顺序显示每个导航区域,而不是使用在树 SiteMap视图中指定的顺序。 每个人都可以将阅读窗格放在底部,如图所示,或放在侧边。 他们也可以隐藏它。 可以将每个实体配置为确定是否显示阅读窗格。 详细信息: 可编辑实体属性

Outlook 中的 SiteMap。

使用 SiteMap 提供的配置选项

以下各节介绍可以使用 SiteMap 执行的常见任务。

编辑标签

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

添加或更改图标

这两 <Area> 个元素 <SubArea> 都有一个 Icon 属性,可用于指定要显示为图标的图像的大小和其他特征。

自 CRM 2015 SP1 起,<Area>图标采用 85x71 像素(宽x高)白色图像,透明度为 18%。 菜单 <SubArea> 使用 32x32 像素图像作为实体图标。

Dynamics 365 Customer Engagement 中图标的像素大小。

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

添加或删除元素

添加元素
编辑 XML SiteMap 元素时,可以复制和粘贴现有的 XML 元素,作为进一步优化的基础。

重要

如果创建新元素,它必须具有唯 Id 一的属性值或导入解决方案将失败。 新增元素时,需在 Id 值前添加适当的解决方案发布者自定义前缀。

详细信息: 向区域添加新页面

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

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

如果<Group><Area>中的子区域元素因用户的安全特权而无法查看,则该元素不会显示。

如果使用该 <SubArea>AvailableOffline 属性防止在 Dynamics 365 for Outlook 用户脱机工作时显示子区域,用户仍可导航到子区域,但会看到一条消息,指示要显示的页面不可用。

注释

建议使用安全角色特权来控制对应用程序区域的访问。

若无需编辑安全角色,可在 SiteMap XML 中注释该节点。 注释节点优于删除,因未来可随时取消注释恢复该节点。

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

向区域添加新页面

使用 <SubArea> 元素向区域添加新页面。 如果要为实体添加网格,请包含唯一 ID,使用Entity属性指定实体,然后使用<Title><Description>元素分别提供标题和说明。

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

引用 HTML Web 资源时,请确保使用 Web 资源指令 $webresource:。 例如,当HTML网页资源的名称为Icon="$webresource:sample_/Pages/MyCustomPage.htm"时,使用sample_/Pages/MyCustomPage.htm。 使用此指令将创建一个依赖项,以便只要 SiteMap 元素需要 HTML Web 资源,就不能删除该资源。

SiteMap其中添加外部页面时,将查询字符串形式的数据传递给页面是一个常见要求。 若要传递有关组织名称和用户和组织语言的信息,请使用该 PassParams 属性。 详细信息: 使用 SiteMap 将参数传递到 URL

另请参阅

自定义 Dynamics 365 Customer Engagement
使用 SiteMap 将参数传递到 URL
扩展元数据模型
自定义实体表单
自定义可视化效果和仪表板
自定义实体视图
自定义全局选项集
自定义命令和功能区
服务日历外观配置
发布自定义设置
何时编辑自定义文件