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 anche essere gestite 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 $error.title modello, 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 di immagini o un relativo (a attribute::RootPath) o percorso assoluto di un file di immagine accessibile dal server di immagini.

Predefinito

Ereditato da default::ErrorImage se non definito. Se definito ma vuoto, il comportamento dell’immagine di errore è disabilitato anche se default::ErrorImage viene definito 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 chiamata 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 viene 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