DokumentationDynamic Media Image Production System API

createDerivedAsset createderivedasset

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Utvecklare
  • Administratör

Skapar en ny resurs som härletts från en befintlig primär källbildresurs.

Syntax

Härledda resurser anger Image Server-protokollkommandon som ändrar representationen av ägarbilden. Med den härledda typen AdjustedView kan du göra enkla ändringar i en enskild bild (till exempel genom att ange en beskärningsrektangel), medan LayerView hjälper dig att skapa en vy med flera lager som kan innehålla text eller ytterligare bilder.

Till skillnad från en bildkopia (se copyImage) länkas en härledd bild till sin ägarbild. Ändringar av ägarbilden ändrar associerade härledda resurser. Om du tar bort ägarbilden tas alla associerade härledda bilder bort.

Auktoriserade användartyper authorized-user-types

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

Parametrar section-5a0dde01cff6454da3646ea805c2be1e

Indata (createDerivedAssetParam)

Namn
Typ
Obligatoriskt
Beskrivning
companyHandle
xsd:string
Ja
Handtaget till det företag som innehåller den tillgång som du härleder den nya tillgången från.
ownerHandle
xsd:string
Ja
Handtaget till den primära bildresurs som den nya bilden kommer från.
folderHandle
xsd:string
Ja
Referensen till mappen där den nya härledda resursen skapas.
name
xsd:string
Ja
Namnet på den härledda tillgången.
type
xsd:string
Ja
Tillgångstypen för den nya härledda resursen: AdjustedView eller LayerView.
urlModifier
xsd:string
Nej
Avbildningsservning eller bildåtergivningsprotokollkommandon tillämpade före begäran eller urlPostApplyModifier kommandon.
urlPostApplyModifier
xsd:string
Nej
Avbildningsservning eller bildåtergivningsprotokollkommandon som har använts efter på begäran eller urlPostApplyModifier kommandon.

Utdata (createDerivedAssetParam)

Namn
Typ
Obligatoriskt
Beskrivning
assetHandle
xsd:string
Ja
Referensen till den härledda tillgången.

Exempel section-5d5ea893a1ef4edc8b3a396f1936e8c9

Exempelkoden skapar en härledd resurs med en justerad vy och urlModifier och urlPostApplyModifier med godtyckliga värden. Svaret returnerar referensen till den nyligen härledda resursen.

Begäran

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

Svar

<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