ErrorImage

Imagen de respuesta de error. El servicio de imágenes normalmente devuelve un estado de error con un mensaje de texto cuando se produce un error.

attribute::ErrorImage permite que, en caso de error, se devuelva una imagen, entrada de catálogo o plantilla.

NOTA

Las imágenes que faltan también se pueden controlar con attribute::DefaultImage.

Se puede configurar una plantilla de servicio de imágenes que pueda procesar el texto del mensaje de error en la imagen de respuesta. Las siguientes variables predefinidas pueden incluirse en la plantilla $error.title, que se sustituye por una breve descripción del error, y $error.message, que se sustituye por una descripción de error más detallada (el nivel de detalle se configura con attribute::ErrorDetail).

Se devuelve el estado HTTP 200 si la imagen o plantilla de error se puede procesar correctamente. Si se produce un error durante este procesamiento, se devuelve el estado de error HTTP y un mensaje de texto.

Propiedades

Cadena de texto. Si se especifica, debe ser un valor de catálogo válido::Id en un catálogo de imágenes o un valor relativo (a attribute::RootPath) o una ruta absoluta a un archivo de imagen accesible por el servidor de imágenes.

Predeterminado

Se hereda de default::ErrorImage si no se define. Si está definida pero está vacía, el comportamiento de la imagen de error está desactivado, incluso si está definido default::ErrorImage y se devuelve un estado de error HTTP y un mensaje de texto.

Ejemplo

Para obtener imágenes de respuesta con el mensaje de error representado en la imagen, primero debemos definir la plantilla en el catálogo de imágenes. En este caso, creamos una entrada en nuestro catálogo de imágenes llamada onError, que contiene lo siguiente en catalog::Modifier:

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

La plantilla está registrada con attribute::ErrorImage:

ErrorImage=myCatalog/onError

Para este ejemplo, el texto se procesará con la fuente predeterminada, el color de la fuente y el tamaño de la fuente.

Véase también

atributo::RootPath , catálogo::Id, atributo::DefaultImage, atributo::ErrorDetail

En esta página