オブジェクト ID の変換 object-id-translation

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

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

The locale が画像サービング要求で指定され、 locale= コマンドを使用します。

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

範囲 section-66fcd5bd467c4eeaa1574583cbe9756d

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

ID 変換マップ section-9e417b352c314dfe94e831fdd62cddc8

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 」を参照してください。

翻訳プロセス section-1f64db17e9f644d88e09853670e14a16

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

不明なロケール section-b2f3c83f2dc845d69b5908107b775537

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

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

section-cc40bb00ee9248bb8cb23e17d7a5984c

複数層の参照

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

この例では、西部および中東部で使用するコレクションをサポートします。 どちらのコレクションも汎用の画像コレクションに基づいて作成し、いくつかの画像を追加または変更します。次に、両方のコレクションが特定のロケール用にさらに絞り込まれます ( 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:

locale
検索する出力 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

関連項目 section-05893816c66a406d89f9bfd6ace8d47a

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

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49