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 se pueden incluir en la variable $error.title plantilla, que se sustituye por una breve descripción de 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 catálogo válido::Id en un catálogo de imágenes o un valor relativo (para attribute::RootPath) o ruta absoluta a un archivo de imagen accesible por el servidor de imágenes.

Predeterminado

Heredado de default::ErrorImage si no está definida. Si está definido pero vacío, el comportamiento de la imagen de error está desactivado, incluso si default::ErrorImage y 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 procesa con la fuente, el color de la fuente y el tamaño de fuente predeterminados.

Véase también

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

En esta página