「影像伺服」提供擷取階層文字回應(xml或json)的機制,此回應代表與目錄::ImageSet特定記錄相關的所有資源和中繼資料。
檢視器可使用此機制產生回應,以通知簡單影像、視訊、視訊集、色票集、回轉集、頁面集(e-catalog)和媒體集的簡報。
使用req=set
修飾詞並參考淨路徑中的目錄記錄ID,可以檢索catalog::ImageSet
的設定響應。 或者,您也可以使用imageset=
修飾元,直接在URL中指定影像集。 如果使用imageset=
修飾元來指定影像集,則整個值應以大括弧括住,以逸出影像集值,並確保所包含的修飾元不會解讀為URL查詢字串的一部分。
set機制支援以下類型的響應:
簡單影像 |
未定義目錄的影像記錄::ImageSet。 |
簡單影片 |
靜態內容目錄中的視訊記錄。 |
色票集 |
一組項目,包括對影像記錄的引用和對用作色票的影像記錄的可選單獨引用。 |
層次色票集 |
一組由基本色票項目或對色票集記錄的引用組成的項目。 |
回轉集 |
一組項目,由簡單的影像ID清單組成。 |
二維自旋集 |
一組由簡單影像或基本旋轉集的引用組成的項目。 |
頁集 |
一組項目,包含最多3張頁面影像的清單 |
媒體集 |
一組項目,包括簡單影像、視訊集、色票集、階層式色票集、回轉集、二維回轉集、頁面集和視訊資產。 每個媒體集項目也可以包含一個可選色票。 |
影片集 |
一組由簡單影片清單組成的項目。 |
當接收到req=set
請求時,由catalog::AssetType
的值確定要生成的響應類型。 如果未定義catalog::AssetType
,則響應類型由以下規則確定:
如果在映像目錄中找到記錄,則定義catalog::ImageSet
如果在影像AND靜態內容目錄中都找到記錄
如果在靜態內容目錄中找到記錄,但在映像目錄中找不到記錄
如果在影像目錄中找到記錄,但在靜態內容目錄中找不到記錄
如果在映像目錄中找不到記錄,而在靜態內容目錄中找不到記錄
在所有情況下,產生的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回應符合下列規格:
http://crc.scene7.com/is-docs/examples/mediaset.dtd
labelkey=
修飾詞與catalog::UserData
欄位一起使用,以產生影像和色票的標籤。 catalog:UserData
欄位被解析為一組鍵/值對,並且該集中的標籤鍵索引用於檢索給定鍵的值。 然後,在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