ErrorImage

Letzte Aktualisierung: 2022-03-04
  • Erstellt für:
  • Developer
    User

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.

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, die durch eine kurze Fehlerbeschreibung ersetzt wird, und $error.message, die durch eine detailliertere Fehlerbeschreibung ersetzt wird (die Detailtiefe wird mit attribute::ErrorDetail).

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 sein::Id -Wert in einem Bildkatalog oder ein relativer Wert (zu attribute::RootPath) oder absoluter Pfad zu einer Bilddatei, 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 ein HTTP-Fehlerstatus und eine Textmeldung zurückgegeben werden.

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, die Folgendes in catalog::Modifier:

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

Die Vorlage ist bei registriert attribute::ErrorImage:

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