對象ID轉換

Image Serving提供一種機制,用於將外部對象ID轉換為特定於區域設定的對象(目錄)ID。 主應用程式用於提供在多個語言環境之間共用的語言環境特定的內容和內容,而不需要客戶端應用程式知道語言環境特定的對象ID。

只能使用全局對象ID編寫應用程式,影像服務將自動替換區域設定特定的影像和其他可用內容。

locale 在Image Serving請求中指定 locale= 的子菜單。

注意

對象ID轉換僅適用於基於目錄的影像服務使用。 無法轉換檔案名。

範圍

對影像、SVG和靜態內容目錄中條目的所有引用都被視為翻譯字型,並且ICC配置檔案引用不被翻譯。 除 object 在 /is/image 和 /is/static requests,這些命令和目錄屬性受ID轉換的約束: src=mask=template=defaultImage=attribute::DefaultImage, attribute::Watermark

ID轉換映射

attribute::LocaleMap 定義伺服器用於確定本地化內容ID的規則,這些規則作為輸入輸入一般對象ID和 locale= 值。

attribute::LocaleMap 包含輸入清單 區域 (與指定的值匹配 locale=),每個都帶有無或更多輸出區域設定尾碼( *loc尾碼*)。

比如說, 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= 值。

範例

多層查找

通常最好將地區(如歐洲、中東、北美)分組以符合地區標準。 這可以通過多層查找來實現。

在此示例中,我們希望支援用於西部和中東的收藏。 這兩個集合都以通用影像集合為基礎,增加或修改了一些影像。然後,將針對特定區域設定( m1m2 兩種中東變種 w1w2, w3 3個西方語言環境),但是 w1w3。 不明地區只會對應至通用集合,且無權存取地區特定影像。

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

下表說明了考慮哪些目錄條目以及它們作為一般輸入ID的考慮順序 myImg:

地區設定 要搜索的目錄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

取消 取消

myImg_470, myImg_480, myImg_1, myImg_2,myImg_3

其他

myImg_1, myImg_2, myImg_3

另請參閱

屬性::LocaleMap屬性::DefaultLocale區域設定=req=xlate

本頁內容