createDeriedAsset

Crea una nuova risorsa derivata da una risorsa immagine sorgente principale esistente.

Sintassi

Le risorse derivate specificano i comandi del protocollo Image Server che modificano la rappresentazione dell'immagine proprietaria. La AdjustedView il tipo derivato consente di applicare semplici modifiche a una singola immagine (ad esempio, specificando un rettangolo di ritaglio), mentre il 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. L'eliminazione dell'immagine del proprietario comporta l'eliminazione di tutte le immagini derivate associate.

Tipi di utenti autorizzati

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

Parametri

Input (createDeriedAssetParam)

Nome Tipo Obbligatorio Descrizione
companyHandle xsd:string Sì L’handle della società che contiene la risorsa da cui deriverai la nuova risorsa.
ownerHandle xsd:string Sì L’handle della risorsa immagine principale da cui deriva la nuova immagine.
folderHandle xsd:string Sì L’handle della cartella in cui viene creata la nuova risorsa derivata.
name xsd:string Sì Nome della risorsa derivata.
Testo xsd:string Sì Il tipo di risorsa della nuova risorsa derivata: AdjustedView o LayerView.
urlModifier xsd:string No Comandi applicati al protocollo di rendering delle immagini o di rendering delle immagini prima la richiesta o urlPostApplyModifier comandi.
urlPostApplyModifier xsd:string No Comandi applicati al protocollo di rendering delle immagini o di rendering delle immagini dopo alla richiesta o urlPostApplyModifier comandi.

Output (createDeriedAssetParam)

Nome Tipo Obbligatorio Descrizione
assetHandle xsd:string Sì L’handle della risorsa derivata.

Esempi

Il codice di esempio crea una risorsa derivata con una vista adeguata e urlModifier e urlPostApplyModifier con valori arbitrari. La risposta restituisce l'handle alla nuova risorsa 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