DocumentatieDynamic Media Image Production System API

createDerivedAsset

Laatst bijgewerkt: 4 november 2023
  • 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. De AdjustedView afgeleide tekst helpt eenvoudige wijzigingen toe te passen op één afbeelding (bijvoorbeeld door een uitsnijdrechthoek op te geven), terwijl de LayerView Hiermee kunt u een weergave met meerdere lagen maken die tekst of extra afbeeldingen kan bevatten.

In tegenstelling tot een afbeeldingskopie (zie copyImage), is een afgeleide afbeelding gekoppeld aan de eigen afbeelding. 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

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

Parameters

Input (createDerivedAssetParam)

NaamTypeVereistBeschrijving
companyHandlexsd:stringJaDe handgreep naar het bedrijf dat het element bevat waaruit u het nieuwe element afleidt.
ownerHandlexsd:stringJaDe handgreep van het primaire afbeeldingselement waaruit de nieuwe afbeelding is afgeleid.
folderHandlexsd:stringJaDe handgreep naar de map waarin het nieuwe afgeleide element wordt gemaakt.
namexsd:stringJaDe naam van het afgeleide element.
typexsd:stringJaHet type actief van het nieuwe afgeleide actief: AdjustedView of LayerView.
urlModifierxsd:stringNeeOpdrachten van het protocol voor het renderen van afbeeldingen toegepast voor het verzoek of urlPostApplyModifier opdrachten.
urlPostApplyModifierxsd:stringNeeOpdrachten van het protocol voor het renderen van afbeeldingen toegepast na aan het verzoek of urlPostApplyModifier opdrachten.

Output (createDerivedAssetParam)

NaamTypeVereistBeschrijving
assetHandlexsd:stringJaDe handgreep van het afgeleide element.

Voorbeelden

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>

Antwoord

<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