createDerivedAsset

Crée une ressource dérivée d’une ressource d’image Principale existante.

Syntaxe

Les ressources dérivées spécifient des commandes de protocole Image Server qui modifient la représentation de l’image du propriétaire. Le AdjustedView le type dérivé permet d’appliquer des modifications simples à une seule image (par exemple, en spécifiant un rectangle de recadrage), tandis que la variable LayerView permet de créer une vue multicouche pouvant inclure du texte ou des images supplémentaires.

Contrairement à une copie d’image (voir copyImage), une image dérivée est liée à son image propriétaire. Les modifications apportées à l’image du propriétaire modifient les ressources dérivées associées. La suppression de l’image du propriétaire supprime toutes les images dérivées associées.

Types d’utilisateurs autorisés

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

Paramètres

Entrée (createDerivedAssetParam)

Nom Type Obligatoire Description
companyHandle xsd:string Oui Gestionnaire de la société qui contient la ressource à partir de laquelle vous dérirez la nouvelle ressource.
ownerHandle xsd:string Oui Gestion de la ressource d’image Principale à partir de laquelle la nouvelle image est dérivée.
folderHandle xsd:string Oui Gestion du dossier dans lequel la nouvelle ressource dérivée est créée.
name xsd:string Oui Nom de la ressource dérivée.
type xsd:string Oui Type de ressource de la nouvelle ressource dérivée : AdjustedView ou LayerView.
urlModifier xsd:string Non Commandes de protocole de traitement d’images ou de rendu d’images appliquées before la demande ou urlPostApplyModifier des commandes.
urlPostApplyModifier xsd:string Non Commandes de protocole de traitement d’images ou de rendu d’images appliquées after à la requête ou urlPostApplyModifier des commandes.

Sortie (createDerivedAssetParam)

Nom Type Obligatoire Description
assetHandle xsd:string Oui Gestion de la ressource dérivée.

Exemples

L’exemple de code crée une ressource dérivée avec une vue ajustée et urlModifier et urlPostApplyModifier avec des valeurs arbitraires. La réponse renvoie la poignée à la ressource nouvellement dérivée.

Request

<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>

Réponse

<createDerivedAssetReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <assetHandle>a|944|10|2</assetHandle>
</createDerivedAssetReturn>

Sur cette page