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.
IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser
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. |
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>