Personalización

Editar el mapa del sitio

Configurar el mapa del sitio para personalizar la navegación por la aplicación

Puede personalizar el contenido del Panel de navegación en Microsoft Dynamics CRM Online mediante la edición del Mapa del sitio. El Mapa del sitio es un documento XML y si nunca ha editado un documento XML, usar las herramientas que ofrece la validación de esquema puede facilitar esta tarea.

Algunas de las personalizaciones que puede realizar son:

Cambiar el nombre de las áreas en el Panel de navegación
Cambiar el orden de las áreas en el Panel de navegación
Reorganizar o agregar nuevas áreas
Cambiar el orden de los vínculos presentados en las áreas
Cambiar los nombres de los vínculos de un área
Agrupar vínculos en áreas
Cambiar las opciones del perfil del área de trabajo que pueden seleccionar los usuarios

Para realizar estas personalizaciones, los requisitos son tener los privilegios necesarios para exportar e importar personalizaciones.

Se puede encontrar información adicional relacionada con esta tarea en el SDK de Microsoft Dynamics CRM Online.

En esta página

Recuperación de errores

Información general del esquema del mapa del sitio

Editar el mapa del sitio

Usar la validación de esquema

Tareas

Resumen

En el Panel de navegación, haga clic en Configuración, en Personalización y, a continuación, en Exportar personalizaciones.
En la lista desplegable Vista, seleccione Extensiones de cliente.
Seleccione Mapa del sitio.
Haga clic en Exportar personalizaciones seleccionadas y, a continuación, en Aceptar para cerrar el aviso sobre la información que se puede exportar.
En el cuadro de diálogo Descarga de archivos, haga clic en Guardar y guarde el archivo customizations.zip en la ubicación que elija.
Haga clic en Cerrar para cerrar el cuadro de diálogo Descarga completa.

Después de modificar el contenido XML del Mapa del sitio, importe el customizations.xml modificado que contiene el Mapa del sitio para aplicar los cambios.

Importar el mapa del sitio

En el Panel de navegación, haga clic en Configuración, en Personalización y, a continuación, en Importar personalizaciones.
Haga clic en Examinar para localizar un archivo XML o un archivo comprimido (.zip) que contenga las personalizaciones y configuraciones exportadas desde Microsoft Dynamics CRM Online.
En el cuadro de diálogo Elegir archivo, haga doble clic en el archivo o seleccione el archivo y haga clic en Abrir.
Haga clic en Cargar.
Si después de procesar el archivo, el Mapa del sitio no se puede procesar correctamente, aparecerá un cuadro de diálogo que muestra los mensajes de error.

ARRIBA

Recuperación de errores

Si importa un archivo customizations.xml que contiene un Mapa del sitio incorrecto, Microsoft Dynamics CRM Online recurrirá al Mapa del sitio predeterminado y mostrará un mensaje que indica que hay un error en el Mapa del sitio personalizado. En este caso, debe navegar hasta el área Importar personalizaciones e importar el archivo de copia de seguridad de customizations.xml que contiene un Mapa del sitio correcto.

El peor escenario posible

Hay una pequeña posibilidad de que el error pueda causar que el Panel de navegación no se represente correctamente y que sea imposible navegar hasta el área Importar personalizaciones para solucionar el problema. Puede prepararse para esto si sabe que puede tener acceso al área Importar personalizaciones directamente.

Para tener acceso directo al área Importar personalizaciones, escriba la siguiente dirección URL en el campo de dirección de Internet Explorer:

https://<nombreDeOrganización>.crm.dynamics.com/tools/systemcustomization/ImportCustomizations/importCustomizations.aspx

Busque la copia de seguridad del archivo XML exportado. Cargue e importe este archivo de copia de seguridad para volver al estado de trabajo original. A continuación, puede volver a usar el Panel de navegación.

Importante

Siempre es una buena idea disponer de una copia de seguridad de un archivo customizations.xml de trabajo conocido que contenga un Mapa del sitio válido. El archivo customizations.zip que se exportó ofrece esto; asegúrese de tenerlo a mano.

ARRIBA

Información general del esquema del mapa del sitio

