编辑站点地图
发布日期： 2017年1月
适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online
可以通过下面的任何方法编辑默认站点地图或应用程序特定的站点地图：
如果您在使用 Microsoft Dynamics 365 早期版本，则使用 适用于 Dynamics 365 的 2016 年 12 月更新（联机和本地） 中引入的新站点地图设计器或第三方站点地图编辑器。
以编程方式更新 SiteMap 实体记录以更新 SiteMap.SiteMapXml 属性中的 XML。
手动编辑导出的非托管解决方案的 customizations.xml 文件中的 SiteMap 节点中的 XML，然后将解决方案作为托管或非托管解决方案导入。
本主题内容
使用站点地图编辑器
以编程方式更新站点地图
手动编辑站点地图
使用方案验证编辑
编码和号字符
从错误中恢复
使用站点地图编辑器
如果在使用 适用于 Dynamics 365 的 2016 年 12 月更新（联机和本地），请使用新的站点地图设计器创建和管理站点地图。详细信息：为应用创建站点地图
但是可以使用一个第三方站点地图编辑器编辑默认站点地图。 由于 适用于 Dynamics 365 的 2016 年 12 月更新（联机和本地） 中引入了应用特定的站点地图，第三方站点地图编辑器可能无法正常用于编辑业务应用的站点地图。 Microsoft Dynamics 365 MVP Tanguy Touzard 发布的 Toolbox for Dynamics CRM 2011/2013 中包含一个受欢迎的站点地图编辑器，可用于编辑默认站点地图。
虽然这些应用程序简化了编辑站点地图的流程，但是他们仍要求您了解一引起站点地图 XML 概要。 有关详细信息，请参阅SiteMap XML reference。
备注
Microsoft Dynamics 365 技术支持不提供对第三方应用程序的支持。 如果您对这些应用程序有任何疑问，请联系应用程序发布者。
以编程方式更新站点地图
检索要更新的 SiteMap 实体记录，然后更新该记录的 SiteMap.SiteMapXml 属性中的 XML。 确保编辑 XML 之前了解站点地图的 XML 架构。 有关详细信息，请参阅SiteMap XML reference。
使用 Update 方法以编程方式更新 SiteMap 记录时，您指定的站点地图 XML 将覆盖记录的 SiteMap.SiteMapXml 属性中的现有 XML。
备注
-
也可以以编程方式创建和删除应用特定的 SiteMap 记录。 若要创建应用特定的 SiteMap 记录，必须至少指定以下属性的值：SiteMap.SiteMapNameUnique 和 SiteMap.SiteMapXml。 但是，我们建议不要以编程方式创建和删除应用特定的站点地图，必须使用新增的站点地图设计器创建和删除应用特定的站点地图。详细信息：为应用创建站点地图
-
不能以编程方式创建和删除默认 SiteMap 记录。 可以使用 SiteMap.IsAppAware 属性区分这两种站点地图：0 指示默认站点地图，1 指示应用特定的站点地图。
手动编辑站点地图
可以手动编辑导出的非托管解决方案的 customizations.xml 文件中的 SiteMap 节点，然后将其导入回 Dynamics 365 中以更新站点地图。 根据导入的是非托管还是托管解决方案，确定如何更新 SiteMap 记录。
导入非托管解决方案将覆盖 SiteMap 中的现有站点地图 XML。
导入托管解决方案将使用最新更改创建一个新的 SiteMap 记录，并将最新/有效 SiteMap 记录的 SiteMap.OverwriteTime 属性值设置为 DateTime 字段的默认值 (1900-01-01 00:00:00.000)。 现有 SiteMap 记录的 SiteMap.OverwriteTime 属性值在更新时设置为 datetime 值。
若要编辑站点地图
依次单击“设置”、“自定义”和“解决方案”。
向新的或现有非托管解决方案添加默认站点地图或应用特定的站点地图。 在该解决方案中，从左侧“组件”列表中选择“客户端扩展”。 选择“添加现有”，然后选择“站点地图”。 从站点地图列表中：
若要添加默认站点地图，请选择 Site Map。
若要添加应用特定的站点地图，请选择一个自定义业务应用站点地图。 对话框将显示您可以访问的所有自定义业务应用的站点地图。 例如，在此示例中，可以选择 Contoso Sales App 或 Contoso Service App。
.jpeg "Select default or app-specific site map to add")
备注
仅当您有 适用于 Dynamics 365 的 2016 年 12 月更新（联机和本地） 或更高版本并且您的 Dynamics 365 实例中有自定义业务应用时，才显示应用特定的站点地图。 也可以选择要添加到同一个解决方案的多个应用特定的站点地图和默认站点地图。
单击“选择解决方案组件”屏幕中的“确定”。
单击“保存”保存对解决方案的更改。
单击“导出解决方案”并执行解决方案导出向导中的步骤导出解决方案。
在导出解决方案之后，从压缩的 .zip 文件中提取文件。
提示
保留压缩的 .zip 文件作为备份。
在 customizations.xml 文件中，找到：
ImportExportXml/SiteMap 下的 SiteMap 节点以编辑默认站点地图。
ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap 下的 SiteMap 节点以编辑应用特定的站点地图。
提示
如果导出解决方案之前在其中添加了多个应用特定的站点地图，则可使用 ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap 下的 SiteMapUniqueName 和 SiteMapName 确定 customizations.xml 文件中应该为站点地图编辑的 SiteMap 节点。
根据需要编辑 SiteMap 节点。
备注
如果使用可提供架构验证的编辑器，编辑 XML 会容易得多。 有关详细信息，请参阅使用方案验证编辑。
创建一个新的压缩 .zip 文件，其中包括提取的解决方案文件和已编辑的 customizations.xml。
提示
在 Windows 资源管理器中，选择所有文件。 然后单击右键并选择“发送到”和“压缩(zipped)文件夹”。
导入新解决方案文件。
在 Microsoft Dynamics 365 中，依次单击“设置”、“自定义”和“解决方案”。
单击“导入”。
单击“浏览”，找到已修改的解决方案 .zip 文件，然后依次单击“下一步”和“导入”。
导入完成后，单击“关闭”。
发布自定义项。
提示
如果无法立即看到更改，请刷新浏览器页面。
使用方案验证编辑
为获得更好的体验，请通过可使用架构验证来提供 IntelliSense 支持的应用程序编辑 customizations.xml 文件。 有关详细信息，请参阅使用架构验证编辑功能的自定义 XML 文件。
编码和号字符
将URL添加到包含与号字符 (&) 的站点地图时，必须通过将其替换为“&”来对其进行编码。 如果不对此字符编码，XML验证将失败，您将无法导入解决方案。 例如：
正确：
<SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value&parameter2=value ">不正确：
<SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value¶meter2=value">
从错误中恢复
解决方案导入工具在站点地图上执行验证。 如果出现错误，则应用默认站点地图，并显示错误消息。 您必须在站点地图中修复错误，并再次导入。 但是，仍可能出现某些错误。
下面是手动编辑/导入自定义业务应用站点地图之后运行自定义业务应用时可能遇到的一些错误：
站点地图无子区域
站点地图有子区域，但是无权查看子区域
无效的实体（不是合法的 Dynamics 365 实体名称）
无效的 url
站点地图有仪表板节点，但是模块化业务应用定义中未选择任何仪表板
另请参阅
自定义站点地图
使用站点地图更改应用程序导航
使用站点地图将参数传递给 URL
控制对帮助和培训网站的访问
SiteMap XML reference
SiteMap schema
Microsoft Dynamics 365
© 2017 Microsoft。 保留所有权利。 版权