编辑站点地图

用于编辑 XML 文档的应用程序

由于 XML 文件是简单文本，因此可以使用各种文本编辑程序来编辑这些文件。熟悉编辑 XML 文件的许多用户都使用记事本。

如果您不熟悉如何编辑符合特定架构的 XML 文件，则可能希望使用具有架构验证功能的 XML 编辑工具，来帮助您避免出错。支持架构验证功能的两个免费的应用程序是 Microsoft Visual Web Developer 2008 Express Edition 和 XML Notepad 2007。

Microsoft Visual Web Developer 2008 Express Edition 具有 Microsoft Visual Studio 的多项功能，还包括用于开发 Web 应用程序的许多功能。该应用程序很大，可能需要花费一个小时来下载和安装。它使用 IntelliSense（可在用户键入时提供指导信息）以文本视图方式提供架构验证。出现的错误或缺少的必需元素均以下划线标出。

XML Notepad 2007 是一个用于编辑 XML 文件的较小的应用程序。它为 XML 文档提供由节点构成的树状视图界面。

请参阅本文档底部的“相关链接”，可以找到下载这些应用程序的链接。

注意

尽管“导入自定义项”功能的确可以对修改的自定义项文件执行验证，但这种验证还是可能无法找到每个错误。一个错误就可能中断 Microsoft Dynamics CRM导航窗格。如果发生这种情况，您需要使用“从错误中恢复”中描述的步骤返回到起始点。如果您不熟悉如何编辑必须符合特定架构的 XML 文档，我们强烈建议您使用支持架构验证功能的应用程序。

还有一个最普遍的做法是，将现有元素作为获得正确结构的某个起始点进行复制和粘贴，然后进行必要的更改以确保符合架构要求和获得所需的结果。

使用 Microsoft Visual Web Developer 2008 Express Edition 编辑 customizations.xml 文件

以下步骤介绍了使用架构验证功能编辑 XML 文档的过程。在此示例的开始，首先将新的“区域”元素添加到站点地图，介绍 Microsoft Visual Web Developer 2008 Express Edition 如何使用 IntelliSense 在用户键入时提供架构信息。

1. 打开 Microsoft Visual Web Developer 2008 Express Edition ，从“文件”菜单中选择“打开文件...”。

2. 在“打开文件”对话框中，选择“customizations.xml”，然后单击“打开”。

3. 在“查看”菜单上，选择“属性窗口”。

4. 在“属性”区域，选择“架构”框，键入 ISVConfigAndSiteMap.xsd，然后按“输入”。

5. 在 customizations.xml 中找到“资源中心”区域，将光标放在“区域”结束标记“</Area>”后面。

6. 键入“<” 符号以使用 IntelliSense 来查看文档中此区域的有效选项

   应当查看以下内容：

   

   区域是文档此部分中唯一有效的元素。

7. 键入 A 以选择“区域”元素，然后按 输入

8. 按空格键添加空格。

   应当看到区域元素的有效属性列表

   

9. 键入 I 并按下箭头键，以选择 Id，然后按 输入。您现在已经为输入属性值做好准备。

   

   Id 属性需要一个独特的字符串值。

10. 若要了解架构错误，请将光标放在有红色下划线的文本上方。

    

    

    这两种错误都表示区域标记未关闭。提供了区域元素的标记和任何所需标记之后，错误信息将消失。例如：

    <Area Id="my_unique_ID_value"></Area>

11. 继续定义您的元素。使用 SiteMap (Microsoft Dynamics CRM SDK) 中的信息和 IntelliSense 中的架构验证功能来定义相关元素的外观和行为。

12. 完成时保存您所做的更改，然后导入 customizations.xml 文件。

使用 XML Notepad 2007 编辑 customizations.xml 文件

以下步骤介绍了使用架构验证功能编辑 XML 文档的过程。在此示例的开始，首先将区域元素添加到站点地图中，介绍 XML Notepad 2007 如何使用树状视图和图形用户界面 (GUI) 来提供编辑 XML 文档的结构。

