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. El tipo derivado AdjustedView ayuda a aplicar modificaciones simples a una sola imagen (por ejemplo, especificando un rectángulo de recorte), mientras que el 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 derivará la nueva imagen.
*folderHandle* xsd:string Sí El identificador de la carpeta en la que se creará el nuevo recurso derivado.
*name* xsd:string Sí Nombre del recurso derivado.
*type* xsd:string Sí El tipo de recurso del nuevo recurso derivado: AdjustedView o LayerView.
*urlModifier* xsd:string No Los comandos de protocolo de servicio de imágenes o representación de imágenes aplicados antes de los comandos request o urlPostApplyModifier.
*urlPostApplyModifier* xsd:string No Los comandos de protocolo de servicio de imágenes o representación de imágenes se aplican después a los comandos request o urlPostApplyModifier.

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