ErrorImage

Imagem de resposta do erro. O Image Serving 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.

OBSERVAÇÃO

Imagens ausentes também podem ser tratadas com attribute::DefaultImage.

Um modelo de Exibição de imagem pode ser configurado, o que pode renderizar o texto da mensagem de erro na imagem de resposta. As variáveis predefinidas a seguir podem ser incluídas no template $error.title, que é substituído por uma breve descrição do 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/template de erro puder ser processada com êxito. Se ocorrer um erro durante esse processamento, o status do erro HTTP e uma mensagem de texto serão retornados.

Propriedades

Sequência de texto. Se especificado, deve ser um catálogo válido::Id valor em um catálogo de imagem ou um relativo (para attribute::RootPath) ou caminho absoluto para um arquivo de imagem acessível pelo Servidor de Imagens.

Padrão

Herdado de default::ErrorImage se não estiver definido. Se definido, mas vazio, o comportamento da imagem de erro é desativado, mesmo que default::ErrorImage esteja definido, e um status de erro HTTP e uma mensagem de texto são retornados.

Exemplo

Para obter imagens de resposta com a mensagem de erro renderizada na imagem, primeiro devemos definir o modelo no catálogo de imagens. Nesse caso, criamos uma entrada em nosso catálogo de imagens chamado onError, contendo o seguinte em catalog::Modifier:

size=300,300&bgc=ffffff&text=$error.message$

O modelo é registrado com attribute::ErrorImage:

ErrorImage=myCatalog/onError

Neste exemplo, o texto será renderizado utilizando a fonte padrão, a cor da fonte e o tamanho da fonte.

Consulte também

atributo::RootPath , catalog::Id, atributo::DefaultImage, atributo::ErrorDetail

Nesta página