createAssetSet

建立一般資產集,其中包含要發佈至影像伺服器的原始集定義字串。

語法

授權的使用者類型

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

參數

輸入(createAssetSet)

名稱 類型 必要 說明
companyHandle xsd:string 將包含資產集之公司的控制代碼。
folderHandle xsd:string 將在其中建立新資產集的資料夾的控制代碼。
名稱 xsd:string 資產名稱。
subType 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>

本頁內容