DocumentazioneAPI di Dynamic Media Image Production System

createDerivedAsset createderivedasset

Last update: Fri Nov 03 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Developer
  • Admin

Crea una nuova risorsa derivata da una risorsa immagine di origine principale esistente.

Sintassi

Le risorse derivate specificano i comandi del protocollo Image Server che modificano la rappresentazione dell'immagine proprietaria. Il AdjustedView il tipo derivato consente di applicare semplici modifiche a una singola immagine (ad esempio, specificando un rettangolo di ritaglio), mentre LayerView consente di creare una visualizzazione a più livelli che può includere testo o immagini aggiuntive.

A differenza di una copia immagine (vedi copyImage), un'immagine derivata è collegata all'immagine proprietaria. Le modifiche all’immagine del proprietario modificano le risorse derivate associate. Se si elimina l'immagine del proprietario, verranno eliminate anche le eventuali immagini derivate associate.

Tipi di utenti autorizzati authorized-user-types

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

Parametri section-5a0dde01cff6454da3646ea805c2be1e

Input (createDerivedAssetParam)

Nome
Tipo
Obbligatorio
Descrizione
companyHandle
xsd:string
Sì
Handle dell'azienda che contiene la risorsa da cui si ottiene la nuova risorsa.
ownerHandle
xsd:string
Sì
Handle della risorsa immagine principale da cui deriva la nuova immagine.
folderHandle
xsd:string
Sì
Handle della cartella in cui viene creata la nuova risorsa derivata.
nome
xsd:string
Sì
Nome della risorsa derivata.
tipo
xsd:string
Sì
Tipo di risorsa della nuova risorsa derivata: AdjustedView o LayerView.
urlModifier
xsd:string
No
Comandi applicati per il protocollo Image Server o per il rendering delle immagini prima di la richiesta o urlPostApplyModifier comandi.
urlPostApplyModifier
xsd:string
No
Comandi applicati per il protocollo Image Server o per il rendering delle immagini dopo alla richiesta o urlPostApplyModifier comandi.

Output (createDerivedAssetParam)

Nome
Tipo
Obbligatorio
Descrizione
assetHandle
xsd:string
Sì
Handle della risorsa derivata.

Esempi section-5d5ea893a1ef4edc8b3a396f1936e8c9

Il codice di esempio crea una risorsa derivata con una vista rettificata e urlModifier e urlPostApplyModifier con valori arbitrari. La risposta restituisce l’handle della risorsa appena derivata.

Request Contents (Richiesta contenuto)

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

Risposta

<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