ErrorImage

Immagine della risposta di errore. Image Server restituisce normalmente uno stato di errore con un messaggio di testo quando si verifica un errore.

attribute::ErrorImage consente di configurare un’immagine, una voce di catalogo o un modello da restituire in caso di errore.

NOTA

Le immagini mancanti possono essere gestite anche con attribute::DefaultImage.

È possibile configurare un modello Image Server che potrebbe rappresentare il testo del messaggio di errore nell’immagine della risposta. Le seguenti variabili predefinite possono essere incluse nel modello $error.title, che viene sostituito con una breve descrizione dell'errore, e $error.message, che viene sostituito da una descrizione dell'errore più dettagliata (il livello di dettaglio è configurato con attribute::ErrorDetail).

Se è possibile elaborare correttamente l'immagine o il modello di errore, viene restituito lo stato HTTP 200. Se durante l'elaborazione si verifica un errore, vengono restituiti lo stato di errore HTTP e un messaggio di testo.

Proprietà

Stringa di testo. Se specificato, deve essere un valore catalog::Id valido in un catalogo immagini o un percorso relativo (a attribute::RootPath) o assoluto a un file immagine accessibile dal server immagini.

Predefinito

Ereditato da default::ErrorImage se non definito. Se definito ma vuoto, il comportamento dell'immagine di errore è disabilitato, anche se è definito default::ErrorImage, e viene restituito uno stato di errore HTTP e un messaggio di testo.

Esempio

Per ottenere immagini di risposta con il messaggio di errore rappresentato nell’immagine, è necessario innanzitutto definire il modello nel catalogo immagini. In questo caso, nel nostro catalogo immagini viene creata una voce denominata onError, contenente quanto segue in catalog::Modifier:

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

Il modello è registrato con attribute::ErrorImage:

ErrorImage=myCatalog/onError

Per questo esempio, il testo verrà riprodotto utilizzando il font predefinito, il colore del font e la dimensione del font.

Consultate anche

attributo::RootPath , catalogo::Id, attributo::DefaultImage, attributo::ErrorDetail

In questa pagina