使用要發佈至影像伺服器的原始集定義字串建立一般資產集。
語法
IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser
輸入(createAssetSet)
名稱 | 類型 | 必要 | 說明 |
---|---|---|---|
companyHandle | xsd:string | 是 | 將包含資產集的公司的控制代碼。 |
folderHandle | xsd:string | 是 | 建立新資產集所在資料夾的控制代碼。 |
名稱 | xsd:string | 是 | 資產名稱。 |
子型別 | xsd:string | 是 | 使用者端為資產集型別建立的唯一識別碼。 |
setDefinition | xsd:string | 否 | 集合定義字串中的引數。 這些格式必須解析成目標檢視器指定的格式。 |
thumbAssetHandle | xsd:string | 否 | 資產的控制代碼,可作為新影像集的縮圖。 如果未指定,IPS會嘗試使用集合所參考的第一個影像資產。 |
setDefinition的替代函式
您可以在行中指定在目錄查閱或發佈期間解析的替代函式。 替代字串的格式為 ${<substitution_func>}
. 可用的函式列示如下。
引數清單中的控制代碼常值必須以方括弧括住 ([])
. 解析期間,替代字串以外的所有文字都會逐字複製到輸出字串中。
替代函式 | 傳回 |
---|---|
getFilePath([asset_handle>]) |
資產的主要來源檔案路徑。 |
getCatalogId([<asset_handle>]) |
資產的目錄ID。 |
getMetaData([<asset_handle>], [<metadata_field_handle>]) |
資產的中繼資料值。 |
getThumbCatalogId([<asset_handle>]) |
資產的目錄ID (僅適用於影像型資產)。關聯的縮圖資產的目錄ID (適用於其他資產)。 如果關聯的縮圖資產無法使用,此函式會傳回空字串。 |
範例媒體setDefinition字串
${getCatalogId([a|1664|22|1664])};${getCatalogId([a|1664|22|1664])};1,${getFilePath([a|103
6|19|144])};${getCatalogId([a|452|1|433])};2;${getMetadata([a|1036|19|144], [m|1|ASSET|SharedDateField])}
在目錄查閱或發佈時,這會解析為類似於以下內容的字串:
jcompany/myRenderSet;jcompany/myRenderSet;1,jcompany/Videos/Somebodys_N08275_flv.flv;jcomp any/myimg-1;2;20090703 10:05:53
輸出(createAssetSet)
名稱 | 類型 | 必要 | 說明 |
---|---|---|---|
assetHandle | xsd:string |
是 | 資產集的控點。 |
請求
<createAssetSetParam xmlns="http://www.scene7.com/IpsApi/xsd/2009-07-31">
<companyHandle>c|1</companyHandle>
<folderHandle>f|jcompany/AssetSets/</folderHandle>
<name>testAssetSet</name>
<subType>MediaSet</subType>
</createAssetSetParam>
回答
<createAssetSetReturn xmlns="http://www.scene7.com/IpsApi/xsd/2009-07-31">
<assetHandle>a|1801|44|1801</assetHandle>
</createAssetSetReturn>