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.
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.
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.
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.
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.
attributo::RootPath , catalogo::Id, attributo::DefaultImage, attributo::ErrorDetail