メディアセットリクエスト media-set-requests

画像サービングは、特定のレコードの catalog::ImageSet に関連付けられたすべてのリソースとメタデータを表す、階層テキスト応答(xml または json)を取得するメカニズムを提供します。

このメカニズムを使用して応答を生成し、単純な画像、ビデオ、ビデオセット、スウォッチセット、スピンセット、ページセット(e カタログ)、メディアセットに関する情報を表示できます。

リクエストの構文 section-d72b1d95e4ce4bb1b332ce096c2b99f1

に対する catalog::ImageSet を使用して取得できる req=set 修飾子を使用し、ネットパス内のカタログレコード id を参照します。 または、 imageset= 修飾子 次の場合、 imageset= modifier を使用して画像セットを指定します。画像セット値をエスケープし、含まれる修飾子が URL クエリ文字列の一部として解釈されないようにするには、値全体を中括弧で囲む必要があります。

セット応答のタイプ section-93eb0a1f70344da2a888e56372ad3896

設定メカニズムでは、次の種類の応答がサポートされています。

単純な画像
画像レコードに catalog::ImageSet 定義済み
簡単なビデオ
静的コンテンツカタログ内のビデオレコード。
スウォッチセット
画像レコードへの参照と、スウォッチとして使用される画像レコードへのオプションの個別の参照から成る一連の項目です。
階層的スウォッチセット
基本的なスウォッチ項目またはスウォッチセットレコードへの参照で構成される一連の項目。
スピンセット
画像 ID の単純なリストで構成される一連の項目。
2 次元スピンセット
単純な画像または基本的なスピンセットへの参照から成る一連の項目。
ページセット
最大 3 ページの画像のリストから成る一連の項目
メディアセット
単純な画像、ビデオセット、スウォッチセット、階層的なスウォッチセット、スピンセット、2 次元のスピンセット、ページセット、ビデオアセットから成る一連の項目です。 各メディアセット項目には、オプションのスウォッチを含めることもできます。
ビデオセット
シンプルなビデオのリストで構成される一連の項目です。

外部セットタイプの検出 section-3dd6e453528d46898e559d31458a59ba

When in an req=set リクエストを受信した場合、生成する応答のタイプは、 catalog::AssetType. 次の場合 catalog::AssetType が定義されていない場合、応答タイプは次のルールによって決定されます。

  • レコードが画像カタログ AND に見つかった場合 catalog::ImageSet が定義されている

    • レコード内の 1 つ以上のエントリにコロンが含まれている場合、e-catalog セットを想定する画像セットフィールドにコロンが含まれている
    • レコードの画像セットフィールド内の 1 つ以上のエントリに 2 つのセミコロンが含まれている場合、メディアセットを使用します。
    • レコード内の 1 つ以上のエントリにセミコロンが 1 つ以上含まれている場合、画像セットを使用します。
    • コロンやセミコロンを含むエントリがなく、少なくとも 1 つのエントリに参照セットまたはインラインセットが含まれる場合(これは 2D スピンセット)、スピンセットを想定します。
    • エントリにコロンやセミコロン、参照セット、インラインセット(画像のコンマ区切りリスト)が含まれていない場合は、不明なセットと見なします。
  • 画像と静的コンテンツカタログの両方にレコードが見つかった場合

    • ファイル拡張子が mp3、mp4、flv、f4v、swf、xml のセットの場合は、ビデオを想定します。
    • それ以外の場合は画像を仮定します
  • レコードが静的コンテンツカタログに見つかったが、画像カタログに見つからなかった場合

    • ファイル拡張子が mp3、mp4、flv、f4v、swf、xml のセットの場合は、ビデオを想定します。
    • それ以外の場合は静的と見なす
  • レコードが画像カタログに見つかったが、静的コンテンツカタログに見つからなかった場合

    • 画像を仮定
  • 画像カタログでレコードが見つからず、静的コンテンツカタログでレコードが見つからない場合

    • ファイル拡張子が mp3、mp4、flv、f4v、swf、xml の設定にある場合は、ファイルベースのビデオを想定します。
    • それ以外の場合はファイルベースの画像を想定する

どの場合でも、結果の XML 応答は、検出されたタイプに対応する set root ノードを持つ指定された XML ドキュメントに準拠します。

内部セットタイプの検出 section-8f46490e467247e69ce284704def06f3

外部セットがタイプメディアセットとして検出された場合、応答は、内の各メディアセットエントリに対応するメディアセット項目のセットを含む catalog::ImageSet. 特定のメディアセットエントリに対してオプションの type パラメーターが指定されている場合、次の表に従って出力タイプにマッピングされます。

入力タイプ
出力タイプ
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

特定のメディアセットエントリのオプションの type パラメーターが指定されていない場合、またはサポートされていないタイプに対応する場合、メディアセット項目タイプは、外部のセットレベルで適用されたのと同じルールを使用して自動検出されます。

XML 仕様 section-c1bd60948ef545759a16885bb6fcc607

返される xml 応答は、次の仕様に準拠しています。

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

LabelKey section-bf565de6f7294cf89620343c9071f415

The labelkey= 修飾子は、 catalog::UserData画像およびスウォッチのラベルを生成するためのフィールド。 The catalog:UserData フィールドはキーと値のペアのセットとして解析され、このセットの labelkey インデックスは特定のキーの値を取得します。 この値は、 l の属性 s および i.

強制された制限 section-b9f042873bee45a5ae11b69fd42f2bca

応答のサイズを制限し、自己参照的な問題を防ぐために、ネストの最大の深さは server プロパティで制御します PS::fvctx.nestingLimit. この制限を超えると、エラーが返されます。

大きな e カタログセットの xml 応答のサイズを制限するために、server プロパティに従って、パンフレットセット項目のプライベートメタデータは抑制されます PS::fvctx.brochureLimit. パンフレットの上限に達するまで、パンフレットに関連付けられているすべてのプライベートメタデータが書き出されます。 制限を超えた後、プライベートマップとユーザデータを抑制し、対応するフラグを設定して、抑制されたデータの種類を示す。

ネストされたメディアセットはサポートされていません。 ネストされたメディアセットは、メディアセットタイプのメディアセット項目を含むメディアセットとして定義されます。 この条件が検出された場合は、エラーが返されます。

section-588c9d33aa05482c86cd2b1936887228

XML 応答の例: req=set リクエストについては、「プロパティの例」ヘッダーの「HTML」ページ」を参照してください。

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

関連項目 section-625ec466c948476e800dc0c52a4532d3

req= , imageset=, catalog::ImageSet, 画像カタログ参照

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