createMetadataField

可讓管理員建立新的元資料欄位,以便與內容管理系統或模板操作協調。 建立的元資料欄位的範例包括關鍵字、關於影像作者的資訊或版權持有人資訊。

語法

授權的使用者類型

  • IpsAdmin

參數

輸入(createMetadataFieldParam)

參數名稱 類型 必要 說明
companyName xsd:string 中繼資料欄位所屬的公司名稱。
assetType xsd:string 資產類型.
名稱 xsd:string 您要建立的中繼資料欄位名稱。
fieldType xsd:string 中繼資料欄位類型。

中繼資料欄位類型常數會定義可用類型。

defaultValue xsd:string

要建立的元資料欄位的預設值(例如 Scene 7)。

標籤欄位類型不支援預設值,且必須省略。 如果為標籤欄位類型指定非空的預設值,則會傳回錯誤。

isHidden xsd:boolean 隱藏或公開IPS系統特定元資料。
isEnforced xsd:boolean

布林值標幟,指出設定值時是否強制(驗證)中繼資料欄位。

如果設為true,則如果在 setAssetMetadata / batchSetAssetMetadata中設定了非法值,則會擲回錯誤。

initialTagValue xsd:string 可讓您建立一組所選標籤可指向的共用枚舉值。

輸出(createMetadataFieldReturn)

名稱 類型 必要 說明
*fieldHandle* xsd:string 新中繼資料欄位的控點。

範例

此代碼示例建立名為createMetadataField的字串類型元資料欄位。 回應會將控點傳回新中繼資料欄位。

請求

<createMetadataFieldParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|21</companyHandle>
   <assetType>Image</assetType>
   <name>createMetadataField</name>
   <fieldType>String</fieldType>
   <initialTagValue>Fall</initialTagValue>
   <defaultValue>Default</defaultValue>
</createMetadataFieldParam>

回答

<createMetadataFieldReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <fieldHandle>m|21|IMAGE|createMetadataField</fieldHandle>
</createMetadataFieldReturn>

本頁內容