createDerivedAsset

Ultimo aggiornamento: 2023-11-03
  • 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

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

Parametri

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 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 Handle della risorsa derivata.

Esempi

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>

In questa pagina