설명서Dynamic Media 이미지 제공 및 렌더링 API

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

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 개발자
  • 사용자

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

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

요청 구문 section-d72b1d95e4ce4bb1b332ce096c2b99f1

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

집합 응답 유형 section-93eb0a1f70344da2a888e56372ad3896

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

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

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

req=set 요청이 수신되면 생성할 응답 유형이 catalog::AssetType 값에 의해 결정됩니다. 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 필드는 키/값 쌍의 집합으로 구문 분석되고 레이블 키는 지정된 키의 값을 검색하기 위해 이 집합에 대해 색인화됩니다. 이 값은 s 및 i ​에 대한 l 특성에서 반환됩니다.

적용된 제한 사항 section-b9f042873bee45a5ae11b69fd42f2bca

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

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

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

예제 section-588c9d33aa05482c86cd2b1936887228

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

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

참조 section-625ec466c948476e800dc0c52a4532d3

req= , imageset=, 카탈로그::ImageSet, 이미지 카탈로그 참조

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