Image Serving提供了一種獲取層次文本響應(xml或json)的機制,該響應表示與特定記錄的目錄::ImageSet關聯的所有資源和元資料。
觀看者可以使用此機制來生成響應,以通知簡單影像、視頻、視頻集、色板集、旋轉集、頁集(e目錄)和媒體集的呈現。
為 catalog::ImageSet
可使用 req=set
修改量並引用淨路徑中的目錄記錄id。 或者,可以使用 imageset=
修改量。 如果 imageset=
修飾符用於指定影像集,應將整個值括在大括弧中,以轉義影像集值,並確保所有包含的修飾符不被解釋為URL查詢字串的一部分。
設定機制支援以下類型的響應:
簡單影像 |
沒有 目錄::ImageSet 定義。 |
簡單的視頻 |
靜態內容目錄中的視頻記錄。 |
樣本集 |
一組項,包括對影像記錄的引用和對用作樣本的影像記錄的可選單獨引用。 |
分層樣本集 |
由基本色板項或對色板集記錄的引用組成的一組項。 |
自旋集 |
由簡單影像ID清單組成的一組項。 |
二維自旋集 |
一組由簡單影像或對基本自旋集的引用組成的項目。 |
頁集 |
由最多三張頁面影像的清單組成的一組項目 |
媒體集 |
一組由簡單影像、視頻集、色板集、分層色板集、旋轉集、二維旋轉集、頁集和視頻資產組成的項目。 每個媒體集項目也可包含可選色板。 |
視頻集 |
一組由簡單視頻清單組成的項目。 |
當 req=set
接收請求,由生成的響應的值確定 catalog::AssetType
。 如果 catalog::AssetType
未定義,則響應類型由以下規則確定:
如果在映像目錄AND中找到記錄 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
欄位被解析為一組鍵/值對,並且此集中的labelkey索引將檢索給定鍵的值。 然後,在 l
屬性 s
和 i
。
為了限制響應的大小並防止自引用問題,最大嵌套深度由伺服器屬性控制 PS::fvctx.nestingLimit
。 如果超過此限制,則返回錯誤。
為了限制大型電子目錄集的xml響應的大小,根據伺服器屬性對小冊子集項抑制專用元資料 PS::fvctx.brochureLimit
。 與手冊關聯的所有私有元資料都會導出,直到手冊限制達到為止。 在超出該限制後,禁止私有映射和用戶資料,並設定相應標誌以指示禁止哪種類型的資料。
不支援嵌套媒體集。 嵌套媒體集定義為包含媒體集類型的媒體集項的媒體集。 如果檢測到此情況,則返回錯誤。
對於的XML響應示例 req=set
請求,請參閱「HTML示例」標題下的「屬性」頁。
http://crc.scene7.com/is-docs/examples/properties.htm
請求= 。 映像集=。 目錄::ImageSet。 影像目錄引用