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. El AdjustedView
tipo derivado ayuda a aplicar modificaciones sencillas 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 pueden incluir texto o imágenes adicionales.
A diferencia de una copia de imagen (consulte copyImage), una imagen derivada está vinculada a su imagen propietaria. Los cambios en la imagen de propietario modifican los recursos derivados asociados. Al eliminar la imagen de propietario, se eliminarán todas 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 compañía 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. |
nombre | 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 del protocolo de servicio o procesamiento de imágenes aplicados antes la solicitud o urlPostApplyModifier comandos. |
urlPostApplyModifier | xsd:string |
No | Comandos del protocolo de servicio o procesamiento de imágenes aplicados después 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>