createAssetSet

使用原始集定義字串建立要發佈到映像伺服器的常規資產集。

語法

授權用戶類型

  • IpsUser
  • IpsAdmin
  • IpsCompanyAdmin
  • ImagePortalAdmin
  • ImagePortalContrib
  • ImagePortalContribUser

參數

輸入(createAssetSet)

名稱 類型 必要 說明
公司句柄 xsd:string 是 包含資產集的公司的句柄。
folderHandle xsd：字串 是 建立新資產集的資料夾的句柄。
名稱 xsd：字串 是 資產名稱。
子類型 xsd：字串 是 客戶端為資產集類型建立的唯一標識符。
setDefinition xsd：字串 否 集定義字串中的參數。

必須解析為目標查看器指定的格式。

拇指資產句柄 xsd：字串 否 用作新影像集縮略圖的資產的句柄。 如果未指定，IPS將嘗試使用該集引用的第一個影像資源。

setDefinition的替代函式

您可以在目錄查找或發佈期間解析的行中指定替代函式。 替代字串的格式 ${<substitution_func>}。 下面列舉了可用的函式。

注意

參數清單中的句柄文字必須用括弧括起來 ([])。 在解析期間，替換字串之外的所有文本將逐字複製到輸出字串。

替代函式 返回
getFilePath([asset_handle>]) 資產的主源檔案路徑。
getCatalogId([<asset_handle>]) 資產的目錄ID。
getMetaData([<asset_handle>], [<metadata_field_handle>]) 資產的元資料值。
getThumbCatalogId([<asset_handle>]) 資產的目錄ID（僅適用於基於映像的資產）。關聯的拇指資產的目錄ID（適用於其他資產）。 如果關聯的拇指資產不可用，則函式返回空字串。

媒體集定義字串示例

${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)

名稱 類型 必要 說明
資產句柄 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>

本頁內容