Para poder editar el Mapa del sitio, debe conocer la estructura del XML. Abra el archivo customizations.xml que se encuentra en Internet Explorer para revisar la estructura del contenido XML. Este archivo representa un customizations.xml que incluye el Mapa del sitio predeterminado. Es posible que desee revisar este archivo para comprender mejor el esquema del Mapa del sitio.

Como cualquier documento XML válido, el Mapa del sitio debe tener una estructura específica. El Mapa del sitio usa un esquema XML, que es un archivo XML que define la estructura y usa la extensión de archivo .xsd. El esquema del Mapa del sitio se define en un archivo denominado SiteMapType.xsd.

Cuando se ve en Microsoft Visual Studio, la vista gráfica del esquema tiene esta apariencia:

SiteMapType.xsd

Hay tres elementos principales en el Mapa del sitio.

Área

El elemento Área controla las secciones principales visibles en la parte inferior del Panel de navegación. Las áreas Área predeterminadas son Área de trabajo, Ventas, Marketing, Servicio, Configuración y Centro de recursos.

Grupo

El elemento Grupo es un elemento secundario del elemento Área. El elemento Grupo proporciona divisiones en las que se agrupan los elementos Subárea de la parte superior. La mayoría de los elementos Área no usan Grupo de forma predeterminada. La excepción es el Área de trabajo. El Área de trabajo tiene seis grupos predeterminados: Mi área de trabajo, Clientes, Ventas, Marketing, Servicio y Programación.

El Área de trabajo también es única porque los grupos presentes se pueden configurar como opcionales. Los usuarios pueden seleccionar los grupos que verán en el Área de trabajo si hacen clic en el vínculo Personalizar área de trabajo que se encuentra en la parte inferior de Área de trabajo.

Subárea

El elemento Subárea ofrece vínculos en los que se puede hacer clic y que cambian el contenido que aparece en el recuadro principal de la aplicación. De forma predeterminada, la mayoría de los vínculos del Panel de navegación apuntan a páginas de la aplicación de Microsoft Dynamics CRM Online. Una excepción es el Centro de recursos, que crea vínculos a páginas de Internet.

Además, hay cinco elementos secundarios:

Títulos y Título

Mediante los elementos Títulos y Título puede controlar los Títulos de texto localizado que se van a agregar en diferentes idiomas. El elemento Títulos contiene simplemente uno o más elementos Título. Si desea volver a asignar un nombre a un Área, Grupo o Subárea existentes, defina los Títulos en el idioma deseado. Use el mismo método para agregar títulos a nuevos elementos. Los idiomas se identifican mediante el atributo de identificador de configuración regional (LCID), un número de cuatro dígitos. Por ejemplo, el LCID para inglés de los Estados Unidos es 1033. Puede buscar valores de LCID válidos para otros idiomas en el gráfico de identificadores de configuración regional (LCID).

Nota

Ya que Microsoft Dynamics CRM Online es compatible con una interfaz de usuario multilingüe, es posible que el texto de título que aparece para los elementos Área, Grupo y Subárea tenga que presentarse en diferentes idiomas para distintos usuarios. La funcionalidad multilingüe de Microsoft Dynamics CRM Online se administra mediante recursos internos designados por los atributos ResourceId en los elementos Área, Grupoy Subárea. Por lo tanto, el Mapa del sitio predeterminado no usa ningún elemento Títulos o Título, y no deben usarse los atributos ResourceId para las personalizaciones.

Descripciones y Descripción

Se pueden agregar Descripciones a los elementos Área, Grupo y Subárea. Las descripciones sólo aparecen en Microsoft Dynamics CRM Online para Microsoft Office Outlook.

El elemento Descripciones contiene uno o más elementos Descripción. Cada Descripción contiene atributos para asignar un LCID y el texto de la descripción.

Privilegio

El elemento Privilegio es un elemento secundario del elemento Subárea. Este elemento define privilegios específicos necesarios para ver la Subárea. Puede usarlo si crea una Subárea que apunte a una página que requiera privilegios especiales para su visualización.

Los elementos Privilegio se definen como el nombre de una entidad y una lista de valores separados por comas que representan acciones.

