Editar el mapa del sitio

  • Artículo

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Puede editar mapas del sitio predeterminados o específicos de la aplicación de cualquiera de las siguientes maneras:

  • Usando el nuevo diseñador SiteMap introducido en Actualización de diciembre de 2016 para Dynamics 365 (online y local) o un editor de mapa del sitio de terceros si usa una versión anterior de Microsoft Dynamics 365.

  • Actualizando mediante programación el registro de entidad SiteMap para actualizar el XML del atributo SiteMap.SiteMapXml.

  • Editando manualmente el XML del nodo SiteMap en el archivo customizations.xml de una solución no administrada exportada y después importando la solución como administrada o no administrada.

En este tema

Uso de editores de mapas del sitio

Actualizar mediante programación el mapa del sitio

Edición manual del mapa del sitio

Edición con la validación de esquema

Codifique el carácter de la y comercial

Recuperación de errores

Uso de editores de mapas del sitio

Si usa Actualización de diciembre de 2016 para Dynamics 365 (online y local), use el nuevo diseñador del mapa del sitio para crear y administrar mapas del sitio.Más información:Cree un mapa del sitio para la aplicación

De lo contrario, puede usar uno de los editores de mapas del sitio de terceros para editar el mapa del sitio predeterminado. Conforme se introducen mapas del sitio específicas de la aplicación en Actualización de diciembre de 2016 para Dynamics 365 (online y local), los editores de mapas del sitio de terceros podrían no funcionar correctamente para editar los mapas del sitio para aplicaciones de negocio. Un editor de mapas del sitio popular se incluyen en el Cuadro de herramientas para Dynamics CRM 2011/2013 publicado por Microsoft Dynamics 365 MVP Tanguy Touzard.

Si bien estas aplicaciones simplifican el proceso de editar el mapa del sitio, sigue siendo necesario tener un cierto conocimiento del esquema XML del mapa del sitio. Para obtener más información, vea SiteMap XML reference.

Nota

El soporte técnico de Microsoft Dynamics 365 no presta soporte para aplicaciones de terceros. Si tiene preguntas acerca de estas aplicaciones, póngase en contacto con el editor de las mismas.

Actualizar mediante programación el mapa del sitio

Recupere el registro de entidad SiteMap que desee actualizar y luego actualice el XML en el atributo SiteMap.SiteMapXml del registro. Asegúrese de que conoce el esquema XML del mapa del sitio antes de editar el XML. Para obtener más información, vea SiteMap XML reference.

Cuando se actualiza un registro de SiteMap mediante programación usando el método Update, el XML del mapa del sitio que especifique sobrescribirá el XML existente en el atributo SiteMap.SiteMapXml del registro.

Nota

  • También puede crear y eliminar mediante programación registros de SiteMap específicos de la aplicación. Para crear un registro SiteMap específico de la aplicación, debe especificar valores para los siguientes atributos como mínimo: SiteMap.SiteMapNameUnique y SiteMap.SiteMapXml. Sin embargo, se recomienda que en lugar de crear y eliminar mediante programación mapas del sitio específicos de la aplicación, debe usar el nuevo diseñador SiteMap para crear y eliminar mapas del sitio específicos de la aplicación.Más información:Cree un mapa del sitio para la aplicación

  • No puede crear y eliminar mediante programación el registro SiteMap predeterminado. Puede usar el atributo SiteMap.IsAppAware para distinguir entre los dos tipos mapas del sitio: 0 indica el mapa del sitio predeterminado; 1 indica el mapa del sitio específico de la aplicación.

Edición manual del mapa del sitio

Puede editar manualmente el nodo SiteMap en el archivo customizations.xml de una solución no administrada exportada y después importarlo de nuevo en Dynamics 365 para actualizar el mapa del sitio. En función si importa una solución no administrada o administrada se decidirá cómo se actualiza el registro SiteMap.

  • Al importar una solución no administrada se sobrescribe el XML del mapa del sitio existente en el registro de SiteMap.

  • Cuando se importa una solución administrada se crea un nuevo registro de SiteMap con los últimos cambios, y el valor de atributo SiteMap.OverwriteTime de registro de SiteMap más reciente/activo se establece con el valor predeterminado del campo DateTime (1900-01-01 00:00:00.000). El valor de atributo SiteMap.OverwriteTime del registro SiteMap existente se establece en el valor datetime cuando se actualizó.

