createabgeleiteteAsset

Letzte Aktualisierung: 2023-11-04
  • Erstellt für:
  • Developer
    Admin

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

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

Parameter

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

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>

Auf dieser Seite