이미지 제공 기능은 특정 레코드에 대해 카탈로그와 연관된 모든 리소스 및 메타데이터를 나타내는 계층적 텍스트 응답(xml 또는 json)을 가져오는 메커니즘을 제공합니다.
뷰어는 이 메커니즘을 사용하여 간단한 이미지, 비디오, 비디오 세트, 견본 세트, 스핀 세트, 페이지 세트(e-catalog) 및 미디어 세트를 보여주는 응답을 생성할 수 있습니다.
에 대한 설정 응답 catalog::ImageSet
는 req=set
수정자 및 네트 경로에서 카탈로그 레코드 id 참조. 또는 를 사용하여 URL에서 직접 이미지 세트를 지정할 수 있습니다 imageset=
수정자. 만약 imageset=
수정자 는 이미지 집합을 지정하는 데 사용되며, 이미지 세트 값을 이스케이프하고 포함된 수정자가 URL 쿼리 문자열의 일부로 해석되지 않도록 하려면 전체 값을 중괄호로 묶어야 합니다.
설정 메커니즘은 다음과 같은 유형의 응답을 지원합니다.
단순 이미지 |
없는 이미지 레코드 카탈로그::ImageSet 정의됩니다. |
간단한 비디오 |
정적 컨텐츠 카탈로그의 비디오 레코드입니다. |
견본 집합 |
이미지 레코드에 대한 참조와 견본으로 사용되는 이미지 레코드에 대한 선택적 별도 참조로 구성된 항목 집합입니다. |
계층 견본 집합 |
기본 견본 항목이나 견본 집합 레코드에 대한 참조로 구성된 항목 집합입니다. |
스핀 세트 |
단순 이미지 ID 목록으로 구성된 항목 세트입니다. |
2차원 스핀 세트 |
단순 이미지 또는 기본 스핀 세트에 대한 참조로 구성된 항목 집합입니다. |
페이지 세트 |
최대 3개의 페이지 이미지 목록으로 구성된 항목 세트 |
미디어 집합 |
단순 이미지, 비디오 세트, 견본 세트, 계층 구조 견본 세트, 스핀 세트, 2차원 스핀 세트, 페이지 세트 및 비디오 자산으로 구성된 항목 세트입니다. 각 미디어 세트 항목에는 선택적 색상 견본을 포함할 수도 있습니다. |
비디오 세트 |
단순 비디오 목록으로 구성된 항목 세트입니다. |
다음 경우에 req=set
요청이 수신되면 생성할 응답 유형은 의 값에 의해 결정됩니다. catalog::AssetType
. If catalog::AssetType
가 정의되지 않은 경우 응답 유형은 다음 규칙에 의해 결정됩니다.
이미지 카탈로그에 레코드가 있으면 AND catalog::ImageSet
정의된 횟수
이미지 및 정적 컨텐츠 카탈로그 모두에 레코드가 있는 경우
정적 콘텐츠 카탈로그에 레코드가 있지만 이미지 카탈로그에는 없는 경우
이미지 카탈로그에서 의 레코드가 있지만 정적 콘텐츠 카탈로그에는 없는 경우
이미지 카탈로그에서 레코드가 없고 정적 컨텐츠 카탈로그에서 찾을 수 없는 경우
모든 경우 결과 xml 응답은 감지된 유형에 해당하는 설정된 루트 노드가 있는 지정된 XML 문서를 따릅니다.
외부 세트가 유형 미디어 세트로 감지되면 응답에는 의 각 미디어 세트 항목에 해당하는 미디어 세트 항목 세트가 포함됩니다 catalog::ImageSet
. 선택적 유형 매개 변수가 특정 미디어 세트 항목에 대해 지정된 경우 다음 표에 따라 출력 유형에 매핑됩니다.
입력 유형 | 출력 유형 |
---|---|
img |
img |
basic |
img |
advanced_image |
img |
img_set |
img_set |
advanced_image_set |
img_set |
advanced_swatchset |
img_set |
spin |
spin |
video |
video |
video_set |
video_set |
static |
static |
ecat |
ecat |
특정 미디어 세트 항목에 대한 선택적 유형 매개 변수를 지정하지 않았거나 지원되지 않는 유형에 해당하는 경우, 미디어 세트 항목 유형은 외부 세트 수준에서 적용된 것과 동일한 규칙을 사용하여 자동으로 검색됩니다.
반환된 xml 응답은 다음 사양을 따릅니다.
http://crc.scene7.com/is-docs/examples/mediaset.dtd
다음 labelkey=
수정자는 와 함께 사용됩니다 catalog::UserData
이미지 및 색상 견본의 레이블을 생성하는 필드입니다. 다음 catalog:UserData
필드는 키/값 쌍 세트로 구문 분석되고 이 세트에 있는 레이블 키 색인은 지정된 키에 대한 값을 검색합니다. 그런 다음 이 값은 l
에 대한 속성 s
및 i
.
응답 크기를 제한하고 자체 참조 문제를 방지하기 위해 서버 속성에 의해 최대 중첩 깊이가 제어됩니다 PS::fvctx.nestingLimit
. 이 제한을 초과하면 오류가 반환됩니다.
대형 전자 카탈로그 세트에 대한 xml 응답 크기를 제한하기 위해, 서버 속성에 따라 브로셔 세트 항목에 대한 비공개 메타데이터가 표시되지 않습니다 PS::fvctx.brochureLimit
. 브로셔와 관련된 모든 비공개 메타데이터는 브로셔의 제한에 도달할 때까지 내보내집니다. 한도를 초과하면 개인 맵 및 사용자 데이터가 억제되고 해당 플래그가 억제된 데이터 유형을 나타내는 것으로 설정됩니다.
중첩된 미디어 세트는 지원되지 않습니다. 중첩된 미디어 세트는 미디어 세트 유형의 미디어 세트 항목을 포함하는 미디어 세트로 정의됩니다. 이 조건이 감지되면 오류가 반환됩니다.
에 대한 샘플 XML 응답 req=set
요청을 보려면 HTML 예 헤더 아래의 속성 페이지를 참조하십시오.
http://crc.scene7.com/is-docs/examples/properties.htm
req= , imageset=, 카탈로그::ImageSet, 이미지 카탈로그 참조