DocumentationAEMAPI du système d’exploitation d’images Dynamic Media

createDerivedAsset createderivedasset

Dernière mise à jour : 14 juillet 2026

Créé pour :

  • Developer
  • Admin

Crée une ressource dérivée d’une ressource d’image source principale existante.

Syntaxe

Les ressources dérivées spécifient les commandes de protocole du serveur d’images qui modifient la représentation de l’image du propriétaire. Le type dérivé de 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 un affichage 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

Input (createDerivedAssetParam)

Nom
Type
Obligatoire
Description
companyHandle
xsd:string
Oui
Identifiant de la société qui contient la ressource à partir de laquelle vous obtenez la nouvelle ressource.
ownerHandle
xsd:string
Oui
Pointez sur la ressource d’image principale à partir de laquelle la nouvelle image est dérivée.
folderHandle
xsd:string
Oui
La poignée 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 diffusion ou de rendu d’image appliquées avant les commandes request ou urlPostApplyModifier.
urlPostApplyModifier
xsd:string
Non
Commandes de protocole de diffusion ou de rendu d’image appliquées après aux commandes request ou urlPostApplyModifier.

Output (createDerivedAssetParam)

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

Exemples section-5d5ea893a1ef4edc8b3a396f1936e8c9

L’exemple de code crée une ressource dérivée avec une vue et une urlModifier ajustées, 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
dynamic-media-developer-resources-help-aem-ips-api