1. 打开 XML Notepad 2007，从“文件”菜单中选择“打开”。

2. 在“打开”对话框中，选择“customizations.xml”，然后单击“打开”。

3. 在“查看”菜单上，选择“架构…”。

4. 在“XML 架构”对话框中，从“文件”菜单上选择“添加架构…”。

5. 在“打开”对话框中，浏览到“ISVConfigAndSiteMap.xsd”并选择该文件。然后单击“打开”。

6. 单击“确定”关闭“XML 架构”对话框。

7. 在“树视图”选项卡中，展开 SiteMap 节点，然后选择最后一个区域元素。

   

8. 右键单击“区域”节点，然后从上下文菜单中选择“元素”>“晚于”。

   

9. 框中将显示所有有效的元素名称。选择“区域”元素。

   
   注意

   “错误列表”区域会提供说明内容“缺少必需的 Id 属性”。这表明，有效的区域元素必须具有 Id 属性。

10. 若要添加属性，请右键单击您所创建的“区域”元素，然后从上下文菜单中选择“属性”>“子级”。

    

11. 从现有属性列表中选择“Id”

    注意

    • 列表中最后四个项目不是有效属性。编辑 站点地图 时，类型、nil、schemaLocation 和 noNamespaceSchemaLocation 不相关。这些选项是由 XML Notepad 2007 提供的。

    • “错误列表” 区域提供说明内容“Id 属性无效 – 根据数据类型 CRM_Identifier_SiteMap 判定该值无效 – 模式约束失败。”这表明，有效的区域元素 Id 属性必须具有值。

12. 为区域 Id 属性值键入一个唯一值。

13. 继续配置必要的元素和属性，以实现您的目标。使用架构验证功能所提供的选项以及 SiteMap (Microsoft Dynamics CRM SDK) 中的信息。

14. 保存您所做的更改，然后导入 customizations.xml 文件以查看更改的内容。

子区域所创建的大多数链接实际上都是特定实体的视图，例如“潜在顾客”或“商机”。若要更改这些链接的名称，请更改相关实体的显示名称。由于子区域通过实体属性与特定实体相关联，这些更改将会反映在导航窗格中。有关更改实体名称的信息，请参阅 指定术语：使用贵组织的命名法 。

但是，对于与特定实体不关联的子区域，您可以更改其名称。例如，如果您要将“设置”区域中的“产品目录”区域的名称更改为“产品列表”，请添加如下所示的标题元素。

         <SubArea Id="nav_productcatalog" ResourceId="Homepage_ProductCatalog"
        DescriptionResourceId="ProductCatalog_SubArea_Description"
        Icon="/_imgs/ico_18_productcatalog.gif"
        Url="/tools/productcatalog/productcatalog.aspx"
        AvailableOffline="false">
        <Titles>
        <Title LCID="1033" Title="Product List"/>
        </Titles>
        <Privilege Entity="product" Privilege="Read" />
        

提示

根据用于编辑 XML 文件的应用程序，通常可以先按 Ctrl+F 在文件中找到特定的字词，由此快速找到 XML 文件的已知区域。

对区域中的链接分组

组为带有可折叠行的子区域提供了一种分组方法。默认情况下，只有“工作区”区域才使用组。但任何区域都可以使用组。不过，您必须确保将区域中的 ShowGroups 属性设为“true”才能使组显示出来。另外，IsProfile 属性只能应用于“工作区”区域中的组。

