Imagem de resposta de erro. O Serviço de imagem normalmente retorna um status de erro com uma mensagem de texto quando ocorre um erro.
attribute::ErrorImage
permite que a configuração de uma imagem, entrada de catálogo ou modelo seja retornada em caso de erro.
Imagens ausentes também podem ser tratadas com attribute::DefaultImage
.
É possível configurar um modelo do Servidor de imagens que pode renderizar o texto da mensagem de erro na imagem de resposta. As variáveis predefinidas a seguir podem ser incluídas no modelo $error.title
, que é substituído por uma breve descrição de erro, e $error.message
, que é substituído por uma descrição de erro mais detalhada (o nível de detalhes é configurado com attribute::ErrorDetail
).
O status HTTP 200 será retornado se a imagem/modelo de erro puder ser processado com êxito. Se ocorrer um erro durante esse processamento, o status do erro HTTP e uma mensagem de texto serão retornados.
Sequência de caracteres de texto. Se especificado, deve ser um valor de catálogo válido::Id em um catálogo de imagens ou um relativo (para attribute::RootPath
) ou um caminho absoluto para um arquivo de imagem acessível pelo Servidor de imagens.
Herdado de default::ErrorImage
se não estiver definido. Se definido, mas vazio, o comportamento da imagem de erro é desativado, mesmo se default::ErrorImage
estiver definido, e um status de erro HTTP e uma mensagem de texto são retornados.
Para obter imagens de resposta com a mensagem de erro renderizada na imagem, primeiro precisamos definir o modelo no catálogo de imagens. Nesse caso, criamos uma entrada em nosso catálogo de imagens chamada onError
, que contém o seguinte em catalog::Modifier
:
size=300,300&bgc=ffffff&text=$error.message$
O modelo está registrado com attribute::ErrorImage
:
ErrorImage=myCatalog/onError
Neste exemplo, o texto será renderizado usando a fonte padrão, a cor da fonte e o tamanho da fonte.
atributo::RootPath , catálogo::Id, atributo::DefaultImage, atributo::ErrorDetail