Beheben von Fehlern und Warnungen bei der Vorschau einer Seite in SharePoint
Nach dem Konvertieren einer HTML-Datei in eine SharePoint-Gestaltungsvorlage oder nach dem Erstellen eines Seitenlayouts können Sie eine Vorschau dieser Seite im Browser anzeigen. Bevor Sie eine Gestaltungsvorlage oder ein Seitenlayout in der Vorschau anzeigen können, müssen Sie jedoch alle Probleme beheben, die das Rendern der Seite in der serverseitigen Vorschau verhindern.
Einführung in das Beheben von Fehlern der Vorschau
Nach dem Konvertieren einer HTML-Datei in eine SharePoint-Gestaltungsvorlage oder nach dem Erstellen eines Seitenlayouts können Sie eine Vorschau dieser Seite im Browser anzeigen. Beim Bearbeiten und Speichern Ihrer HTML-Gestaltungsvorlage oder Ihres Seitenlayouts können Sie die Vorschau aktualisieren, um genau zu sehen, wie SharePoint die Seite rendert.
Die Vorschau im Entwurfs-Manager ist eine serverseitige Livevorschau, sodass alle Codeausschnitte oder Steuerelemente auf Ihrer Seite, z. B. ein Navigationssteuerelement oder ein suchgesteuertes Webpart, Livedaten verwenden. Wenn Sie eine Vorschau einer Gestaltungsvorlage oder eines Seitenlayouts anzeigen, können Sie auch nur eine generische Vorschau dieser Datei auswählen oder eine Vorschau anzeigen, wie eine bestimmte Seite in Ihrer Website mit dieser Gestaltungsvorlage oder dem Seitenlayout gerendert wird. Die serverseitige Vorschau ist ein äußerst nützliches Tool, das die Entwurfszeitvorschau in einem HTML-Editor ergänzt. Weitere Informationen finden Sie unter Vorgehensweise: Ändern der Vorschauseite im SharePoint-Entwurfs-Manager.
Bevor Sie eine Gestaltungsvorlage oder ein Seitenlayout in der Vorschau anzeigen können, müssen Sie jedoch alle Probleme beheben, die das Rendern der Seite in der serverseitigen Vorschau verhindern. Wenn die serverseitige Vorschau nicht funktioniert, bedeutet dies, dass die Gestaltungsvorlage oder das Seitenlayout nach der Anwendung auf Ihre Website ebenfalls nicht funktioniert. Nach dem Konvertieren einer Gestaltungsvorlage oder nach dem Erstellen eines Seitenlayouts können Sie im Entwurfs-Manager auf den Dateinamen oder den Konvertierungsstatus klicken, um eine Vorschau der Datei anzuzeigen. Im Infobereich der Vorschauseite werden etwaige Warnungen oder Fehler angezeigt.
Hier finden Sie die Fehler und Warnungen, die bei der Vorschau auftreten können, und Hilfe für deren Behebung.
HTML-Datei darf keine <form>-Tags enthalten
Message
Ihre Gestaltungsvorlage verfügt über ein oder mehrere HTML FORM-Tags<>. Damit Ihre Gestaltungsvorlage funktioniert, müssen die Tags entfernt werden (die Tag-Inhalte müssen Sie jedoch nicht entfernen).
Lösung
SharePoint-Seiten sind bereits mit einem <Formulartag> umschlossen, sodass ASP.NET Postbacks durchführen können (insbesondere enthält eine SharePoint.master-Seite das <SharePoint:SharePointForm-Tag> , das beim Rendern einer zugeordneten Inhaltsseite ein tatsächliches <Formulartag> erstellt). Somit bedeutet die Aufnahme eines <form>-Tags in Ihre Gestaltungsvorlage oder Ihr Seitenlayout, dass das endgültige Rendering der Seite geschachtelte <form>-Tags enthalten würde, was in HTML nicht zulässig ist. Löschen Sie in Ihrem HTML-Editor alle <form>-Tags, speichern Sie die Seite, und aktualisieren Sie dann die Vorschau.
Soll das Seitenlayout ein <form>-HTML-Tag enthalten, sollten Sie das Formular in einen Inhaltsplatzhalter mit der ID PlaceHolderUtilityContent einschließen. Dazu fügen Sie Ihrem HTML-Seitenlayout folgenden Code hinzu:
<!--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-->
Sie können ihrer Seite auch das HTML-Formular-Webpart oder das InfoPath-Formular-Webpart aus dem Codeausschnittkatalog hinzufügen. Weitere Informationen finden Sie unter Codeausschnitte des SharePoint-Entwurfs-Managers.
HTML-Datei muss XML-konform sein
Nachricht
Für XML-Kompatibilität benötigt SharePoint HTML-Dateien. Ihre Datei ist nicht XML-kompatibel, wahrscheinlich aufgrund von Tageigenschaften ohne Anführungszeichen, fehlenden Endtags oder ungültigen Eigenschaften in den Tags. {Art des Fehlers, Ort des Fehlers}. Aufgetreten bei: {Zeit}.
Lösung
Für die Konvertierung einer HTML-Datei in die entsprechende ASP.NET-Datei muss die HTML-Datei XML-konform sein. Dieser Fehler gibt bestimmtes Markup in der HTML-Datei an, das nicht XML-kompatibel ist. Führen Sie die HTML-Datei über eine XML-Bestätigung aus, beheben Sie etwaige Probleme mit Ihrem HTML-Editor, speichern Sie die Datei und aktualisieren Sie dann die Vorschau.
Hinweis
Diese Anforderung setzt einige HTML 5-Normen außer Kraft. Beispielsweise können Sie den Dokumenttyp (doctype) in HTML 5 in Kleinschreibung angeben, während er in XML in Großbuchstaben geschrieben sein muss.
HTML-Datei enthält problematisches Markup
Nachricht
SharePoint kann diese Datei nicht analysieren, höchstwahrscheinlich aufgrund eines falsch formatierten SharePoint-Ausschnitts. Das Markup an folgender Position verursacht Probleme. Bearbeiten Sie das Markup manuell, um es zu reparieren, oder ersetzen Sie es durch einen neuen Ausschnitt aus dem Codeausschnittkatalog. {Art des Fehlers, Ort des Fehlers}. Aufgetreten bei: {Zeit}.
Lösung
Dieser Fehler wird angezeigt, wenn ein Problem mit einem SharePoint-Ausschnitt in Ihrer HTML-Datei auftritt. Zur Behebung des Fehlers machen Sie die Änderung rückgängig, die den Fehler verursacht hat, oder ersetzen Sie den problematischen Codeausschnitt durch einen neuen, entweder aus dem Codeausschnittkatalog oder aus einer anderen Gestaltungsvorlage oder Seitenlayoutdatei, die eine funktionierende Version des Ausschnitts enthält. Nachdem Sie den Codeausschnitt in Ihrem HTML-Editor korrigiert oder ersetzt haben, speichern Sie die Seite, und aktualisieren Sie dann die Vorschau.## Die Gestaltungsvorlage für ein Seitenlayout wurde geändert.
Message
Diese Gestaltungsvorlage des Seitenlayouts hat sich geändert, was auf Ihrer Website zu Inkonsistenzen führt. Klicken Sie hier, um die Bereiche Ihres Seitenlayouts zu ändern, die Bereiche der Gestaltungsvorlage repräsentieren.
Lösung
Damit ein Seitenlayout mit einer bestimmten Gestaltungsvorlage funktioniert, müssen beide den gleichen Satz von Inhaltsplatzhaltern enthalten. Wenn Sie ein Seitenlayout basierend auf einer bestimmten Gestaltungsvorlage erstellen und dann diese HTML-Gestaltungsvorlage bearbeiten, wird diese Meldung angezeigt. Auch wenn Sie wissen, dass durch Änderungen an der Gestaltungsvorlage keine Inhaltsplatzhalter hinzugefügt oder entfernt wurden, sollten Sie die Inhaltsbereiche des Seitenlayouts aktualisieren, um eine Vorschau aller Änderungen der Gestaltungsvorlage anzuzeigen, die sich auf das Seitenlayout auswirken.
Zurücksetzen der Vorschau
Nachricht
Bei Ihrer Gestaltungsvorlage (Ihrem Seitenlayout) sind keine Warnungen oder Fehler vorhanden. Setzen Sie die Vorschau auf den ursprünglichen Zustand zurück.
Erklärung
Diese Meldung bestätigt lediglich, dass der Konvertierungsprozess ohne Fehler oder Probleme funktioniert hat. Wenn Sie jedoch eine Seite in der Vorschau anzeigen, können Sie von dieser bestimmten Seite weg navigieren oder die Vorschau auf andere Weise ändern. In diesem Fall können Sie im Nachrichtenbereich immer Vorschau zurücksetzen auswählen. Dadurch wird die Vorschau aktualisiert, sodass sie die jeweilige Gestaltungsvorlage oder das Seitenlayout verwendet, an der Sie arbeiten, und die Seite, die Sie in der Option Vorschauseite ändern in der oberen linken Ecke ausgewählt haben.
Ändern der Vorschauseite
Nachricht
In der Vorschau wird derzeit die Gestaltungsvorlage (das Seitenlayout) ohne Inhalt angezeigt. Über das Menü oben können Sie die Seite in der Vorschau ändern.
Erklärung
Diese Meldung wird angezeigt, wenn Sie keine SharePoint-Liveseite verwenden, mit der Sie eine Vorschau Ihrer Gestaltungsvorlage oder Ihres Seitenlayouts anzeigen können. Wenn Sie z. B. ein Seitenlayout in der Vorschau anzeigen, können Sie in der linken oberen Ecke auf Vorschau-Seite ändern klicken und dann eine bestimmte Inhaltsseite für die Vorschau mit dem Seitenlayout auswählen. So können Sie das Seitenlayout mit tatsächlichem Seiteninhalt in den Seitenfeldern anzeigen. Wenn die Vorschau nur die Positionen von ContentPlaceHolderMain oder Seitenfeldern anzeigen soll, können Sie mit Vorschau-Seite ändern jederzeit wieder in eine generische Vorschau wechseln.