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

Créer une ressource dérivée createderivedasset

Last update: Fri Aug 15 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Développeur
  • Administration

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

Syntaxe

Les ressources dérivées spécifient les commandes du protocole Image Server qui modifient la représentation de l’image propriétaire. Le AdjustedView type dérivé 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 à l’image de son propriétaire. Les modifications apportées à l’image propriétaire modifient les ressources dérivées associées. La suppression de l’image propriétaire supprime 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
Handle de la société qui contient la ressource d’où provient la nouvelle ressource.
Poignée propriétaire
xsd:string
Oui
Poignée de la ressource d’image principale à partir de laquelle la nouvelle image est dérivée.
poignée de dossier
xsd:string
Oui
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.
Modificateur d’url
xsd:string
Non
Commandes du protocole de diffusion d’image ou de rendu d’image appliquées avant la ou urlPostApplyModifier les commandes.
urlPostApplyModifier
xsd:string
Non
Les commandes du protocole Image Server ou Image Rendering appliquées après à la ou urlPostApplyModifier aux commandes.

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 ajustée et urlModifier avec urlPostApplyModifier des valeurs arbitraires. La réponse renvoie la poignée à la ressource nouvellement dérivée.

Demander

<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