Editar el mapa del sitio

Aplicaciones para la edición de documentos XML

Debido a que los archivos XML son texto simple, se pueden editar con una variedad de programas de edición de texto. Muchos usuarios familiarizados con los archivos XML usan el Bloc de notas.

Si no está familiarizado con la edición de archivos XML que coinciden con un esquema específico, es posible que desee usar una herramienta de edición de XML que proporcione una validación de esquema, lo que permite evitar errores. Dos aplicaciones gratuitas que admiten la validación de esquema son Microsoft Visual Web Developer 2008 Express Edition y Bloc de notas de XML 2007.

Microsoft Visual Web Developer 2008 Express Edition tiene muchas de las capacidades de Microsoft Visual Studio e incluye diversas características para el desarrollo de aplicaciones web. Es una aplicación de gran tamaño cuya descarga e instalación puede tardar una hora. Proporciona una validación de esquema en una vista de texto mediante IntelliSense para obtener instrucciones a medida que se escribe. Subraya los errores u omisiones de elementos requeridos.

Bloc de notas de XML 2007 es una pequeña aplicación para la edición de archivos XML. Tiene una interfaz en vista de árbol de los nodos de un documento XML.

Vea los vínculos relacionados al final de este documento para la descarga de estas aplicaciones.

Nota

Aunque la característica Importar personalizaciones realiza la validación del archivo de personalizaciones modificado, es posible que la validación no detecte todos los errores. Un error puede bloquear el Panel de navegación de Microsoft Dynamics CRM. En este caso, debe seguir los pasos que se describen en "Recuperación de errores" para volver al punto de inicio. Si no está familiarizado con la edición de documentos XML que deben cumplir un esquema específico, se recomienda usar una aplicación que admita la validación de esquema.

Es una práctica muy común copiar y pegar los elementos existentes como punto de partida para obtener la estructura correcta y, a continuación, realizar los cambios necesarios para asegurarse de la conformidad con los requisitos del esquema y obtener el resultado deseado.

Editar el archivo customizations.xml mediante Microsoft Visual Web Developer 2008 Express Edition

Estos pasos presentan el proceso de edición de documentos XML con validación de esquema. En este ejemplo se empieza agregando un nuevo elemento Área al Mapa del sitio para presentar la forma en que Microsoft Visual Web Developer 2008 Express Edition usa IntelliSense para proporcionar información del esquema a medida que escribe.

1. Abra Microsoft Visual Web Developer 2008 Express Edition y, en el menú Archivo, seleccione Abrir archivo....

2. En el cuadro de diálogo Abrir archivo, seleccione el campo customizations.xml y, a continuación, haga clic en Abrir.

3. En el menú Vista, seleccione Ventana Propiedades.

4. En el área Propiedades, seleccione el cuadro Esquemas y escriba ISVConfigAndSiteMap.xsd; a continuación, presione Entrar.

5. Busque el área Centro de recursos en el customizations.xml y coloque el cursor después de la etiqueta de cierre de Área: "</Area>".

6. Escriba el símbolo < para usar IntelliSense y ver las opciones válidas para esta área del documento.

   Debe ver lo siguiente:

   

   Área es el único elemento válido en esta parte del documento.

7. Escriba A para seleccionar el elemento Área y presione Entrar.

8. Presione la barra espaciadora para agregar un espacio.

   Debe ver una lista de los atributos válidos para el elemento Área.

   

9. Escriba I y presione la tecla de flecha abajo para seleccionar Id. A continuación, presione Entrar. Ahora puede escribir el valor del atributo.

   

   El atributo Id requiere un valor de cadena único.

10. Para conocer los errores del esquema, coloque el cursor sobre el texto subrayado en rojo.

    

    

    Ambos errores indican que la etiqueta Area no está cerrada. La información del error desaparecerá cuando se proporcione la etiqueta para el elemento Área y cualquier atributo necesario. Por ejemplo:

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

11. Continúe con la definición de los elementos. Use la información del mapa del sitio (SDK de Microsoft Dynamics CRM) y el esquema de validación de IntelliSense para definir la apariencia y el comportamiento de los elementos.

12. Guarde los cambios cuando haya terminado e importe el archivo customizations.xml.

Editar el archivo customizations.xml mediante Bloc de notas de XML 2007

Estos pasos presentan el proceso de edición de documentos XML con validación de esquema. En este ejemplo se empieza agregando un nuevo elemento Área al Mapa del sitio para presentar la forma en que Bloc de notas de XML 2007 usa una vista de árbol y una interfaz gráfica de usuario (GUI) para proporcionar estructura para la edición de documentos XML.

