Schwerpunkt DienstprogrammeWeb Page Error Toolkit

Lance Whitney

Inhalt

Anforderungen
Herunterladen und Installieren
Einrichten des Webservers
Einrichten der web.config-Datei
Anpassen der ErrorPage-Datei
Arbeiten in IIS

Die meisten von uns, die als Webmaster, IT-Administrator oder gewöhnliche Surfer im Web arbeiten, sind wahrscheinlich mit der gefürchteten 404-Fehlerseite vertraut. Dieser Fehler taucht auf, wenn die gewünschte Webseite nicht gefunden werden kann, und zwar aus verschiedenen Gründen, einschließlich fehlerhafter Links, einer fehlenden Seite und einer falsch buchstabierten URL. Aber 404-Fehlerseiten sind nicht sehr hilfreich. Sie teilen Ihnen mit, dass die Seite nicht gefunden und aufgelistet werden kann, aber sie verweisen nicht auf die richtigen Informationen (siehe Abbildung 1).

Abbildung 1 Ein „nicht gefunden“-Fehler

Kein Zweifel, wenn eine dieser Fehlermeldungen angezeigt wird, sind Sie frustriert, und die Besucher der Website Ihrer Organisation natürlich auch. Gibt es etwas, was Sie als IT-Administrator unternehmen können, damit Ihre Website benutzerfreundlicher wird, wenn eine Seite nicht gefunden werden kann?

Das gibt es in der Tat. Sie können eine benutzerdefinierte Fehlerseite einrichten, durch die die generische 404-Seite ersetzt wird und stattdessen nützliche Details für Websitebesucher angezeigt werden, die auf Schwierigkeiten stoßen. Es gibt ein nützliches Tool, das Ihnen helfen kann, benutzerdefinierte Fehlerseiten zu entwerfen und zu implementieren: das von Microsoft kostenlos bereitgestellte Web Page Error Toolkit.

Das Web Page Error Toolkit ist eine ASP.NET-Anwendung, die IIS nutzt. Sie ändern eine ASPX-Webseite und andere Dateien, die im Toolkit enthalten sind, und richten dann IIS so ein, dass es Ihre benutzerdefinierte Seite bereitstellt. Die Fehlerseite zeigt daraufhin Suchergebnisse an, damit Ihre Besucher bei Eintreten eines Fehlers die richtigen Informationen leichter finden können.

Standardmäßig verwendet die Seite das Microsoft Live Search-Modul, um Suchergebnisse zu generieren (obwohl Sie eine andere Suchmaschine verwenden können, wenn Sie möchten). Die Seite kann auch alternative Schreibweisen vorschlagen, falls sich ein Benutzer bei der Eingabe der URL oder der Suchzeichenfolge vertippt hat.

Microsoft verwendet das Web Page Error Toolkit für seine eigene Website, um Besuchern zu helfen. Angenommen, Sie suchen nach „Microsoft Office“ unter microsoft.com und vertippen sich dabei und schreiben „Microsoft Ofice“. Die benutzerdefinierte Fehlerseite zeigt eine Meldung an, in der Sie gefragt werden, ob Sie „Microsoft Office“ eingeben wollten, und bietet eine Liste von Suchergebnissen für den richtigen Begriff (siehe Abbildung 2).

Abbildung 2 Eine Fehlerseite mit Suchergebnissen

Anforderungen

Die Anforderungen für das Web Page Error Toolkit umfassen Folgendes:

• Windows 2000, Windows Vista, Windows XP, Windows Server 2003 oder Windows Server 2008
• IIS 5.0 oder höher
• ASP.NET 2.0 oder höher
• Visual Studio 2005 oder höher

Herunterladen und Installieren

Das Web Page Error Toolkit kann unter „Live Services“ heruntergeladen werden. In der Dokumentation wird empfohlen, dass Sie die heruntergeladene Datei, WebPageErrorToolkitSetup.msi, im Stammverzeichnis Ihrer Website installieren. Meine Empfehlung lautet jedoch, dass Sie sie im Standardverzeichnis „C:\Programme\Microsoft\Web Page Error Toolkit“ installieren und dann die notwendigen Dateien und Verzeichnisse in das Stammverzeichnis Ihres Servers kopieren. Dadurch erhalten Sie Kontrolle darüber, welche Dateien im Stammverzeichnis gespeichert werden. Nach der Installation wird im Menü „Alle Programme“ ein neuer Ordner namens „Web Page Error Toolkit“ mit zwei Verknüpfungen angezeigt: „User Guide“ und „Web Page Error Toolkit Files“.

Die Toolkit-Dateien enthalten Folgendes:

