개체 ID 변환 object-id-translation

이미지 제공에서는 외부 개체 ID를 로케일별 개체(카탈로그) ID로 변환하는 메커니즘을 제공합니다. 기본 애플리케이션은 로케일별 객체 ID를 몰라도 로케일별 콘텐츠 및 여러 로케일 간에 공유되는 콘텐츠를 제공하기 위한 것입니다.

응용 프로그램은 전역 개체 ID만 사용하여 작성할 수 있으며 이미지 제공은 로케일별 이미지 및 기타 가능한 경우 콘텐츠를 자동으로 대체합니다.

다음 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 및 를 입력함에 따라 현지화된 콘텐츠의 ID를 결정하는 데 서버에서 사용하는 규칙을 정의합니다. locale= 값.

attribute::LocaleMap 입력 목록으로 구성됩니다. 로케일 (지정된 값과 일치) locale=), 각각 하나 이상의 출력 로케일 접미사( *locSuffix*).

예를 들어, 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_deID 번역 맵에서 ""를 참조하십시오. 그런 다음 을 반복합니다. 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개의 웨스턴 로케일)의 경우, 단, 이미지는 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
다른 모든 항목
내 이미지

특정 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

참조 section-05893816c66a406d89f9bfd6ace8d47a

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

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