개체 ID 번역

이미지 제공 기능은 외부 개체 ID를 로케일 특정 개체(카탈로그) ID로 변환하는 메커니즘을 제공합니다. 기본 응용 프로그램은 로케일 특정 개체 ID를 알 필요가 없는 클라이언트 응용 프로그램이 여러 로케일 간에 공유되는 컨텐츠와 로케일 특정 컨텐츠를 제공하는 것입니다.

글로벌 개체 ID만 사용하여 응용 프로그램을 작성할 수 있으며, 이미지 제공 기능은 로케일 특정 이미지와 사용 가능한 다른 콘텐츠를 자동으로 대체하게 됩니다.

locale​은 locale= 명령을 사용하여 이미지 제공 요청에 지정됩니다.

노트

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

범위

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

ID 번역 맵

attribute::LocaleMap 는 일반 개체 ID와 값을 입력하여 현지화된 컨텐츠의 ID를 결정하는 데 서버에서 사용하는 규칙을 locale= 정의합니다.

attribute::LocaleMap 입력 로케일 목록 ** ( 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 설명을 참조하십시오.

번역 프로세스

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

알 수 없는 로케일

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

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

예제

다중 계층 조회

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

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

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

de , de_at , de_de

myImg_470, myImg_480, myImg_1, myImg_2,myImg_3

기타

myImg_1, myImg_2, myImg_3

참조

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

이 페이지에서는