ErrorImage

エラー応答画像。 通常、画像サービングは、エラーが発生するとエラーメッセージと共にエラーステータスを返します。

attribute::ErrorImage を使用すると、エラーが発生した場合に返される画像、カタログエントリまたはテンプレートを設定できます。

画像サービングテンプレートを設定できます。これにより、エラーメッセージテキストが応答画像にレンダリングされる可能性があります。 $error.title テンプレートには、短いエラー説明に置き換えられる次の定義済みの変数、およびより詳細なエラー説明に置き換えられる $error.message を含めることができます（詳細レベルは attribute::ErrorDetail で設定されます）。

エラー画像/テンプレートが正常に処理できた場合、HTTP ステータス 200 が返されます。 この処理中にエラーが発生した場合は、HTTP エラーステータスとテキストメッセージが返されます。

プロパティ

テキスト文字列 指定する場合は、画像カタログの有効な catalog::Id 値、または Image Server からアクセス可能な画像ファイルへの相対パス（attribute::RootPath に対する相対パス）または絶対パスである必要があります。

初期設定

定義されていない場合は default::ErrorImage から継承します。 定義されていても空の場合、default::ErrorImage が定義されていても、エラー画像の動作は無効になり、HTTP エラーステータスおよびテキストメッセージが返されます。

例

エラーメッセージを画像にレンダリングして応答画像を取得するには、まず画像カタログでテンプレートを定義する必要があります。 この例では、catalog::Modifier に次を含む onError という名前のエントリを画像カタログに作成します。

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

テンプレートは attribute::ErrorImage に登録されます。

ErrorImage=myCatalog/onError

この例では、テキストはデフォルトのフォント、フォントカラーおよびフォントサイズを使用してレンダリングされます。

関連項目

attribute::RootPath、catalog::Id、attribute::DefaultImage、attribute::ErrorDetail