createDerivedAsset createderivedasset

Crée une nouvelle ressource dérivée d’une ressource d’image source 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 type dérivé AdjustedView permet d’appliquer des modifications simples à une seule image (par exemple, en spécifiant un rectangle de recadrage), tandis que le LayerView permet de créer une vue multicouche qui peut 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 authorized-user-types

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

Paramètres section-5a0dde01cff6454da3646ea805c2be1e

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étenez la nouvelle ressource.
ownerHandle
xsd:string
Oui
Gestion de la ressource 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.
nom
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
Les commandes de protocole de traitement des images ou de rendu des images ont été appliquées avant les commandes de requête ou de urlPostApplyModifier.
urlPostApplyModifier
xsd:string
Non
Les commandes de protocole de traitement d’images ou de rendu d’images ont été appliquées après aux commandes de requête ou urlPostApplyModifier.

Output (createDerivedAssetParam)

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

Exemples section-5d5ea893a1ef4edc8b3a396f1936e8c9

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.

Requête

<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>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681