createDerivedAsset createderivedasset

既存のプライマリ ソース画像アセットから派生した新しいアセットを作成します。

構文

派生アセットは、所有者イメージの表現を変更するImage Server プロトコルコマンドを指定します。 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
はい
派生アセットの名前。
タイプ
xsd:string
はい
新しい派生アセットのアセットタイプ : AdjustedViewまたはLayerView
urlModifier
xsd:string
いいえ
画像サービングまたは画像レンダリングプロトコルコマンドは、リクエストの​ ​またはurlPostApplyModifier コマンドを適用しました。
urlPostApplyModifier
xsd:string
いいえ
画像サービングまたは画像レンダリングプロトコルコマンドは、リクエストに​ after ​またはurlPostApplyModifier コマンドを適用しました。

Output (createDerivedAssetParam)

名前
種類
必須
説明
assetHandle
xsd:string
はい
派生アセットへのハンドル。

section-5d5ea893a1ef4edc8b3a396f1936e8c9

サンプルコードでは、調整されたビューとurlModifierおよびurlPostApplyModifierが任意の値を持つ派生アセットが作成されます。 応答は、新しく派生したアセットにハンドルを返します。

リクエスト

<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
dynamic-media-developer-resources-help-aem-ips-api