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