ErrorImage

Immagine di 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 eseguire il rendering del testo del messaggio di errore nell’immagine di risposta. Le seguenti variabili predefinite possono essere incluse nel modello $error.title, che viene sostituito da 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 l’immagine/modello di errore può essere elaborato correttamente, viene restituito lo stato HTTP 200. Se si verifica un errore durante l’elaborazione, 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 viene 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 di cui è stato eseguito il rendering nell’immagine, è necessario innanzitutto definire il modello nel catalogo immagini. In questo caso, creiamo una voce nel nostro catalogo immagini 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

In questo esempio, il testo verrà riprodotto utilizzando il font, il colore del font e le dimensioni del font predefiniti.

Consultate anche

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

In questa pagina