미디어 집합 요청 media-set-requests

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

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

요청 구문 section-d72b1d95e4ce4bb1b332ce096c2b99f1

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

집합 응답 유형 section-93eb0a1f70344da2a888e56372ad3896

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

단순 이미지
없는 이미지 레코드 catalog::ImageSet 정의됨.
간단한 비디오
정적 콘텐츠 카탈로그의 비디오 레코드입니다.
견본 집합
이미지 레코드에 대한 참조와 견본으로 사용되는 이미지 레코드에 대한 선택적 개별 참조로 구성된 항목 세트입니다.
계층 견본 집합
기본 견본 항목 또는 견본 집합 레코드에 대한 참조로 구성된 항목 집합입니다.
스핀 세트
간단한 이미지 ID 목록으로 구성된 항목 세트입니다.
이차원 스핀 세트
단순 이미지 또는 기본 회전 세트에 대한 참조로 구성된 항목 세트입니다.
페이지 세트
최대 3개의 페이지 이미지 목록으로 구성된 항목 세트
미디어 세트
단순 이미지, 비디오 세트, 견본 세트, 계층 구조 견본 세트, 스핀 세트, 2차원 스핀 세트, 페이지 세트 및 비디오 에셋으로 구성된 항목 세트입니다. 각 미디어 세트 항목에는 선택적 견본이 포함될 수도 있습니다.
비디오 집합
간단한 비디오 목록으로 구성된 항목 세트입니다.

외부 집합 유형 감지 section-3dd6e453528d46898e559d31458a59ba

다음의 경우 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 문서를 준수합니다.

내부 집합 유형 감지 section-8f46490e467247e69ce284704def06f3

외부 세트가 유형 미디어 세트로서 검출될 때, 응답은 각각의 미디어 세트 엔트리에 대응하는 미디어 세트 아이템들의 세트를 포함한다 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 사양 section-c1bd60948ef545759a16885bb6fcc607

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

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

LabelKey section-bf565de6f7294cf89620343c9071f415

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

적용된 제한 사항 section-b9f042873bee45a5ae11b69fd42f2bca

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

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

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

예제 section-588c9d33aa05482c86cd2b1936887228

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

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

참조 section-625ec466c948476e800dc0c52a4532d3

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

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49