例如，若要将“服务”区域中的子区域元素分成两组，需要将：

	
<Area Id="CS" ResourceId="Area_Service" Icon="/_imgs/services_24x24.gif" 
      DescriptionResourceId="Customer_Service_Description">
 <Group Id="CS">
  <SubArea Id="nav_apptbook" ResourceId="Homepage_AppointmentBook" 
           DescriptionResourceId="AppointmentBook_SubArea_Description" 
           Icon="/_imgs/ico_18_servicecal.gif" Url="/sm/home_apptbook.aspx" 
           AvailableOffline="false">
   <Privilege Entity="activitypointer" Privilege="Read" />
   <Privilege Entity="service" Privilege="Read" />
  </SubArea>
  <SubArea Id="nav_cases" Entity="incident" 
           DescriptionResourceId="Cases_SubArea_Description" Url="/CS/home_cases.aspx" />
  <SubArea Id="nav_accts" Entity="account" DescriptionResourceId="Account_SubArea_Description" />
  <SubArea Id="nav_contacts" Entity="contact" DescriptionResourceId="Contact_SubArea_Description" />
  <SubArea Id="nav_managekb" ResourceId="Homepage_KBManager" 
           DescriptionResourceId="KBManager_SubArea_Description" Icon="/_imgs/ico_18_126.gif" 
           Url="/cs/home_managekb.aspx" AvailableOffline="false">
   <Privilege Entity="kbarticle" Privilege="Read,Write,Create" />
  </SubArea>
  <SubArea Id="nav_contracts" Entity="contract" 
           DescriptionResourceId="Contract_SubArea_Description" />
  <SubArea Id="nav_products" Entity="product" DescriptionResourceId="Product_SubArea_Description" />
  <SubArea Id="nav_services" Entity="service" DescriptionResourceId="Service_SubArea_Description" />
 </Group>
</Area>
		

更改为：

	
<Area Id="CS" ResourceId="Area_Service" Icon="/_imgs/services_24x24.gif" ShowGroups="true"
      DescriptionResourceId="Customer_Service_Description">
 <Group Id="CS">
  <Titles>
   <Title LCID="1033" Title="Group 1"/>
  </Titles>
  <SubArea Id="nav_apptbook" ResourceId="Homepage_AppointmentBook" 
           DescriptionResourceId="AppointmentBook_SubArea_Description" 
           Icon="/_imgs/ico_18_servicecal.gif" Url="/sm/home_apptbook.aspx" 
           AvailableOffline="false">
   <Privilege Entity="activitypointer" Privilege="Read" />
   <Privilege Entity="service" Privilege="Read" />
  </SubArea>
  <SubArea Id="nav_cases" Entity="incident" 
           DescriptionResourceId="Cases_SubArea_Description" Url="/CS/home_cases.aspx" />
  <SubArea Id="nav_accts" Entity="account" DescriptionResourceId="Account_SubArea_Description" />
  <SubArea Id="nav_contacts" Entity="contact" DescriptionResourceId="Contact_SubArea_Description" />
 </Group>
 <Group Id="CS_New_Group">
  <Titles>
   <Title LCID="1033" Title="Group 2"/>
  </Titles>
  <SubArea Id="nav_managekb" ResourceId="Homepage_KBManager" 
           DescriptionResourceId="KBManager_SubArea_Description" Icon="/_imgs/ico_18_126.gif" 
           Url="/cs/home_managekb.aspx" AvailableOffline="false">
   <Privilege Entity="kbarticle" Privilege="Read,Write,Create" />
  </SubArea>
  <SubArea Id="nav_contracts" Entity="contract" 
           DescriptionResourceId="Contract_SubArea_Description" />
  <SubArea Id="nav_products" Entity="product" DescriptionResourceId="Product_SubArea_Description" />
  <SubArea Id="nav_services" Entity="service" DescriptionResourceId="Service_SubArea_Description" />
 </Group>
</Area>
		

其中的更改包括：

• 区域元素包含属性 ShowGroups="true"

• 两个组现均在标题中包含标题。

• 新组具有唯一的 Id 属性值。

• 某些子区域已移动到新组中。

更改用户可以从中进行选择的工作区配置文件选项

将组添加到“工作区”区域时，可以将 IsProfile 属性设为“true”。这样可以使用户选择他们是否希望该组在其“工作区”区域中以个人所选的方式显示。