Crea un nuevo recurso derivado de un recurso de imagen de origen principal existente.
Sintaxis
Los recursos derivados especifican comandos de protocolo del servidor de imágenes que modifican la representación de la imagen del propietario. La variable AdjustedView
el tipo derivado ayuda a aplicar modificaciones simples a una sola imagen (por ejemplo, especificando un rectángulo de recorte), mientras que la variable LayerView
ayuda a crear una vista de varias capas que puede incluir texto o imágenes adicionales.
A diferencia de una copia de imagen (consulte copyImage), una imagen derivada está vinculada a su imagen de propietario. Los cambios realizados en la imagen del propietario modifican los recursos derivados asociados. Al eliminar la imagen del propietario, se eliminarán las imágenes derivadas asociadas.
IpsUser
IpsAdmin
IpsCompanyAdmin
ImagePortalAdmin
ImagePortalContrib
ImagePortalContribUser
Entrada (createDerivedAssetParam)
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
companyHandle | xsd:string |
Sí | El identificador de la empresa que contiene el recurso del que derivará el nuevo recurso. |
ownerHandle | xsd:string |
Sí | El identificador del recurso de imagen principal del que se deriva la nueva imagen. |
folderHandle | xsd:string |
Sí | El identificador de la carpeta en la que se crea el nuevo recurso derivado. |
name | xsd:string |
Sí | Nombre del recurso derivado. |
tipo | xsd:string |
Sí | El tipo de recurso del nuevo recurso derivado: AdjustedView o LayerView . |
urlModifier | xsd:string |
No | Comandos de protocolo de servicio o representación de imágenes aplicados before la solicitud o urlPostApplyModifier comandos. |
urlPostApplyModifier | xsd:string |
No | Comandos de protocolo de servicio o representación de imágenes aplicados after a la solicitud o urlPostApplyModifier comandos. |
Salida (createDerivedAssetParam)
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
assetHandle | xsd:string |
Sí | El identificador del recurso derivado. |
El código de ejemplo crea un recurso derivado con una vista ajustada y urlModifier
y urlPostApplyModifier
con valores arbitrarios. La respuesta devuelve el identificador al recurso recién derivado.
Solicitar
<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>
Respuesta
<createDerivedAssetReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
<assetHandle>a|944|10|2</assetHandle>
</createDerivedAssetReturn>