ErrorImage errorimage

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

attribute::ErrorImage consente la configurazione di un'immagine, una voce di catalogo o un modello da restituire in caso di errore.

È possibile configurare un modello Image Server che potrebbe riprodurre il testo del messaggio di errore nell’immagine di risposta. Le seguenti variabili predefinite possono essere incluse nel modello $error.title, che è sostituito da una breve descrizione dell'errore, e $error.message, che è 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 questa elaborazione, vengono restituiti lo stato dell’errore HTTP e un messaggio di testo.

Proprietà section-f460c6c2dd1f46b29f9a79b093575f45

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 di un file immagine accessibile dal server immagini.

Predefinito section-2885f289e5714ddca665a6aee401967f

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

Esempio section-c92090abe1d247529542a8dd4960c2e6

Per ottenere immagini di risposta con il messaggio di errore rappresentato nell’immagine, è necessario innanzitutto definire il modello nel catalogo delle immagini. In questo caso, verrà creata una voce nel 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 rendering del testo viene eseguito utilizzando il carattere predefinito, il colore e la dimensione del carattere.

Consultate anche section-bbf1f85fc0a34033bdda1dd3e4e0bbb6

attribute::RootPath , catalog::Id, attribute::DefaultImage, attribute::ErrorDetail