Web.config.merge Dies ist die Datei, in der die für Ihre web.config-Datei notwendigen Einstellungen enthalten sind. Auf einer ASP.NET-Website enthält die web.config-Datei bestimmte zentrale Einstellungen, die in verschiedene Abschnitte unterteilt sind.

Errorpage.aspx Dies ist die benutzerdefinierte Fehlerseite, durch die die generische 404-Fehlerseite ersetzt wird.

Errorpage.aspx.cs Die CodeBehind-Seite für errorpage.aspx, geschrieben in C#.

Errorstyle.css Das Stylesheet für Ihre Fehlerseite.

UserGuide.docx Die Dokumentation im Microsoft Office Word 2007-Format.

Readme.rtf Dies ist ein kurzes Dokument, in dem erläutert wird, was Sie mit der web.config.merge-Datei tun müssen.

MSPL license.rtf Ein Dokument mit den Lizenzierungsinformationen der Software.

Das Installationsverzeichnis enthält außerdem drei Unterverzeichnisse: „App_Code“, „bin“ und „Web References“.

Einrichten des Webservers

Zuerst müssen Sie die notwendigen Dateien in das Stammverzeichnis Ihres Webservers kopieren, falls Sie sich entschieden haben, sie nicht dort zu installieren. Errorpage.aspx, errorpage.aspx.cs, errorstyle.css und web.config.merge müssen in das Stammverzeichnis kopiert werden. Kopieren Sie außerdem die drei Unterverzeichnisse: „App_Code“, „bin“ und „Web References“. Denken Sie beim Kopieren dieser drei Unterverzeichnisse daran, dass sie bereits im Stammverzeichnis Ihres Webservers vorhanden sein könnten. Das dürfte jedoch keine Probleme bereiten, da die Dateien in diesen Verzeichnissen toolkitspezifisch sind und ein Konflikt mit anderen vorhandenen Dateien unwahrscheinlich ist.

Einrichten der web.config-Datei

Als Nächstes müssen Sie die web.config-Datei einrichten. Wenn im Stammverzeichnis Ihres Webservers keine web.config-Datei vorhanden ist, benennen Sie „web.config.merge“ in „web.config“ um, und verwenden Sie diese als Ihre Standarddatei. Aber wenn Ihre Website unter ASP.NET ausgeführt wird, enthält das Stammverzeichnis in der Regel bereits eine web.config-Datei. In diesem Fall müssen Sie den Inhalt der web.config.merge-Datei mit der bereits vorhandenen web.config-Datei zusammenführen.

Zuvor müssen Sie jedoch einige Einstellungen der Datei ändern. Öffnen Sie die web.config.merge-Datei in einem Texteditor oder in Visual Studio. Suchen Sie nach den Parametern, und ändern Sie sie für die folgenden Abschnitte:

ErrorPage.AppID Wenn Sie Live Search als Ihre Suchmaschine verwenden möchten, müssen Sie zuerst auf der Website search.live.com eine ID abrufen. Sie geben dann die ID in diesem Abschnitt ein.

ErrorPage.CultureInfo Hier können Sie die Kultur/das Gebietsschema eingeben, in der bzw. dem Sie die Suche durchführen möchten. Der Standardwert ist en-US für Englisch (USA).

ErrorPage.Domain In diesem Abschnitt geben Sie den Namen Ihrer Domäne ein, um dem Toolkit mitzuteilen, wo es die auf der Fehlerseite anzuzeigenden Suchergebnisse abrufen soll.

ErrorPage.WebSearchResultsNumber Durch den Wert, den Sie hier eingeben, können Sie die maximale Zahl der auf der Fehlerseite aufzulistenden Suchergebnisse angeben. Die Standardeinstellung ist 10. Der Höchstwert beträgt 50.

ErrorPage.PerformSpellCheck Hier geben Sie den Wert „True“ ein, wenn die Fehlerseite bei Tippfehlern in URLs oder Suchzeichenfolgen alternative Schreibweisen vorschlagen soll.

ErrorPage.SpellingMessage In diesem Abschnitt geben Sie die Syntax der Frage ein, die bei einem Rechtschreibfehler angezeigt werden soll. Die Standardtextzeichenfolge lautet: „Were you looking for {...} instead?“ (Haben Sie nach {Vorschlag} gesucht?)

ErrorPage.SearchTitle Dies ist der Titel der Seite, der angezeigt wird, wenn nachfolgende Suchabfragen nicht zum gewünschten Inhalt führen. Andernfalls wird Ihren Websitebesuchern immer wieder der folgende Text angezeigt: „We are sorry, the page you requested cannot be found.“ (Die angeforderte Seite kann leider nicht gefunden werden.)

ErrorPage.PrivacyURL, ErrorPage.Sitemap.URL und ErrorPage.CopyrightURL Sie können Links zu diesen Seiten hinzufügen, die in der Fußzeile der Fehlerseite angezeigt werden.

