개체 ID 변환 object-id-translation
이미지 제공에서는 외부 개체 ID를 로케일별 개체(카탈로그) ID로 변환하는 메커니즘을 제공합니다. 기본 애플리케이션은 로케일별 객체 ID를 몰라도 로케일별 콘텐츠 및 여러 로케일 간에 공유되는 콘텐츠를 제공하기 위한 것입니다.
응용 프로그램은 전역 개체 ID만 사용하여 작성할 수 있으며 이미지 제공은 로케일별 이미지 및 기타 가능한 경우 콘텐츠를 자동으로 대체합니다.
locale
이(가) locale=
명령을 사용하여 이미지 제공 요청에 지정되었습니다.
범위 section-66fcd5bd467c4eeaa1574583cbe9756d
이미지, SVG 및 정적 콘텐츠 카탈로그의 항목에 대한 모든 참조는 번역 글꼴로 간주되며 ICC 프로필 참조는 번역되지 않습니다. /is/image 및 /is/static requests의 경로에 있는 object
외에도 이러한 명령 및 카탈로그 특성은 ID 변환의 대상이 됩니다. src=
, mask=
, template=
, defaultImage=
, attribute::DefaultImage
및 attribute::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_D
및 myCat/myImg
항목을 검사합니다. 일치하는 항목이 없으면 서버에서 오류 또는 기본 이미지(구성된 경우)를 반환합니다.
알 수 없는 로케일 section-b2f3c83f2dc845d69b5908107b775537
위의 예에서 attribute::LocaleMap
에는 알 수 없는 locale=
값(번역 맵에 명시적으로 나열되지 않은 값)에 사용되는 기본 번역 규칙을 정의하는 빈 locale
이(가) 포함되어 있습니다. 이 번역 맵이 요청 /is/image/myCat/myImg?locale=ja
에 적용된 경우 myCat/myImg_E
(있는 경우) 또는 myCat/myImg
(으)로 확인됩니다.
번역 맵에서 기본 번역 규칙을 지정하지 않으면 알 수 없는 locale=
값이 있는 모든 요청에 대해 오류가 반환됩니다.
예제 section-cc40bb00ee9248bb8cb23e17d7a5984c
다중 계층 조회
지역 표준을 해결하기 위해 로케일(예: 유럽, 중동, 북미)을 그룹화하는 것이 종종 바람직합니다. 이 작업은 다중 계층 조회를 통해 수행할 수 있습니다.
이 예제에서는 서양 및 중동 지역의 컬렉션을 지원하려고 합니다. 두 컬렉션은 모두 일반 이미지 컬렉션을 기반으로 하며, 모두 여러 이미지를 추가하거나 수정합니다. 그런 다음 w1
및 w3
에 대해 이미지가 공유된다는 점을 제외하고 두 컬렉션은 특정 로케일(두 개의 중동 지역 변형에 대해 m1
, m2
, 세 개의 서양 로케일에 대해 w1
, w2
및 w3
)에 대해 추가로 개선됩니다. 알 수 없는 로케일은 일반 컬렉션에만 매핑되며 로케일별 이미지에 대한 액세스 권한이 없습니다.
attribute::LocaleMap: w1,-W,|w2,-W2,-W,|w3,-W,|m1,-M1,-M,|m2,-M2,-M,|,
다음 표는 고려되는 카탈로그 항목과 일반 입력 ID 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
에 대해 고려되는 순서를 보여 줍니다.
참조 section-05893816c66a406d89f9bfd6ace8d47a
attribute::LocaleMap , attribute::DefaultLocale, locale=, req=xlate