DocumentationAPI Système de production dʼimages Dynamic Media

createDerivedAsset createderivedasset

Last update: Sat Nov 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Developer
  • Admin

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. La variable 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 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
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 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.

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