개체 ID 변환 object-id-translation

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

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

locale ​이(가) locale= 명령을 사용하여 이미지 제공 요청에 지정되었습니다.

NOTE
개체 ID 변환은 이미지 제공의 카탈로그 기반 사용에만 적용할 수 있습니다. 파일 이름을 번역할 수 없습니다.

범위 section-66fcd5bd467c4eeaa1574583cbe9756d

이미지, SVG 및 정적 콘텐츠 카탈로그의 항목에 대한 모든 참조는 번역 글꼴로 간주되며 ICC 프로필 참조는 번역되지 않습니다. /is/image 및 /is/static requests의 경로에 있는 object 외에도 이러한 명령 및 카탈로그 특성은 ID 변환의 대상이 됩니다. src=, mask=, template=, defaultImage=, attribute::DefaultImageattribute::Watermark.

ID 번역 맵 section-9e417b352c314dfe94e831fdd62cddc8

attribute::LocaleMap은(는) 제네릭 개체 ID 및 locale= 값을 입력함에 따라 지역화된 콘텐츠의 ID를 결정하는 데 사용되는 규칙을 정의합니다.

attribute::LocaleMap은(는) 입력 locales(이 locale=(으)로 지정된 값과 일치) 목록으로 구성되며, 각 입력 목록에는 출력 로케일 접미사(*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

위의 예에서 서버는 먼저 ID 변환 맵에서 locale " de_de"을(를) 찾습니다. 그런 다음 이 항목의 " _D" 및 ""(빈 접미사)와 연결된 locSuffixes ​을(를) 반복합니다. 각 반복에 대해 접미사는 이미지 ID와 카탈로그에서 존재 여부를 테스트한 결과 ID에 추가됩니다. 발견된 경우 해당 카탈로그 항목이 사용되고, 그렇지 않으면 다음 항목이 테스트됩니다. 이 예제에서는 myCat/myImg_DmyCat/myImg 항목을 검사합니다. 일치하는 항목이 없으면 서버에서 오류 또는 기본 이미지(구성된 경우)를 반환합니다.

알 수 없는 로케일 section-b2f3c83f2dc845d69b5908107b775537

위의 예에서 attribute::LocaleMap에는 알 수 없는 locale= 값(번역 맵에 명시적으로 나열되지 않은 값)에 사용되는 기본 번역 규칙을 정의하는 빈 locale ​이(가) 포함되어 있습니다. 이 번역 맵이 요청 /is/image/myCat/myImg?locale=ja에 적용된 경우 myCat/myImg_E(있는 경우) 또는 myCat/myImg(으)로 확인됩니다.

번역 맵에서 기본 번역 규칙을 지정하지 않으면 알 수 없는 locale= 값이 있는 모든 요청에 대해 오류가 반환됩니다.

예제 section-cc40bb00ee9248bb8cb23e17d7a5984c

다중 계층 조회

지역 표준을 해결하기 위해 로케일(예: 유럽, 중동, 북미)을 그룹화하는 것이 종종 바람직합니다. 이 작업은 다중 계층 조회를 통해 수행할 수 있습니다.

이 예제에서는 서양 및 중동 지역의 컬렉션을 지원하려고 합니다. 두 컬렉션은 모두 일반 이미지 컬렉션을 기반으로 하며, 모두 여러 이미지를 추가하거나 수정합니다. 그런 다음 w1w3에 대해 이미지가 공유된다는 점을 제외하고 두 컬렉션은 특정 로케일(두 개의 중동 지역 변형에 대해 m1, m2, 세 개의 서양 로케일에 대해 w1, w2w3)에 대해 추가로 개선됩니다. 알 수 없는 로케일은 일반 컬렉션에만 매핑되며 로케일별 이미지에 대한 액세스 권한이 없습니다.

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
에 대한
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