DocumentatieDynamic Media Image Production System-API

createDerivedAsset createderivedasset

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ontwikkelaar
  • Beheerder

Hiermee maakt u een nieuw element dat is afgeleid van een bestaand primair bronafbeeldingselement.

Syntaxis

Afgeleide activa specificeren het protocolbevelen van de Server van het Beeld die de vertegenwoordiging van het eigenaarbeeld wijzigen. Met het afgeleide type van AdjustedView kunt u eenvoudige wijzigingen toepassen op één afbeelding (bijvoorbeeld door een uitsnijdrechthoek op te geven), terwijl met de LayerView een weergave met meerdere lagen wordt gemaakt die tekst of extra afbeeldingen kan bevatten.

In tegenstelling tot een beeldexemplaar (zie ​ copyImage ​), wordt een afgeleid beeld verbonden met zijn eigenaarbeeld. Door wijzigingen in de afbeelding van de eigenaar worden gekoppelde afgeleide elementen gewijzigd. Als u de eigenaarafbeelding verwijdert, worden alle gekoppelde afgeleide afbeeldingen verwijderd.

Geautoriseerde gebruikerstypen authorized-user-types

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

Parameters section-5a0dde01cff6454da3646ea805c2be1e

Input (createDerivedAssetParam)

Naam
Type
Vereist
Beschrijving
companyHandle
xsd:string
Ja
De handgreep naar het bedrijf dat het element bevat waaruit u het nieuwe element afleidt.
ownerHandle
xsd:string
Ja
De handgreep van het primaire afbeeldingselement waaruit de nieuwe afbeelding is afgeleid.
folderHandle
xsd:string
Ja
De handgreep naar de map waarin het nieuwe afgeleide element wordt gemaakt.
name
xsd:string
Ja
De naam van het afgeleide element.
type
xsd:string
Ja
Het elementtype van het nieuwe afgeleide element: AdjustedView of LayerView .
urlModifier
xsd:string
Nee
Het beeld dat of beeld teruggeeft protocolbevelen die worden toegepast vóór het verzoek of urlPostApplyModifier bevelen.
urlPostApplyModifier
xsd:string
Nee
Beeld die of beeld teruggeven protocolbevelen worden toegepast na op het verzoek of urlPostApplyModifier bevelen.

Output (createDerivedAssetParam)

Naam
Type
Vereist
Beschrijving
assetHandle
xsd:string
Ja
De handgreep van het afgeleide element.

Voorbeelden section-5d5ea893a1ef4edc8b3a396f1936e8c9

De voorbeeldcode maakt een afgeleid element met een aangepaste weergave en urlModifier en urlPostApplyModifier met willekeurige waarden. De reactie retourneert de greep naar het nieuwe element.

Verzoek

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

Reactie

<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