createabgeleiteteAsset createderivedasset

Erstellt ein neues Asset, das von einem vorhandenen Bild-Asset aus der Primärquelle abgeleitet wurde.

Syntax

Abgeleitete Assets geben Image Server-Protokollbefehle an, mit denen die Darstellung des Eigentümerbilds geändert wird. Die AdjustedView abgeleiteter Typ hilft, einfache Änderungen an einem einzelnen Bild anzuwenden (z. B. durch Angabe eines Zuschnittrechtecks), während die LayerView hilft bei der Erstellung einer mehrschichtigen Ansicht, die Text oder zusätzliche Bilder enthalten kann.

Im Gegensatz zu Bildkopien (siehe copyImage), wird ein abgeleitetes Bild mit dem Bild des Eigentümers verknüpft. Änderungen am Bild des Eigentümers ändern verknüpfte abgeleitete Assets. Durch Löschen des Eigentümerbilds werden alle zugehörigen abgeleiteten Bilder gelöscht.

Autorisierte Benutzertypen authorized-user-types

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

Parameter section-5a0dde01cff6454da3646ea805c2be1e

Eingabe (createabgeleitedAssetParam)

Name
Typ
Erforderlich
Beschreibung
companyHandle
xsd:string
Ja
Der Handle für das Unternehmen, das das Asset enthält, von dem Sie das neue Asset ableiten.
ownerHandle
xsd:string
Ja
Das Handle zum primären Bild-Asset, von dem das neue Bild abgeleitet wird.
folderHandle
xsd:string
Ja
Der Handle für den Ordner, in dem das neue abgeleitete Asset erstellt wird.
name
xsd:string
Ja
Der Name des abgeleiteten Assets.
Typ
xsd:string
Ja
Der Asset-Typ des neuen abgeleiteten Assets: AdjustedView oder LayerView.
urlModifier
xsd:string
Nein
Auf Befehle zum Image Serving oder Image Rendering angewendet before die Anforderung oder urlPostApplyModifier Befehle.
urlPostApplyModifier
xsd:string
Nein
Auf Befehle zum Image Serving oder Image Rendering angewendet after auf die Anfrage oder urlPostApplyModifier Befehle.

Ausgabe (createabgeleitedAssetParam)

Name
Typ
Erforderlich
Beschreibung
assetHandle
xsd:string
Ja
Das Handle für das abgeleitete Asset.

Beispiele section-5d5ea893a1ef4edc8b3a396f1936e8c9

Der Beispielcode erstellt ein abgeleitetes Asset mit einer angepassten Ansicht und urlModifier und urlPostApplyModifier mit beliebigen Werten. Die Antwort gibt das Handle an das neu abgeleitete Asset zurück.

Anforderung

<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>

Antwort

<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