ErrorImage

Fehlerreaktionsbild. Image Serving gibt normalerweise einen Fehlerstatus mit einer Textmeldung zurück, wenn ein Fehler auftritt.

attribute::ErrorImage ermöglicht die Konfiguration von Bildern, Katalogeinträgen oder Vorlagen, die im Falle eines Fehlers zurückgegeben werden.

HINWEIS

Fehlende Bilder können auch mit attribute::DefaultImage verarbeitet werden.

Es kann eine Image Serving-Vorlage konfiguriert werden, die den Text der Fehlermeldung im Antwortbild wiedergibt. Die folgenden vordefinierten Variablen können in die $error.title-Vorlage eingefügt werden, die durch eine kurze Fehlerbeschreibung ersetzt wird, und $error.message, die durch eine detailliertere Fehlerbeschreibung ersetzt wird (die Detailtiefe wird mit attribute::ErrorDetail konfiguriert).

HTTP-Status 200 wird zurückgegeben, wenn das Fehlerbild/die Fehlervorlage erfolgreich verarbeitet werden kann. Tritt während dieser Verarbeitung ein Fehler auf, werden der HTTP-Fehlerstatus und eine Textmeldung zurückgegeben.

Eigenschaften

Textzeichenfolge. Wenn angegeben, muss ein gültiger Katalog::Id -Wert in einem Bildkatalog oder ein relativer Pfad (zu attribute::RootPath) oder ein absoluter Pfad zu einer Bilddatei sein, auf die der Image-Server zugreifen kann.

Standard

Vererbt von default::ErrorImage , falls nicht definiert. Wenn definiert, aber leer, ist das Verhalten des Fehlerbilds deaktiviert, auch wenn default::ErrorImage definiert ist, und es werden ein HTTP-Fehlerstatus und eine Textmeldung zurückgegeben.

Beispiel

Um Antwortbilder mit der in das Bild gerenderten Fehlermeldung zu erhalten, müssen wir zunächst die Vorlage im Bildkatalog definieren. In diesem Fall erstellen wir einen Eintrag in unserem Bildkatalog namens onError, der Folgendes in catalog::Modifier enthält:

size=300,300&bgc=ffffff&text=$error.message$

Die Vorlage ist bei attribute::ErrorImage registriert:

ErrorImage=myCatalog/onError

In diesem Beispiel wird der Text mit der Standardschrift, der Schriftfarbe und der Schriftgröße gerendert.

Verwandte Themen

attribute::RootPath , catalog::Id, attribute::DefaultImage, attribute::ErrorDetail

Auf dieser Seite