Para editar el mapa del sitio

  1. Haga clic en Configuración, luego en Personalización y, por último, en Soluciones.

  2. Agregue mapas del sitio predeterminados o específicos de la aplicación a una solución nueva o existente no administrada. En la solución, seleccione Extensiones de cliente en la lista Componentes de la izquierda. Seleccione Agregar existente y, a continuación, seleccione Mapa del sitio. En la lista de mapas del sitio:

    • Para agregar el mapa del sitio predeterminado, seleccione Site Map.

    • Para agregar un mapa del sitio específico de la aplicación, seleccione un mapa del sitio de la aplicación de negocio personalizado. El cuadro de diálogo muestra mapas del sitio para todas las aplicaciones de negocio personalizadas a las que tiene acceso. Por ejemplo, en este caso, puede seleccionar Contoso Sales App o Contoso Service App.

      Select default or app-specific site map to add

      Nota

      Los mapas del sitio específicos de la aplicación se muestran únicamente si tiene Actualización de diciembre de 2016 para Dynamics 365 (online y local) o posterior y tiene aplicaciones de negocio personalizadas en la instancia de Dynamics 365. También puede seleccionar varios mapas del sitio específicos de la aplicación y el mapa del sitio predeterminado que se agregarán a la misma solución.

    • Haga clic en Aceptar en la pantalla Seleccionar componentes de la solución.

  3. Haga clic en Guardar para guardar los cambios en la solución.

  4. Haga clic en Exportar solución y siga los pasos del asistente para la exportación de la solución para exportar la solución.

  5. Una vez exportada la solución, extraiga los archivos del archivo comprimido .zip.

    Sugerencia

    Conserve el archivo .zip comprimido como copia de seguridad.

  6. En el archivo customizations.xml, localice:

    • El nodoSiteMap en ImportExportXml/SiteMap para editar el mapa del sitio predeterminado.

    • El nodoSiteMap en ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap para editar el mapa del sitio específico de la aplicación.

      Sugerencia

      Si ha agregado varios mapas del sitio específicos de la aplicación en una solución antes de exportar la solución, puede usar los nodos SiteMapUniqueName y SiteMapName en ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap para determinar el nodo SiteMap en el archivo customizations.xml que debe editar para el mapa del sitio de la aplicación.

  7. Edite el nodo SiteMap si es necesario.

    Nota

    La edición del código XML es mucho más fácil si usa un editor que proporciona la validación de esquema. Para obtener más información, vea Edición con la validación de esquema.

  8. Cree un nuevo archivo .zip comprimido que incluya los archivos de la solución extraídos y el archivo customizations.xml editado.

    Sugerencia

    En el Explorador de Windows, seleccione todos los archivos. Haga clic con el botón secundario y seleccione Enviar a y Carpeta comprimida (en zip).

  9. Importe el nuevo archivo de solución.

    1. En Microsoft Dynamics 365, haga clic en Configuración, seguido de Personalización y de Soluciones.

    2. Haga clic en Importar.

    3. Haga clic en Examinar, busque el archivo .zip de la solución modificado, haga clic en Siguiente y, a continuación, en Importar.

    4. Cuando finalice la importación, haga clic en Cerrar.

  10. Publique las personalizaciones.

    Sugerencia

    Si no ve los cambios inmediatamente, actualice la página del explorador.

Edición con la validación de esquema

Para una mejor experiencia, edite el archivo customizations.xml con una aplicación que pueda usar la validación de esquema para proporcionar soporte de IntelliSense. Para obtener más información, vea Editar el archivo XML de personalizaciones con la validación de esquema.

Codifique el carácter de la y comercial

Cuando se agrega una URL al mapa del sitio que incluye el carácter de "y" comercial (&), debe codificarlo reemplazándolo con "&". La validación de XML produce error si no codifica este carácter y no podrá importar la solución. Por ejemplo:

  • Correcto:
    <SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value&amp;parameter2=value ">

  • Incorrecto:
    <SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value&parameter2=value">

Recuperación de errores

La herramienta de importación de soluciones realiza comprobaciones en el mapa del sitio. Si se producen errores, se aplica el mapa del sitio predeterminado y muestra un mensaje de error. Debe corregir los errores del mapa del sitio e importarlo de nuevo. No obstante, es posible que siga produciéndose algún error.

Algunos errores que puede encontrar al ejecutar una aplicación de negocio personalizada después de editar/importar manualmente el mapa del sitio personalizado de la aplicación de negocio son:

  • Mapa del sitio sin subárea

  • El mapa del sitio tiene subáreas, pero el usuario no tiene los privilegios para verlos

  • Entidad no válida (no es un nombre de entidad de Dynamics 365 válido)

  • URL no válida

  • El mapa del sitio tiene nodo del panel, pero ningún panel seleccionado en la definición de la aplicación de negocio modular

Ver también

Personalizar SiteMaps
Cambiar navegación de la aplicación con el mapa del sitio
Pasar parámetros a una dirección URL con el mapa del sitio
Controlar el acceso al sitio de Ayuda y entrenamiento
SiteMap XML reference
SiteMap schema

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright