createabgeleiteteAsset

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. Der abgeleitete Typ AdjustedView hilft beim Anwenden einfacher Änderungen an einem einzelnen Bild (z. B. durch Angabe eines Zuschnittrechtecks), während der Typ LayerView bei der Erstellung einer Mehrschichtansicht hilft, die Text oder zusätzliche Bilder enthalten kann.

Im Gegensatz zu einer Bildkopie (siehe copyImage) wird ein abgeleitetes Bild mit seinem Eigentümerbild verknüpft. Änderungen am Bild des Eigentümers ändern verknüpfte abgeleitete Assets. Wenn Sie das Bild des Eigentümers löschen, 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 Das Handle für den Ordner, in dem das neue abgeleitete Asset erstellt wird.
*name* xsd:string Ja Der Name des abgeleiteten Assets.
*type* xsd:string Ja Der Asset-Typ des neuen abgeleiteten Assets: AdjustedView oder LayerView.
*urlModifier* xsd:string Nein Image Serving- oder Image Rendering-Protokollbefehle wurden vor der Anforderung oder den Befehlen urlPostApplyModifier angewendet.
*urlPostApplyModifier* xsd:string Nein Image Serving- oder Image Rendering-Protokollbefehle, die nach auf die Anforderung oder urlPostApplyModifier-Befehle angewendet werden.

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