メディアセット要求

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

ビューアはこのメカニズムを使用して応答を生成し、簡単な画像、ビデオ、ビデオセット、スウォッチセット、スピンセット、ページセット(eカタログ)およびメディアセットのプレゼンテーションを知らせることができます。

要求の構文

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

セット応答のタイプ

この設定メカニズムでは、次のタイプの応答がサポートされます。

単純な画像

catalog::ImageSetが定義されていない画像レコードです。

簡単なビデオ

静的コンテンツカタログ内のビデオレコード。

スウォッチセット

画像レコードへの参照と、スウォッチとして使用される画像レコードへのオプションの個別の参照から成る一連の項目です。

階層的スウォッチセット

基本的なスウォッチ項目またはスウォッチセットレコードへの参照で構成される項目のセットです。

スピンセット

画像IDの単純なリストから成る一連の項目。

2次元スピンセット

単純な画像または基本的なスピンセットへの参照から成る一連の項目です。

ページセット

最大3ページの画像から成るリストから成る一連の項目

メディアセット

単純な画像、ビデオセット、スウォッチセット、階層的スウォッチセット、スピンセット、2次元スピンセット、ページセットおよびビデオアセットから成る項目のセットです。 各メディアセット項目には、オプションのスウォッチを含めることもできます。

ビデオセット

単純なビデオのリストから成る一連の項目です。

外部セットの種類の検出

req=setリクエストを受け取ると、生成する応答のタイプはcatalog::AssetTypeの値によって決まります。 catalog::AssetTypeが定義されていない場合、応答タイプは次の規則によって決まります。

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

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

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

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

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

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

どのような場合でも、結果のxml応答は、検出された型に対応するset root nodeを持つ指定されたXMLドキュメントに準拠します。

内部セットタイプ検出

外側のセットがメディアセットの種類として検出されると、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パラメーターが指定されていない場合、またはサポートされていないタイプに対応する場合は、外側のsetレベルで適用されたのと同じルールを使用して、メディアセット項目タイプが自動検出されます。

XML仕様

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

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

LabelKey

labelkey=修飾子は、catalog::UserDataフィールドと共に使用して、画像およびスウォッチのラベルを生成します。 catalog:UserDataフィールドは、キー/値のペアのセットとして解析され、このセット内のlabelkeyインデックスによって、指定されたキーの値が取得されます。 次に、この値が​s​と​i​の​l​属性に返されます。

強制的な制限

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

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

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

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

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

関連項目

req= , imageset=, catalog::ImageSet, Image Catalog Reference

このページ