Nachdem Sie die web.config.merge-Datei geändert haben, müssen Sie deren Einstellungen mit der vorhandenen web.config-Datei zusammenführen. Die web.config.merge-Datei enthält zwei Abschnitte: „appSettings“ und „system.web“. Die Einstellungen im appSettings-Abschnitt gibt es nur im Toolkit. Deshalb können Sie diese Zeichenfolgen kopieren und direkt in den gleichen Abschnitt in Ihrer web.config-Datei einfügen. Der Abschnitt „system.web“ enthält eine einzige Zeichenfolge für customErrors. Wenn die customErrors-Zeichenfolge bereits in Ihrer web.config-Datei vorhanden ist, deaktivieren Sie sie, indem Sie sie in einen Kommentar umwandeln, und ersetzen Sie sie durch die Zeichenfolge aus der web.config.merge-Datei. Denken Sie daran, eine Sicherungskopie der vorhandenen web.config-Datei zu erstellen, bevor Sie Änderungen vornehmen.

Anpassen der ErrorPage-Datei

Als nächster Schritt empfiehlt es sich, die ErrorPage.aspx-Datei zu ändern. Die Datei ist bereits vollständig konfiguriert, sodass hier nicht viel zu tun ist. Sie möchten vielleicht Fehlerantworten auf der Seite – wie z. B. „Die angeforderte Seite kann leider nicht gefunden werden.“ und „See below for results close to your request“ (Unten sehen Sie Ergebnisse, die Ihrer Anforderung nahe kommen) – in eine Textzeichenfolge Ihrer Wahl ändern. Abschließend können Sie das errorstyle.css-Stylesheet durch Anpassen der Farbe, der Schriftart, des Schriftgrads und ähnlicher Attribute für Ihre errorpage.aspx-Datei ändern.

Arbeiten in IIS

Ihr letzter Schritt besteht darin, die benutzerdefinierten Fehlereinstellungen in IIS zu ändern, damit sie auf Ihre neue benutzerdefinierte Fehlerseite zeigen. Dieser Prozess hängt von der Version von IIS ab, die Sie verwenden.

Gehen Sie bei IIS 5.0 und IIS 6.0 wie folgt vor:

1. Öffnen Sie IIS.
2. Wählen Sie die Website aus, um sie anzupassen.
3. Klicken Sie mit der rechten Maustaste auf die Website, und wählen Sie im Popupmenü die Option „Eigenschaften“ aus.
4. Klicken Sie im Fenster „Websiteeigenschaften“ auf die Registerkarte „Benutzerdefinierte Fehler“.
5. Führen Sie in der Liste der HTTP-Fehler einen Bildlauf nach unten durch, und wählen Sie den Fehler aus, den Sie anpassen möchten, in diesem Fall 404.
6. Klicken Sie auf die Schaltfläche „Bearbeiten“.
7. Wählen Sie im Dropdownfeld für den Meldungstyp die Option „URL“ aus.
8. Geben Sie im URL-Feld „/ErrorPage.aspx“ ein. Klicken Sie auf „OK“.

Gehen Sie bei IIS 7 wie folgt vor:

1. Öffnen Sie IIS.
2. Wählen Sie die Website aus, die Sie anpassen möchten.
3. Doppelklicken Sie auf das Symbol für benutzerdefinierte Fehlerseiten.
4. Führen Sie in der Liste der Statuscodes einen Bildlauf nach unten durch, und doppelklicken Sie auf den 404-Code.
5. Wählen Sie im Dropdownfeld „Pfadtyp“ die Option „URL ausführen“ aus.
6. Geben Sie im Pfadfeld „/ErrorPage.aspx“ ein. Klicken Sie auf „OK“.

Nun können Sie Ihre Fehlerseite testen. Öffnen Sie die Homepage Ihrer eigenen Website. Fügen Sie im Adressfeld eine Unterseite Ihrer Website der URL hinzu, aber schreiben Sie sie falsch. Ihre benutzerdefinierte Fehlerseite muss jetzt mit einer Liste alternativer Vorschläge und potenzieller Suchergebnisse angezeigt werden.

Sie können vielleicht nicht gänzlich sicherstellen, dass Besucher immer das Gewünschte auf Ihrer Website finden, aber durch Anzeigen einer benutzerdefinierten Fehlerseite verringern Sie zumindest die Frustration ihrer Besucher.

Lance Whitney ist IT-Berater, Schulungsleiter und Autor technischer Artikel. Er hat sich intensiv mit dem Optimieren von Windows-Arbeitsstationen und -Servern beschäftigt. Er ist von Haus aus Journalist und hat vor etwa 15 Jahren den Sprung in das kalte Wasser der IT-Welt getan.