1. Abra el Bloc de notas de XML 2007 y, en el menú Archivo, seleccione Abrir.

2. En el cuadro de diálogo Abrir, seleccione el campo customizations.xml y, a continuación, haga clic en Abrir.

3. En el menú Vista, seleccione Esquemas....

4. En el cuadro de diálogo Esquemas XML, en el menú Archivo, seleccione Agregar esquemas....

5. En el cuadro de diálogo Abrir, desplácese hasta ISVConfigAndSiteMap.xsd y selecciónelo. Haga clic en Abrir.

6. Haga clic en Aceptar para cerrar el cuadro de diálogo Esquemas XML.

7. En la ficha Vista de árbol, expanda el nodo Mapa del sitio y seleccione el último elemento Área.

   

8. Haga clic con el botón secundario en el nodo Área y seleccione Elemento > Después en el menú contextual.

   

9. Los nombres de los elementos válidos aparecen en un cuadro. Seleccione el elemento Área.

   
   Nota

   El área Lista de errores indica que falta el elemento 'Id' requerido. Esto indica que un elemento Área válido debe tener un atributo Id.

10. Para agregar un atributo, haga clic con el botón secundario en el elemento Área que ha creado y seleccione Atributo > Secundario en el menú contextual.

    

11. Seleccione Id en la lista de atributos disponibles.

    Nota

    • Los últimos cuatro elementos de la lista no son atributos válidos. Tipo, nil, schemaLocation y noNamespaceSchemaLocation no son relevantes al editar el Mapa del sitio. Bloc de notas de XML 2007 proporciona estas opciones.

    • El área Lista de errores proporciona la descripción "The 'Id' attribute is invalid – The value '' is invalid according to the datatype 'CRM_Identifier_SiteMap' – The Pattern constraint failed." Esto indica que un atributo Id válido del elemento Área debe tener un valor.

12. Escriba un valor único para el valor del atributo Id de Área.

13. Continúe con la configuración de los elementos y atributos necesarios hasta conseguir sus objetivos. Use las opciones que proporciona la validación de esquema y la información del mapa del sitio (SDK de Microsoft Dynamics CRM).

14. Guarde los cambios e importe el archivo customizations.xml para ver los cambios.

La mayoría de los vínculos creados por Subáreas son realmente vistas de entidades específicas, como Clientes potenciales u Oportunidades. La forma de cambiar los nombres de estos vínculos es cambiar el Nombre para mostrar de la entidad. Los cambios se reflejarán en el Panel de navegación porque la Subárea está asociada con una entidad específica mediante el atributo Entity. Vea Defina sus términos: uso de la nomenclatura de la organización para obtener información acerca de los nombres de las entidades.

No obstante, puede cambiar el nombre de Subáreas no asociadas con una entidad particular. Por ejemplo, si desea cambiar el nombre del Área Catálogo de productos en el Área Configuración a "Lista de productos", agregue el elemento Títulos como se muestra anteriormente.

          <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" />
        

Sugerencia

En función de la aplicación que use para editar archivos XML, puede ubicar un área conocida del archivo XML mediante Ctrl+F para buscar una palabra específica en el archivo.

Agrupar vínculos en Áreas

Los Grupos ofrecen un modo de agrupar Subáreas con filas contraíbles. De forma predeterminada, sólo el Área de trabajo usa Grupos, pero cualquier Área puede usar Grupos. No obstante, debe asegurarse de establecer el atributo ShowGroups de Área en "true" para que los Grupos aparezcan. Además, el atributo IsProfile sólo se aplica a Grupos ubicados en el Área de trabajo.

Por ejemplo, para dividir los elementos Subárea en el Área Servicios en dos grupos, cambie lo siguiente:

	
<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>
		

A esto:

	
<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>
		

Los cambios son:

• El elemento Área incluye el atributo ShowGroups="true"

• Ambos Grupos incluyen ahora un Título en un elemento Títulos.

• El nuevo Grupo tiene un valor único para el atributo Id.

• Algunas de las Subáreas se han movido al nuevo Grupo.

Cambiar las opciones del perfil del área de trabajo que pueden seleccionar los usuarios

Cuando se agregan Grupos al Área de trabajo, puede establecer el atributo IsProfile en "true". Esto permite a los usuarios elegir si desean que se muestre este Grupo en el Área de trabajo en sus opciones personales.