Share via


Resolver errores y advertencias al ver una página en SharePoint

Después de convertir un archivo HTML en una página maestra de SharePoint, o después de crear un diseño de página, puede obtener una vista previa de esa página en el navegador. Pero antes de que puede obtener una vista previa de una página maestra o un diseño de página, puede que tenga que resolver los problemas que impiden la representación de la página de la vista previa del lado servidor.

Introducción a la resolución de errores de vista previa

Después de convertir un archivo HTML en una página maestra de SharePoint, o después de crear un diseño de página, puede obtener una vista previa de esa página en el navegador. Al editar y guardar la página principal de HTML o el diseño de página, puede actualizar la vista previa para ver exactamente cómo representa SharePoint la página.

La vista previa del Administrador de diseño es una vista previa en directo del lado del servidor, por lo que los fragmentos de código o controles de la página, como un control de navegación o un elemento web controlado por búsquedas, usan datos en directo. Además, al obtener una vista previa de una página principal o un diseño de página, puede elegir una vista previa genérica solo de ese archivo o de cómo se representa una página específica del sitio con esa página principal o diseño de página. La vista previa del lado servidor es una herramienta muy útil que complementa la vista previa en tiempo de diseño en un editor HTML. Para obtener más información, vea Cómo: Cambiar la página de vista previa en el Administrador de diseño de SharePoint.

Pero antes de que puede obtener una vista previa de una página maestra o un diseño de página, puede que tenga que resolver los problemas que impiden la representación de la página de la vista previa del lado servidor. Si la vista previa del lado servidor no funciona, significa que la página principal o el diseño de página tampoco funcionarán después de aplicarse al sitio. En el Administrador de diseño, después de convertir una página principal o crear un diseño de página, puede hacer clic en el nombre de archivo o el estado de conversión para obtener una vista previa de ese archivo. En la página de vista previa, el área de notificación de la parte superior de la página muestra los errores o advertencias.

Estos son los errores y advertencias de la vista previa que puede encontrar y ayuda para resolverlos.

El archivo HTML no puede contener etiquetas de <formulario>

Message

La página maestra tiene una o varias etiquetas HTML <FORM> . Para que la página maestra funcione, quite las etiquetas (pero puede dejar el contenido en ellas).

Solución

Las páginas de SharePoint ya están encapsuladas en una <etiqueta de formulario> para que ASP.NET puedan realizar copias posteriores (en concreto, una página de SharePoint.master contiene la <etiqueta SharePoint:SharePointForm> que crea una etiqueta de formulario> real< cuando se representa una página de contenido asociada). Por lo tanto, incluir una <etiqueta de formulario> en la página maestra o el diseño de página significa que habría etiquetas de formulario> anidadas< en la representación final de la página, que no es válida en HTML. En el editor HTML, elimine las <etiquetas de formulario> , guarde la página y actualice la vista previa.

Si desea una etiqueta de formulario> HTML< en el diseño de página, debe colocar el formulario en un marcador de posición de contenido con el identificador PlaceHolderUtilityContent agregando este código al diseño de página HTML:

<!--CS: Start Create Snippets From Custom ASP.NET Markup Snippet-->
<!--SPM:<SharePoint:AjaxDelta id="DeltaPlaceHolderUtilityContent" runat="server">-->
<!--SPM:<asp:ContentPlaceHolder id="PlaceHolderUtilityContent" runat="server" />-->
<!--SPM:</SharePoint:AjaxDelta>-->
<!--CE: End Create Snippets From Custom ASP.NET Markup Snippet-->

También puede agregar el elemento web Formulario de HTML o el elemento web Formulario de InfoPath a la página desde la Galería de fragmentos. Para más información, vea SharePoint Design Manager snippets (Fragmentos de código del Administrador de diseño de SharePoint).

El archivo HTML debe ser compatible con XML

Mensaje