El siguiente ejemplo es un Privilegio. El elemento Privilegio evita que los usuarios (que no tienen permisos para leer, escribir y crear artículos en Knowledge Base) puedan ver la Subárea.

<SubArea Id="nav_managekb"

ResourceId="Homepage_KBManager"

Icon="/_imgs/ico_18_126.gif"

Url="/cs/home_managekb.aspx"

Client="Web">

<Privilege Entity="kbarticle"

Privilege="Read,Write,Create"/>

</SubArea>

ARRIBA

Editar el mapa del sitio

Al exportar, el Mapa del sitio está en un archivo comprimido denominado customizations.zip. De este archivo se extrae el archivo customizations.xml que contiene el Mapa del sitio.

Los elementos y atributos válidos que se usan para el Mapa del sitio están totalmente documentados en el Microsoft Dynamics CRM Online Software Development Kit (Kit de desarrollo de software de Microsoft Dynamics CRM Online). Vea el mapa del sitio (SDK de Microsoft Dynamics CRM Online).

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 XML Notepad 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.

XML Notepad 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 Online. 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.

ARRIBA

Usar la validación de esquema

El Mapa del sitio es sólo uno de los elementos que se pueden exportar en el archivo customizations.xml. Para editar el archivo customizations.xml con la validación de esquema, necesita un esquema que represente todos los contenidos posibles del archivo customizations.xml. La definición del esquema XML (XSD) para el archivo customizations.xml es el archivo customizations.xsd. El esquema customizations.xsd incluye una referencia al archivo SiteMapType.xsd, así como al archivo isv.config.xsd.

Esto permite que el archivo customizations.xsd proporcione un esquema para todas las personalizaciones que se exportan desde Microsoft Dynamics CRM Online. No obstante, la forma en que customizations.xsd hace referencia a SiteMapType.xsd en la carpeta _root implica varios pasos adicionales para poder usarlo en la validación XML.

Por motivos prácticos, este artículo proporciona una versión modificada del archivo customizations.xsd denominada ISVConfigAndSiteMap.xsd . El archivo ISVConfigAndSiteMap.xsd simplemente consolida los archivos customizations.xsd, SiteMapType.xsd e Isv.config.xsd en un solo archivo. Además, elimina algunas referencias a atributos del elemento Mapa del sitio que son obsoletas para Microsoft Dynamics CRM.

Al usar Microsoft Visual Web Developer 2008 Express Edition (u otras ediciones de Microsoft Visual Studio), puede vincular un archivo customizations.xml exportado al archivo ISVConfigAndSiteMap.xsd para obtener IntelliSense, que le ayudará a comprender los elementos de esquema válidos y a evitar errores. No es necesario, pero facilita el trabajo de modificación del XML.

Para empezar a editar los archivos:

Exporte el Mapa del sitio y extraiga el archivo customizations.xml del archivo customizations.zip.
Importante

Recuerde que debe conservar el archivo customizations.zip como copia de seguridad.

Descargue el archivo ISVConfigAndSiteMap.zip, extraiga el archivo ISVConfigAndSiteMap.xsd y colóquelo en la misma carpeta que el archivo customizations.xml.

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.

Abra Microsoft Visual Web Developer 2008 Express Edition y, en el menú Archivo, seleccione Abrir archivo....
En el cuadro de diálogo Abrir archivo, seleccione el archivo customizations.xml y haga clic en Abrir.
En el menú Vista, seleccione Ventana Propiedades.
En el área Propiedades, seleccione el cuadro Esquemas y escriba ISVConfigAndSiteMap.xsd. A continuación, presione Entrar.
Busque el área Centro de recursos en el customizations.xml y coloque el cursor después de la etiqueta de cierre de Área: "</Area>".
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.
Escriba A para seleccionar el elemento Área y presione Entrar.
Presione la barra espaciadora para agregar un espacio.
Debe ver una lista de los atributos válidos para el elemento Área.
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.
Para conocer los errores del esquema, coloque el cursor sobre el texto subrayado en rojo.

Ambos errores indican que la etiqueta Área 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>
Continúe con la definición de los elementos. Use la información del mapa del sitio (SDK de Microsoft Dynamics CRM) y la validación de esquema de IntelliSense para definir la apariencia y el comportamiento de los elementos.
Guarde los cambios cuando haya terminado e importe el archivo customizations.xml.

Editar el archivo customizations.xml mediante XML Notepad 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 XML Notepad 2007 usa una vista de árbol y una interfaz gráfica de usuario (GUI) para proporcionar la estructura para la edición de documentos XML.

Abra XML Notepad 2007 y, en el menú Archivo, seleccione Abrir.
En el cuadro de diálogo Abrir, seleccione el archivo customizations.xml y haga clic en Abrir.
En el menú Vista, seleccione Esquemas....
En el cuadro de diálogo Esquemas XML, en el menú Archivo, seleccione Agregar esquemas....
En el cuadro de diálogo Abrir, busque el archivo ISVConfigAndSiteMap.xsd y selecciónelo. A continuación, haga clic en Abrir.
Haga clic en Aceptar para cerrar el cuadro diálogo Esquemas XML.
En la ficha Vista de árbol, expanda el nodo Mapa del sitio y seleccione el último elemento Área.
Haga clic con el botón secundario en el nodo Área y seleccione Elemento>Después en el menú contextual.
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.

Para agregar un atributo, haga clic con el botón secundario en el elemento Área creado y seleccione Atributo>Secundario en el menú contextual.
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. XML Notepad 2007 proporciona estas opciones.
- El área Lista de errores indica que el atributo 'Id' no es válido, que el valor no es válido según el tipo de datos de 'CRM_Identifier_SiteMap' y que hubo un error en la restricción de Pattern. Esto indica que un elemento Área válido debe tener un atributo Id.
Escriba un valor único para el valor del atributo Id de Área.
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).
Guarde los cambios e importe el archivo customizations.xml para ver los cambios.

ARRIBA

Tareas

Hay algunas tareas que puede realizar mediante la configuración del Mapa del sitio.

Cambiar el nombre de las áreas en el Panel de navegación

Si desea cambiar el nombre del Área Servicios de "Service" a "Support" en el idioma inglés:

Cambie esto:

<Area Id="CS" ResourceId="Area_Service" Icon="/_imgs/services_24x24.gif"

DescriptionResourceId="Customer_Service_Description">

A esto:

<Area Id="CS" ResourceId="Area_Service" Icon="/_imgs/services_24x24.gif"

DescriptionResourceId="Customer_Service_Description">

</Titles>

No es necesario que elimine el atributo ResourceId. Agregar el elemento Títulos lo invalidará.

Cambiar el orden de las áreas en el Panel de navegación

Esto es simplemente cuestión de manipular el orden en el que se incluyen las áreas del Mapa del sitio en el archivo customizations.xml.

Reorganizar o agregar nuevas Áreas

Los elementos Subárea se pueden copiar y pegar en áreas diferentes para conseguir una organización distinta.

Por lo general, crear nuevas áreas es cuestión de copiar un Área existente y realizar modificaciones.

Importante

Tenga en cuenta que cada elemento principal debe tener un valor de atributo Id único. Si copia una Subárea desde un Área y la pega en otra, debe asignarle un valor de atributo Id único y diferente si la otra Subárea aún existe.

Cambiar el orden de los vínculos en las Áreas

Puede cambiar el orden en el que los elementos Subárea aparecen en las Áreas.

Cambiar los nombres de los vínculos en un Área

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

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

<SubArea Id="nav_apptbook" ResourceId="Homepage_AppointmentBook"

DescriptionResourceId="AppointmentBook_SubArea_Description"

Icon="/_imgs/ico_18_servicecal.gif" Url="/sm/home_apptbook.aspx"

AvailableOffline="false">

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

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

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

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

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

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

ARRIBA

Resumen

En este artículo se ha presentado el Mapa del sitio y cómo usarlo para personalizar el Panel de navegación de Microsoft Dynamics CRM Online. Si no ha editado hasta ahora un archivo de configuración XML, usar las herramientas correctas que proporcionan una validación de esquema y comprender la estructura del esquema puede ser útil para que la primera vez que lo intente lo haga correctamente.

ARRIBA