createDerivedAsset

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.

Tipos de usuarios autorizados

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

Parámetros

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.

Ejemplos

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>

En esta página