createDerivedAsset

Última actualización: 2023-11-04
  • Creado para:
  • Developer
    Admin

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 eliminan todas 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 El identificador de la compañía que contiene el recurso del que se deriva el nuevo recurso.
ownerHandle xsd:string El identificador del recurso de imagen principal del que se deriva la nueva imagen.
folderHandle xsd:string El identificador de la carpeta en la que se crea el nuevo recurso derivado.
nombre xsd:string Nombre del recurso derivado.
tipo xsd:string 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 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