オブジェクト ID の変換

画像サービングは、外部オブジェクト ID をロケール固有のオブジェクト(カタログ)ID に変換するメカニズムを提供します。 主なアプリケーションは、ロケール固有のオブジェクト ID を知る必要のない、ロケール固有のコンテンツとコンテンツを複数のロケールで共有するためのものです。

アプリケーションはグローバルオブジェクト ID のみを使用して記述でき、画像サービングはロケール固有の画像やその他のコンテンツを自動的に置き換えます(使用可能な場合)。

この locale が画像サービング要求で locale= コマンドを使用します。

メモ

オブジェクト ID の変換は、画像サービングのカタログベースでの使用にのみ適用できます。 ファイル名は翻訳できません。

範囲

画像、SVG、および静的コンテンツカタログ内のエントリへの参照は、翻訳フォントと ICC プロファイルの参照に対しては、すべて翻訳されません。 また、 object ~の道に /is/image および /is/static requestsの場合、これらのコマンドとカタログ属性は ID 変換の対象になります。 src=, mask=, template=, defaultImage=, attribute::DefaultImage、および attribute::Watermark.

ID 変換マップ

attribute::LocaleMap 汎用オブジェクト ID と locale= の値です。

attribute::LocaleMap 入力のリストで構成されます ロケール ( locale=) の代わりに、1 つ以上の出力ロケールのサフィックス ( *locSuffixes*) をクリックします。

例: attribute::LocaleMap 次のようになります。

en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,_E,

リクエスト /is/image/myCat/myImg?locale=de_de は、カタログエントリに関連付けられた画像を返します。 myCat/myImg_D (このようなカタログエントリが存在する場合)。

詳しくは、 attribute::LocaleMap 」を参照してください。

翻訳プロセス

上記の例では、サーバーはまず locale " de_de」と入力します。 次に、 locSuffixes このエントリに関連付けられています。この場合は" _D"と""(空のサフィックス) 繰り返しごとに、サフィックスが画像 ID に追加され、カタログ内での存在がテストされた結果の ID が追加されます。 見つかった場合は、そのカタログエントリが使用され、それ以外の場合は、次のカタログエントリがテストされます。 この例では、次のエントリがチェックされます。 myCat/myImg_D、および myCat/myImg. 一致する画像が見つからない場合、サーバーはエラーまたはデフォルトの画像(設定されている場合)を返します。

不明なロケール

上記の例では、 attribute::LocaleMap 空を含む locale デフォルトの翻訳ルールを定義し、不明な場合に使用します locale= の値(つまり、翻訳マップに明示的にリストされていない値)に基づいて、 この翻訳マップがリクエストに適用された場合 /is/image/myCat/myImg?locale=jaの場合、 myCat/myImg_E存在する場合は、存在する場合は、それ以外の場合は myCat/myImg.

翻訳マップでデフォルトの翻訳ルールが指定されていない場合は、不明なすべてのリクエストに対してエラーが返されます locale= 値。

多層参照

地域の標準に対応するために、ロケール(ヨーロッパ、中東、北米など)をグループ化することが望ましい場合も多いです。 これは、複数層のルックアップを使用して実現できます。

この例では、西部および中東部で使用するコレクションをサポートします。 どちらのコレクションも汎用の画像コレクションに基づいて作成し、いくつかの画像を追加または変更します。次に、特定のロケール ( m1, m2 中東の 2 つの亜種に対して w1, w2、および w3 (3 つの西側のロケールの場合)、ただし、画像が w1 および w3. 不明なロケールは汎用のコレクションのみにマッピングされ、ロケール固有の画像にはアクセスされません。

attribute::LocaleMap: w1,-W,|w2,-W2,-W,|w3,-W,|m1,-M1,-M,|m2,-M2,-M,|,

次の表に、どのカタログエントリを考慮するか、および汎用入力 ID に対してエントリを考慮する順序を示します myImg:

locale 検索するカタログ ID

w1, w3

myImg-W, myImg

w2

myImg-W2, myImg-W, myImg

m1

myImg-M1, myImg-M, myImg

m2

myImg-M2, myImg-M, myImg

その他

myImg

特定の ID の検索

一部の画像の命名規則では、内部的に汎用の画像 ID をサポートしていない場合があります。 要求の汎用 ID は、常にカタログ内の特定の ID にマッピングする必要があります。多くの場合、正確な特定の ID が不明な場合があります。

この例では、すべての言語の画像に _1, _2または _3 サフィックス フランス語のロケールに固有の画像には、 _22 または _23 サフィックスと、ドイツ語のロケールに固有の画像には、 _470 または _480 サフィックス

attribute::LocaleMap: ,_1,_2,_3|fr,_22,_23,_1,_2,_3|de,_470,_480,_1,_2,_3| de_at,_470,_480,_1,_2,_3| de_de,_470,_480,_1,_2,_3

次の表に、どのカタログエントリを考慮するか、および汎用入力 ID に対してエントリを考慮する順序を示します myImg:

ロケール 検索する出力 ID

fr

myImg_22, myImg_23, myImg_1, myImg_2,myImg_3

de , de_at , de_de

myImg_470, myImg_480, myImg_1, myImg_2,myImg_3

その他

myImg_1, myImg_2, myImg_3

関連項目

attribute::LocaleMap , attribute::DefaultLocale, locale=, req=xlate

このページ