DokumentationDynamic Media Image Production System-API

createabgeleiteteAsset createderivedasset

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Entwickler
  • 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. Der abgeleitete Typ AdjustedView hilft beim Anwenden einfacher Änderungen an einem einzelnen Bild (z. B. durch Angeben eines Zuschnittrechtecks), während der 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. 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

Input (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
Image Serving- oder Image Rendering-Protokollbefehle haben vor der Anfrage oder urlPostApplyModifier Befehlen angewendet.
urlPostApplyModifier
xsd:string
Nein
Image Serving- oder Image Rendering-Protokollbefehle wurden nach auf die Anfrage oder urlPostApplyModifier Befehle angewendet.

Output (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.

Anfrage

<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