...
Usage des variations dans le DAM WEDIA
Les variations sont utilisées à différents niveaux dans le DAM :
En backoffice et en front office pour proposer des options de téléchargements et de visualisation. Elles sont donc accessible à l'aide d'une API Java côté serveur et à travers une API Rest côté client mise à disposition par le plugin *WXM_VARIATIONS* et accessible sous le chemin /api/wedia/cart.
Dans les tableaux ( paniers ) pour créer des profils de zips ( zips des originaux, de previews ).
accessibles en http à l’aide de l’api /api/wedia/dam/variation servie par le plugin WXM_VARIATIONS_API.
La syntaxe générale d’appel est /api/wedia/dam/variation/<asset>/<variations>.
<asset> peut être spécifié deux deux manières <type>/<id> ou plus récémment ( 11.26+ ) par son uuid <uuid>.
<variations> est une liste de noms de variations séparés par des virgules et triés par préférence descendante. ex : thumbnail,watermark,poster,default. Cette liste est évaluée de gauche à droite. La première variation qui est à la fois disponible et autorisée est retournée au demandeur.
La liste des variations disponibles et autorisées pour un asset peut être interrogée par l’api /api/wedia/dam/variations/<asset>.
La liste de toutes les variations disponibles pour un asset peut être interrogée par l’api /api/wedia/dam/admin/variations/<asset> ce qui permet d'évaluer les variations disponibles sans prendre en compte la sécurité ( nécessite des droits d’administration ).
A partir de la version 2021.3, il est possible de configurer ce chainage de variations pour différents composants du DAM :
Preview dans les listes du backoffice : deux paramètres sont disponibles dans le nouveau plugin WXM_BO_OPTIONS :
...
com.wedia.dam.LIST_VARIATIONS donne le chainage à utiliser pour les navigateurs ne supportant pas encore le webp. Pour les navigateurs plus modernes, le backoffice utilise com.wedia.dam.LIST_VARIATIONS(Accept: image/webp). Le choix de l’option est fait dans la page /bov3/common/init/init.jsp.
Le chainage utilisés dans les paniers du backoffice hérite de ces paramètres mais peut historiquement être surchargé dans le plugin WXM_CART2.
...
En passant en 2021.3, ce paramètre risque d'être renseigné et de surcharger la configuration générale. Pour harmoniser le comportement dans le Backoffice : pensez à vider la valeur de ce paramètre.
Les prévisualisations en dataview / dataedit sont généralement faites par MediaCloud qui a sa propre configuration. Cette dernière peut être pilotée par la configuration EVP dans l’administration WEDIA /admin/ebnAdministration.ebn
...
Intégration
Lister les variations disponibles d'un asset
...
Pour les formats vidéos : il faudra configurer le config client EVP pour proposer des
formats additionnels.
Pour les variations ne nécessitant que le binaire original, il est possible d'implémenter
un Preset apportant nativement la gestion d'un cache évitant de refaire systématiquement
le même traitement ou de configurer des presets automatiques via la configuration des APIs
Rest DAM ( cf Presets )
Pour les variations nécessitant des propriétés de l'asset, il faudra directement implémenter
les interfaces dans un plugin.
| Code Block |
|---|