SharePoint requiere que los archivos HTML sean compatibles con XML. El archivo no es compatible con XML, probablemente debido a propiedades de etiqueta sin comillas, falta etiquetas de cierre o propiedades no válidas en etiquetas. {Tipo de error, ubicación del error}. Se produjo en: {Time}.

Resolución

Para que un archivo HTML se convierta en el archivo ASP.NET correspondiente, el archivo HTML debe ser compatible con XML. Este error identifica la revisión específica en el archivo HTML que no es compatible con XML. Ejecute el archivo HTML mediante un validador de XML, corrija cualquier problema en el editor de HTML, guarde el archivo y, a continuación, actualice la vista previa.

Nota:

Este requisito invalida algunos estándares HTML 5. Por ejemplo, en HTML 5 puede especificar el doctype en minúsculas, pero en XML el doctype debe estar en mayúsculas.

El archivo HTML contiene una revisión problemática

Mensaje

SharePoint no puede analizar este archivo, lo más probable es que se deba a un fragmento de código de SharePoint con formato incorrecto. El marcado en la siguiente ubicación está causando problemas. Edite el marcado manualmente para corregirlo o reemplácelo por un nuevo fragmento de código de la Galería de fragmentos de código. {Tipo de error, ubicación del error}. Se produjo en: {Time}.

Resolución

Verá este error cuando hay un problema con un fragmento de código de SharePoint en el archivo HTML. Para corregir este error, deshaga cualquier cambio que haya causado el error o reemplace el fragmento problemático por uno nuevo, ya sea desde la Galería de fragmentos de código o desde otra página principal o archivo de diseño de página que tenga una versión funcional del fragmento de código. En el editor de HTML, después de corregir o reemplazar el fragmento de código, guarde la página y, a continuación, actualice la vista previa.## La página principal de un diseño de página ha cambiado

Mensaje

La página maestra de este diseño de página ha cambiado, lo que provocará incoherencias en todo el sitio. Haga clic aquí para actualizar las secciones del diseño de página que representan las regiones de página maestra.

Resolución

Para que un diseño de página funcione con una página principal determinada, los dos deben tener el mismo conjunto de marcadores de posición de contenido. Si crea un diseño de página basado en una página principal determinada y, a continuación, edita esa página principal en HTML, verá este mensaje. Incluso si sabe que los cambios en la página principal no agregaron ni quitaron marcadores de posición de contenido, debe actualizar las regiones de contenido del diseño de página de todos modos para que pueda obtener una vista previa de los cambios de la página principal que puedan afectar al diseño de página.

Restablecer la vista previa

Mensaje

La página maestra (diseño de página) no tiene advertencias ni errores. Restablezca la vista previa a su estado original.

Explicación

Este mensaje simplemente confirma que el proceso de conversión ha funcionado sin errores ni problemas. Sin embargo, al obtener una vista previa de una página, puede salir de esa página específica o cambiar la vista previa de alguna otra manera. Si esto sucede, siempre puede elegir Restablecer la vista previa en el área de mensajes. Al hacerlo, se actualiza la vista previa para que use la página principal específica o el diseño de página en el que está trabajando, y cualquier página que haya seleccionado en la opción Cambiar página de vista previa en la esquina superior izquierda.

Cambiar la página de vista previa

Mensaje

Actualmente está realizando una vista previa de la página maestra (diseño de página) sin ningún contenido. Puede cambiar la página que está viendo en vista previa desde el menú anterior.

Explicación

Verá este mensaje cuando no use una página de SharePoint en directo con la que obtener una vista previa de la página principal o el diseño de página. Por ejemplo, si va a obtener una vista previa de un diseño de página, puede elegir Cambiar página de vista previa en la esquina superior izquierda y, a continuación, seleccionar una página de contenido específica para obtener una vista previa con el diseño de página. De este modo, puede obtener una vista previa del diseño de página con el contenido real de la página en los campos. Si desea que la vista previa muestre solo las posiciones de ContentPlaceHolderMain o los campos de la página, siempre puede usar Cambiar página de vista previa para volver a una vista previa genérica.

Consulte también