createDerivedAsset createderivedasset

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 tipo derivato AdjustedView 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
Handle dell'azienda che contiene la risorsa da cui si ottiene la nuova risorsa.
ownerHandle
xsd:string
Handle della risorsa immagine principale da cui deriva la nuova immagine.
folderHandle
xsd:string
Handle della cartella in cui viene creata la nuova risorsa derivata.
nome
xsd:string
Nome della risorsa derivata.
tipo
xsd:string
Tipo di risorsa della nuova risorsa derivata: AdjustedView o LayerView.
urlModifier
xsd:string
No
I comandi del protocollo Image Server o Image Rendering hanno applicato prima della richiesta o urlPostApplyModifier comandi.
urlPostApplyModifier
xsd:string
No
Comandi del protocollo Image Server o Image Rendering applicati dopo alla richiesta o urlPostApplyModifier comandi.

Output (createDerivedAssetParam)

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

Esempi section-5d5ea893a1ef4edc8b3a396f1936e8c9

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

Richiesta

<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