미디어 집합 요청

마지막 업데이트: 2023-11-03
  • 작성 대상:
  • Developer
    User

이미지 제공은 특정 레코드에 대한 catalog::ImageSet과 연결된 모든 리소스 및 메타데이터를 나타내는 계층적 텍스트 응답(xml 또는 json)을 가져오는 메커니즘을 제공합니다.

뷰어는 이 메커니즘을 사용하여 간단한 이미지, 비디오, 비디오 세트, 견본 세트, 스핀 세트, 페이지 세트(e-카탈로그) 및 미디어 세트의 프레젠테이션을 알리는 응답을 생성할 수 있습니다.

요청 구문

에 대한 응답 설정 catalog::ImageSet 를 사용하여 검색할 수 있습니다. req=set 수정자 및 네트 경로의 카탈로그 레코드 id 참조. 또는 다음을 사용하여 이미지 세트를 URL에 직접 지정할 수도 있습니다. imageset= 수정자. 다음과 같은 경우 imageset= 수정자를 사용하여 이미지 집합을 지정합니다. 이미지 집합 값을 이스케이프하고 포함된 수정자가 URL 쿼리 문자열의 일부로 해석되지 않도록 하려면 전체 값을 중괄호로 묶어야 합니다.

집합 응답 유형

세트 메커니즘은 다음과 같은 응답 유형을 지원합니다.

단순 이미지

없는 이미지 레코드 catalog::ImageSet 정의됨.

간단한 비디오

정적 콘텐츠 카탈로그의 비디오 레코드입니다.

견본 집합

이미지 레코드에 대한 참조와 견본으로 사용되는 이미지 레코드에 대한 선택적 개별 참조로 구성된 항목 세트입니다.

계층 견본 집합

기본 견본 항목 또는 견본 집합 레코드에 대한 참조로 구성된 항목 집합입니다.

스핀 세트

간단한 이미지 ID 목록으로 구성된 항목 세트입니다.

이차원 스핀 세트

단순 이미지 또는 기본 회전 세트에 대한 참조로 구성된 항목 세트입니다.

페이지 세트

최대 3개의 페이지 이미지 목록으로 구성된 항목 세트

미디어 세트

단순 이미지, 비디오 세트, 견본 세트, 계층 구조 견본 세트, 스핀 세트, 2차원 스핀 세트, 페이지 세트 및 비디오 에셋으로 구성된 항목 세트입니다. 각 미디어 세트 항목에는 선택적 견본이 포함될 수도 있습니다.

비디오 집합

간단한 비디오 목록으로 구성된 항목 세트입니다.

외부 집합 유형 감지

다음의 경우 req=set 요청이 수신되면 생성할 응답 유형이 다음 값에 의해 결정됩니다. catalog::AssetType. If catalog::AssetType 가 정의되지 않은 경우 응답 유형은 다음 규칙에 의해 결정됩니다.

  • 이미지 카탈로그에 레코드가 있는 경우 및 catalog::ImageSet 정의됨

    • 레코드 이미지 집합 필드의 하나 이상의 항목에 콜론이 포함된 경우 전자 카탈로그가 설정되었다고 가정
    • 레코드 이미지 집합 필드의 하나 이상의 항목에 두 개의 세미콜론이 포함된 경우 미디어 집합이 있다고 가정합니다.
    • 레코드 이미지 집합 필드의 하나 이상의 항목에 하나의 세미콜론이 포함된 경우 이미지 집합을 가정합니다.
    • 콜론과 세미콜론을 포함하는 항목은 없지만 하나 이상의 항목에 참조된 집합이나 인라인 집합(2D 회전 집합)이 포함된 경우 회전 집합을 가정합니다.
    • 콜론 또는 세미콜론이 포함되어 있지 않고 참조된 집합과 인라인 집합(즉, 쉼표로 구분된 이미지 목록)이 없는 경우 알 수 없는 집합으로 간주합니다.
  • 이미지 및 정적 콘텐츠 카탈로그 모두에서 레코드가 발견되는 경우

    • 파일 확장명이 mp3, mp4, flv, f4v, swf, xml인 경우 비디오를 가정합니다.
    • 그렇지 않으면 이미지 저장
  • 정적 콘텐츠 카탈로그에 레코드가 있지만 이미지 카탈로그에는 없는 경우

    • 파일 확장명이 mp3, mp4, flv, f4v, swf, xml인 경우 비디오를 가정합니다.
    • 그렇지 않으면 정적 가정
  • 의 레코드가 이미지 카탈로그에 있지만 정적 콘텐츠 카탈로그에 없는 경우

    • 이미지 가정
  • 이미지 카탈로그에 레코드가 없고 정적 콘텐츠 카탈로그에 레코드가 없는 경우

    • 파일 확장명이 mp3, mp4, flv, f4v, swf, xml인 경우 파일 기반 비디오를 가정합니다.
    • 그렇지 않으면 파일 기반 이미지 가정

모든 경우 결과 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 사양

반환된 xml 응답은 다음 사양을 따릅니다.

http://crc.scene7.com/is-docs/examples/mediaset.dtd

LabelKey

다음 labelkey= 한정자는 catalog::UserData이미지 및 견본의 레이블을 생성하는 필드입니다. 다음 catalog:UserData 필드는 키/값 쌍 세트로 구문 분석되고 labelkey는 지정된 키에 대한 값을 검색하기 위해 이 세트에 를 인덱싱합니다. 그런 다음 이 값은 l 속성 si.

적용된 제한 사항

응답 크기를 제한하고 자체 참조 문제를 방지하기 위해 최대 중첩 깊이는 서버 속성에 의해 제어됩니다 PS::fvctx.nestingLimit. 이 한도를 초과하면 오류가 반환됩니다.

대형 전자 카탈로그 세트에 대한 xml 응답의 크기를 제한하기 위해 서버 속성에 따라 브로셔 세트 항목에 대한 비공개 메타데이터가 억제됩니다 PS::fvctx.brochureLimit. 브로셔 제한에 도달할 때까지 브로셔와 연결된 모든 비공개 메타데이터를 내보냅니다. 제한이 초과되면 비공개 맵과 사용자 데이터가 억제되고, 억제된 데이터 유형을 나타내는 해당 플래그가 설정됩니다.

중첩된 미디어 세트는 지원되지 않습니다. 중첩된 미디어 집합은 미디어 집합 유형의 미디어 집합 항목을 포함하는 미디어 집합으로 정의됩니다. 이 조건이 감지되면 오류가 반환됩니다.

예제

샘플 XML 응답 req=set 요청하려면 HTML 예 헤더 아래의 속성 페이지를 참조하십시오.

http://crc.scene7.com/is-docs/examples/properties.htm

참조

req= , 이미지 집합=, catalog::ImageSet, 이미지 카탈로그 참조

이 페이지의