Устранение ошибок и предупреждений при предварительном просмотре страницы в SharePoint
После преобразования HTML-файла в эталонную страницу SharePoint или создания макета страницы вы можете просмотреть эту страницу в браузере. Однако перед этим вам может потребоваться устранить проблемы, которые препятствуют отрисовке вашей страницы предварительного просмотра на стороне сервера.
Введение в устранение ошибок предварительного просмотра
После преобразования HTML-файла в эталонную страницу SharePoint или создания макета страницы вы можете просмотреть эту страницу в браузере. По мере редактирования и сохранения HTML эталонной страницы или макета страницы можно обновить предварительный просмотр, чтобы увидеть, как SharePoint отображает вашу страницу.
Предварительный просмотр в Дизайнере — это предварительный просмотр на стороне сервера, поэтому любые фрагменты или элементы управления на вашей странице, такие как элемент навигации или веб-часть, управляемая поиском, используют оперативные данные. Кроме того, при предварительном просмотре эталонной страницы или макета страницы можно выбрать универсальный предварительный просмотр только этого файла или выбрать предварительный просмотр отображения определенной страницы на сайте с помощью этой эталонной страницы или макета страницы. Предварительная версия на стороне сервера — очень полезный инструмент, который дополняет предварительный просмотр во время разработки в редакторе HTML. Дополнительные сведения см. в разделе Практическое руководство. Изменение страницы предварительного просмотра в SharePoint Design Manager.
Однако перед этим вам может потребоваться устранить проблемы, которые препятствуют отрисовке вашей страницы предварительного просмотра на стороне сервера. Если предварительный просмотр на стороне сервера не работает, это означает, что эталонная страница или макет страницы также не будут работать после их применения к сайту. В Дизайнере после преобразования эталонной страницы или создания макета страницы можно щелкнуть имя файла или состояние преобразования, чтобы просмотреть этот файл. На странице предварительного просмотра в области состояния в верхней части страницы отображаются все ошибки или предупреждения.
Вот ошибки предварительного просмотра и предупреждения, с которыми вы можете столкнуться, а также справка по их устранению.
HTML-файл не может содержать <теги форм>
Сообщение
Главная страница содержит один или несколько тегов HTML-ФОРМЫ<>. Чтобы главная страница работала, удалите теги (но вы можете оставить содержимое в них).
Решение
Страницы SharePoint уже упакованы в <тег формы> , чтобы ASP.NET могли выполнять обратную передачу (в частности, страница SharePoint.master содержит <тег SharePoint:SharePointForm> , который создает фактический <тег формы> при отрисовке связанной страницы содержимого). Таким образом, включение тега <формы> на главную страницу или макет страницы означает, что в окончательной отрисовке страницы будут вложены <теги формы> , что недопустимо в HTML. В редакторе HTML удалите все <теги форм> , сохраните страницу и обновите предварительный просмотр.
Если вам нужен тег формы> HTML< в макете страницы, следует поместить форму в заполнитель содержимого с идентификатором PlaceHolderUtilityContent, добавив следующий код в макет 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-->
Вы также можете добавить веб-часть формы HTML или веб-часть формы InfoPath на страницу из коллекции фрагментов кода. Дополнительные сведения см. в статье Фрагменты кода в компоненте "Дизайнер" SharePoint.
HTML-файл должен быть совместимым с XML.
Сообщение
SharePoint требует, чтобы HTML-файлы соответствовали XML. Файл не соответствует XML, вероятно, из-за свойств тегов без кавычек, отсутствия закрывающих тегов или недопустимых свойств в тегах. {Тип ошибки, расположение ошибки}. Произошло в: {Time}.
Разрешение
Чтобы HTML-файл можно было преобразовать в соответствующий файл ASP.NET, HTML-файл должен быть совместим с XML. Эта ошибка указывает на определенную разметку в HTML-файле, несовместимую с XML. Запустите HTML-файл с помощью средства проверки XML, исправьте все проблемы в редакторе HTML, сохраните файл и затем обновите предварительный просмотр.
Примечание.
Это требование переопределяет некоторые стандарты HTML 5. Например, в HTML 5 можно указать тип документа в нижнем регистре, но в XML тип документа должен быть прописным регистром.
HTML-файл содержит проблемную разметку
Сообщение
SharePoint не может проанализировать этот файл, скорее всего, из-за неправильно отформатированного фрагмента SharePoint. Разметка в следующем расположении вызывает проблемы. Измените разметку вручную, чтобы исправить ее, или замените ее новым фрагментом из коллекции фрагментов. {Тип ошибки, расположение ошибки}. Произошло в: {Time}.
Разрешение
Эта ошибка возникает при проблеме с фрагментом кода SharePoint в HTML-файле. Чтобы устранить эту ошибку, отмените любое изменение, вызвавшее ошибку, или замените проблемный фрагмент новым, либо из коллекции фрагментов кода, либо из другой эталонной страницы или файла макета страницы, в котором есть рабочая версия фрагмента. В редакторе HTML после исправления или замены фрагмента сохраните страницу, а затем обновите предварительный просмотр.## Эталонная страница для макета страницы была изменена
Сообщение
Главная страница макета этой страницы изменилась, что приведет к несоответствиям на сайте. Щелкните здесь, чтобы обновить разделы макета страницы, представляющие регионы главной страницы.
Разрешение
Чтобы макет страницы работал с заданной эталонной страницей, они должны иметь один и тот же набор заполнителей контента. Если вы создаете макет страницы на основе определенной эталонной страницы, а затем редактируете HTML эталонной страницы, вы увидите это сообщение. Даже если вы знаете, что изменения, внесенные на эталонную страницу, не добавляли и не удаляли заполнители содержимого, вам все равно следует обновить области содержимого макета страницы, чтобы вы могли предварительно просмотреть любые изменения на главной странице, которые могут повлиять на макет страницы.
Закрыть окно предварительного просмотра
Сообщение
Главная страница (макет страницы) не содержит предупреждений или ошибок. Сброс исходного состояния предварительного просмотра.
Объяснение
Это сообщение просто подтверждает, что процесс преобразования прошел без ошибок или проблем. Однако при предварительном просмотре страницы вы можете перейти с определенной страницы или изменить предварительный просмотр другим способом. В этом случае вы всегда можете выбрать Сброс предварительного просмотра в области сообщений. Это позволяет обновить предварительный просмотр, чтобы он использовал определенную эталонную страницу или макет страницы, над которыми вы работаете, а также любую страницу, выбранную в параметре Изменить страницу предварительного просмотра в левом верхнем углу.
Изменение страницы предварительного просмотра
Сообщение
В настоящее время вы просматриваете главную страницу (макет страницы) без содержимого. Вы можете изменить страницу, которую вы просматриваете, в меню выше.
Объяснение
Это сообщение вы увидите, если вы не используете страницу SharePoint, на которой можно предварительно просмотреть эталонную страницу или макет страницы. Например, при предварительном просмотре макета страницы можно выбрать Изменить страницу предварительного просмотра в левом верхнем углу, а затем выбрать определенную страницу содержимого для предварительного просмотра с макетом страницы. Таким образом можно просмотреть макет страницы с фактическим содержимым страницы в полях страницы. Если вы хотите, чтобы в предварительном просмотре отображались только позиции ContentPlaceHolderMain или страницы полей, вы всегда можете использовать Изменить страницу предварительного просмотра, чтобы вернуться к универсальному предварительному просмотру.