createDerivedAsset createderivedasset

建立衍生自現有主要來源影像資產的新資產。

語法

衍生資產會指定影像伺服器通訊協定命令,以修改擁有者影像的表示方式。 AdjustedView衍生型別有助於將簡單的修改套用至單一影像(例如,藉由指定裁切矩形),而LayerView則有助於建立可能包含文字或其他影像的多層檢視。

與影像復本(請參閱copyImage)不同,衍生的影像已連結至其擁有者影像。 所有者影像的變更會修改關聯的衍生資產。 刪除擁有者影像會刪除任何關聯的衍生影像。

授權的使用者型別 authorized-user-types

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

參數 section-5a0dde01cff6454da3646ea805c2be1e

輸入(createDerivedAssetParam)

名稱
類型
必要
說明
companyHandle
xsd:string
包含新資產之資產的公司的控制代碼。
ownerHandle
xsd:string
衍生新影像的主要影像資產的控點。
folderHandle
xsd:string
建立新衍生資產的資料夾的控制代碼。
name
xsd:string
衍生資產的名稱。
type
xsd:string
新衍生資產的資產型別: AdjustedViewLayerView
urlModifier
xsd:string
影像伺服或影像演算通訊協定命令已在​ 要求或urlPostApplyModifier命令之前 ​套用。
urlPostApplyModifier
xsd:string
影像伺服或影像演算通訊協定命令已在​ 之後 ​套用到要求或urlPostApplyModifier命令。

輸出(createDerivedAssetParam)

名稱
類型
必要
說明
assetHandle
xsd:string
衍生資產的控點。

範例 section-5d5ea893a1ef4edc8b3a396f1936e8c9

範常式式碼會建立具有已調整檢視的衍生資產,以及具有任意值的urlModifierurlPostApplyModifier。 回應會將控制代碼傳回至新衍生的資產。

要求

<createDerivedAssetParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|6</companyHandle>
   <ownerHandle>a|943|1|580</ownerHandle>
   <folderHandle>ApiTestCo/</folderHandle>
   <name>ApiDerivedAsset</name>
   <type>AdjustedView</type>
   <urlModifier>modify=this</urlModifier>
   <urlPostApplyModifier>action=awesome</urlPostApplyModifier>
</createDerivedAssetParam>

回應

<createDerivedAssetReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <assetHandle>a|944|10|2</assetHandle>
</createDerivedAssetReturn>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681