ErrorImage

Image de la réponse à une erreur. La diffusion d’images renvoie normalement un état d’erreur avec un message texte en cas d’erreur.

attribute::ErrorImage permet de configurer une image, une entrée de catalogue ou un modèle à renvoyer en cas d’erreur.

REMARQUE

Les images manquantes peuvent également être gérées avec attribute::DefaultImage.

Un modèle de diffusion d’images peut être configuré pour afficher le texte du message d’erreur dans l’image de réponse. Les variables prédéfinies suivantes peuvent être incluses dans le modèle $error.title, qui est remplacé par une brève description de l'erreur, et $error.message, qui est remplacé par une description plus détaillée de l'erreur (le niveau de détail est configuré avec attribute::ErrorDetail).

L’état HTTP 200 est renvoyé si l’image/le modèle d’erreur peut être traité avec succès. Si une erreur se produit pendant ce traitement, l’état d’erreur HTTP et un message texte sont renvoyés.

Propriétés

Chaîne de texte. Si spécifié, doit être une valeur catalog::Id valide dans un catalogue d’images ou un chemin d’accès relatif (à attribute::RootPath) ou absolu à un fichier d’image accessible par le serveur d’images.

Par défaut

Hérité de default::ErrorImage si elle n'est pas définie. Si défini mais vide, le comportement de l'image d'erreur est désactivé, même si default::ErrorImage est défini, et un état d'erreur HTTP et un message texte sont renvoyés.

Exemple

Pour obtenir des images de réponse avec le message d’erreur généré dans l’image, nous devons d’abord définir le modèle dans le catalogue d’images. Dans ce cas, nous créons une entrée dans notre catalogue d’images appelée onError, contenant les éléments suivants dans catalog::Modifier :

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

Le modèle est enregistré avec attribute::ErrorImage :

ErrorImage=myCatalog/onError

Dans cet exemple, le texte sera rendu à l’aide de la police par défaut, de la couleur de la police et de la taille de la police.

Voir aussi

attribut ::RootPath , catalogue::Id, attribut::DefaultImage, attribut::ErrorDetail

Sur cette page