[AEM_Assets]{class="badge positive" title="S’applique à AEM Assets)."}
Questions fréquentes sur Dynamic Media avec fonctionnalités OpenAPI new-dynaminc-media-apis-frequently-asked-questions
Dynamic Media avec les fonctionnalités OpenAPI (Open Application Programming Interface) fournit, transforme et gère les ressources multimédias enrichies (images, vidéos et autre contenu visuel) par le biais de points d’entrée d’API normalisés et conviviaux pour les développeurs. Ce guide de questions fréquentes répond aux questions les plus courantes sur le fonctionnement de ces fonctionnalités, ce qu’elles activent et comment les adopter.
Que sont les fonctionnalités de Dynamic Media avec OpenAPI ? what-are-dynamic-media-openapi-capabilities
Dynamic Media est un ensemble de services de diffusion et de transformation de médias qui optimisent, redimensionnent et effectuent automatiquement le rendu des ressources pour n’importe quel appareil, canal ou écran. Les fonctionnalités OpenAPI exposent ces services par le biais de spécifications d’API ouvertes et bien documentées, ce qui permet aux développeurs d’intégrer la diffusion de médias directement dans leurs propres applications, storefronts et expériences de contenu.
Comme les interfaces suivent la norme OpenAPI, elles s’auto-décrivent et sont prévisibles. Par conséquent, les équipes d’intégration peuvent découvrir les points d’entrée disponibles, comprendre les formats de requête et de réponse et générer du code client plus rapidement qu’avec des interfaces propriétaires non documentées.
Principaux avantages key-benefits
Les principaux avantages de Dynamic Media avec les fonctionnalités OpenAPI sont les suivants :
- Intégration normalisée : les points d’entrée compatibles OpenAPI facilitent la connexion des services multimédias aux applications et chaînes d’outils existantes.
- Transformation des médias à la demande : les Assets sont optimisées, redimensionnées et reformatées au moment de la demande, ce qui élimine la nécessité de stocker plusieurs variantes manuelles.
- Diffusion multicanal : une ressource unique peut être diffusée et adaptée à travers les expériences web, mobiles et connectées.
- Architecture découplée : la diffusion API-first s’aligne sur les piles technologiques découplées et composables.
- Développement plus rapide : les spécifications auto-descriptives accélèrent l’intégration, la génération de code client et les tests pour les équipes d’intégration.
Que puis-je faire avec les fonctionnalités de l’Open API Dynamic Media ? what-can-i-do
Vous pouvez demander des ressources multimédias à la demande, appliquer des transformations en temps réel telles que le recadrage, le redimensionnement et la conversion de format, et diffuser du contenu optimisé pour les expériences web, mobiles et connectées, le tout via des appels d’API normalisés.
En quoi les fonctionnalités OpenAPI diffèrent-elles de la diffusion Dynamic Media traditionnelle ? openapi-vs-traditional
La diffusion traditionnelle repose sur des modèles et des modèles d’URL prédéfinis. Les fonctionnalités OpenAPI ajoutent une interface programmatique normalisée qui facilite l’automatisation, l’intégration personnalisée et les architectures découplées (front-end découplé).
Ces fonctionnalités sont-elles adaptées aux architectures découplées et composables ? headless-composable
Oui. Étant donné que les médias sont récupérés et transformés par le biais d’API plutôt que par des modèles de page fixes, les fonctionnalités OpenAPI Dynamic Media s’intègrent naturellement dans les configurations de gestion de contenu découplé et de commerce composable, où le calque de présentation est séparé du contenu et des services.
Ai-je besoin de ressources de développement pour utiliser ces fonctionnalités ? developer-resources
L’intégration basée sur les API implique généralement que les développeurs connectent des points d’entrée à une application. Cependant, la spécification OpenAPI réduit cet effort en fournissant des définitions cohérentes, lisibles par la machine, qui prennent en charge la génération et les tests automatisés des clients.
Toutes les ressources du référentiel Experience Manager Assets as a Cloud Service sont-elles disponibles pour la recherche et la diffusion à l’aide de Dynamic Media avec des fonctionnalités OpenAPI ? assets-available-for-search
Non. Seules les version approuvée et la dernière version des ressources sont disponibles pour la recherche et la diffusion à l’aide de Dynamic Media avec les fonctionnalités OpenAPI. Les Assets qui n’ont pas été approuvées ou qui n’existent que dans des versions antérieures sont exclues de cette portée de recherche et de diffusion.
Deux conditions régissent l’affichage ou non d’une ressource dans le référentiel Experience Manager Assets as a Cloud Service :
- Statut d’approbation — la ressource doit être marquée comme approuvée. Assets encore en version brouillon ou en attente de révision ne sont pas exposées pour la recherche et la diffusion.
- Devise de la version — seule la dernière version d’une ressource approuvée est éligible. Les versions remplacées ou historiques ne sont pas renvoyées.
Cette définition de la portée est intentionnelle. Étant donné que seules les ressources approuvées et actuelles sont éligibles, la diffusion est limitée au contenu qui a passé l’étape de la révision de la gouvernance, ce qui garantit la cohérence de la marque sur tous les canaux et applications. Par conséquent, les expériences en aval qui utilisent des ressources via Dynamic Media avec des fonctionnalités OpenAPI font référence de manière fiable à un contenu vérifié et à jour plutôt qu’à des révisions non approuvées ou obsolètes.
Comment les administrateurs et administratrices peuvent-ils ou elles marquer les nouvelles ressources et les ressources existantes ajoutées à un dossier comme approuvées ? add-assets-to-folder-as-approved
Les administrateurs marquent les ressources nouvelles et existantes dans un dossier comme approuvées en configurant le dossier pour une approbation en bloc, puis en retraitant toutes les ressources préexistantes. Dans Adobe Experience Manager (AEM) Assets, le statut d’une ressource est régi par la propriété jcr:content/metadata/dam:status . Cette propriété contrôle si une ressource est traitée comme utilisable, bloquée ou en attente de révision dans la bibliothèque de ressources.
Les valeurs de cette propriété sont :
-
Approuvé — La ressource est validée et disponible pour utilisation, et est marquée d’une icône approuvée sur la carte de la ressource.
-
Rejetée — la ressource est bloquée et marquée avec un indicateur de rejet.
-
Modifications demandées — La ressource nécessite une révision et est traitée de la même manière qu’une ressource rejetée.
AEM Assets distingue le statut Approuvé à l’aide d’une icône approuvée disponible sur la carte des ressources, comme illustré dans les images suivantes pour les vues Administration et Ressources :
URL d’administration
Vue Assets
Pour approuver toutes les ressources d’un dossier, reportez-vous aux instructions sur la validation en masse des ressources dans un dossier. Il y a aussi une vidéo qui montre l’ensemble du processus.
Après avoir configuré un dossier pour l’approbation en masse, toutes les nouvelles ressources ajoutées au dossier sont automatiquement approuvées. Cela permet d’assurer un statut de validation cohérent dans l’ensemble du dossier sans nécessiter une révision manuelle de chaque nouveau chargement. Toutes les ressources existantes ne sont approuvées qu’après avoir été retraitées, car le retraitement réévalue la propriété dam:status par rapport à la configuration d’approbation en bloc du dossier. Voir Retraitement des ressources numériques pour obtenir des instructions sur la manière de retraiter les ressources. Si les administrateurs copient ou déplacent des ressources non approuvées à partir d’un autre dossier, ils doivent retraiter les ressources afin que les ressources déplacées héritent du statut approuvé .
AEM Assets marque la ressource comme Rejected chaque fois que l’administrateur spécifie les valeurs Rejected ou Changes requested, car les deux valeurs représentent un état non approuvé. AEM Assets distingue le statut Rejeté en utilisant l’option
De même, AEM Assets distingue le statut Rejeté dans la vue Assets à l’aide du statut Rejeté suivant sur la carte des ressources :
Comment pouvez-vous utiliser l’identifiant d’utilisateur ou d’utilisatrice ou l’identifiant de groupe Adobe IMS (Adobe Identity Management Services) pour définir les rôles sur les ressources dans la vue d’administration Experience Manager, afin de sécuriser l’expérience de diffusion et de recherche ? set-roles-secure-delivery-search
Les ID d’utilisateur et de groupe Adobe IMS (Adobe Identity Management Services) sont récupérés à partir d’Adobe Admin Console et appliqués dans le Experience Manager Assets Admin view pour définir des rôles qui sécurisent les expériences de diffusion et de recherche. L’affectation de rôles en fonction de ces ID d’utilisateur ou de groupe IMS garantit que seules des identités autorisées peuvent accéder à des ressources spécifiques, les diffuser ou les rechercher. Comme l’accès au niveau des ressources est régi par ces identités, l’utilisation de l’identifiant IMS correct est l’étape fondamentale de la sécurité basée sur les rôles dans Experience Manager.
Les utilisateurs et utilisatrices nécessitant l’accès à l’environnement de création sont gérés en tant qu’utilisateurs et utilisatrices Adobe IMS dans l’Adobe Admin Console. Découvrez ce que sont les utilisateurs et utilisatrices Adobe IMS et comment ils sont accessibles et gérés dans Admin Console en consultant Utilisateurs et utilisatrices Adobe IMS.
Mappage des identités IMS aux rôles des ressources :
- Les utilisateurs Adobe IMS représentent des personnes individuelles configurées et gérées de manière centralisée dans Adobe Admin Console, fournissant ainsi une source unique de vérité pour l’identité dans les applications Adobe Experience Cloud.
- Les groupes Adobe IMS permettent de gérer plusieurs utilisateurs ensemble, de sorte que les rôles et les autorisations puissent être appliqués de manière cohérente à un groupe plutôt qu’à chaque utilisateur individuellement.
- L’identifiant utilisateur ou identifiant de groupe obtenu à partir d’Admin Console est la valeur référencée lors de la configuration des rôles sur les ressources, en liant directement les autorisations de diffusion et de recherche à une identité gérée connue.
Comme les expériences de diffusion et de recherche sont régies par les rôles définis sur les ressources, il est essentiel de récupérer l’identifiant d’utilisateur ou de groupe Adobe IMS précis à partir d’Admin Console. Cette approche centralise la gestion des identités, réduit le risque d’accès non autorisé aux ressources et maintient les autorisations alignées sur la manière dont les identités sont déjà administrées dans l’environnement Adobe.
Pouvez-vous approuver plusieurs ressources simultanément dans un dossier ? approve-multiple-assets-in-folder
Oui. Adobe Experience Manager (AEM) Assets permet aux utilisateurs d’approuver plusieurs ressources simultanément au sein d’un dossier, rendant ainsi inutile l’approbation individuelle de chaque fichier. L’approbation en bloc simplifie les workflows de révision et permet de gagner un temps considérable lors de la gestion des bibliothèques de ressources volumineuses, car le statut de révision Approuvé est appliqué à chaque ressource sélectionnée en une seule action.
Deux méthodes sont prises en charge, selon l’interface que vous utilisez : la vue Assets Admin ou la vue Assets .
Approbation de plusieurs ressources dans la vue d’administration Assets
Exécutez les étapes suivantes pour approuver plusieurs ressources simultanément dans Experience Manager Assets Admin view :
- Sélectionnez les ressources et cliquez sur Propriétés.
- Dans l’onglet De base, faites défiler l’écran jusqu’à Statut de révision.
- Remplacez le statut de révision par Approuvé.
- Cliquez sur Enregistrer et fermer.
Le statut de révision Approuvé s’applique à chaque ressource sélectionnée en une seule fois, ce qui permet de confirmer et de fermer les modifications en une seule étape.
Approbation de plusieurs ressources dans la vue Assets
De même, pour approuver plusieurs ressources simultanément dans un dossier dans la vue Assets, procédez comme suit :
-
Sélectionnez la ou les ressources, puis cliquez sur Modifier les métadonnées en masse.
-
Sélectionnez Approuvé dans le champ Statut disponible dans la section Propriétés du volet de droite.
-
Cliquez sur Enregistrer.
Cliquer sur Enregistrer valide simultanément le statut Approuvé dans toutes les ressources sélectionnées, ce qui garantit la cohérence des états de révision dans le dossier.
Comment sécuriser la distribution des ressources et la recherche dans Dynamic Media à l’aide des OpenAPI ? secure-asset-delivery
Gouvernance centrale des ressources dans Adobe Experience Manager permet aux administrateurs de gestion des ressources numériques (DAM) et chefs de marque de contrôler directement qui peut accéder aux ressources diffusées par le biais d’interfaces OpenAPI (Open Application Programming Interfaces). Ce modèle de gouvernance sécurise la recherche et la diffusion des ressources en appliquant des règles d’accès à la source, de sorte que seuls les utilisateurs autorisés récupèrent le contenu protégé.
Ces administrateurs limitent l’accès du côté création, en particulier sur l’instance de création, à l’aide de deux commandes principales :
- Configuration des rôles : l’accès est accordé ou refusé en fonction des rôles attribués, de sorte que chaque utilisateur, utilisatrice ou groupe ne voie que les ressources autorisées par ses autorisations.
- Planification de l’activation et de la désactivation : les administrateurs définissent des heures précises d’activation et de désactivation pour les ressources approuvées, de sorte que le contenu soit disponible ou retiré automatiquement selon les fenêtres de publication définies.
Comme ces contrôles sont appliqués au niveau de la création, ils régissent chaque requête en aval. Les utilisateurs finaux qui recherchent des ressources ou utilisent des URL de diffusion ne reçoivent des ressources restreintes qu’après avoir réussi le processus d’autorisation. Les requêtes dont l’autorisation échoue sont bloquées, ce qui empêche leur récupération non autorisée même lorsqu’une URL de diffusion est connue. Cela permet de s’assurer que les décisions de gouvernance prises par les administrateurs de gestion des ressources numériques et les responsables de marque sont appliquées de manière cohérente à la fois aux résultats de recherche et aux liens de diffusion directs.
Pour plus d’informations, consultez Restreindre l’accès aux ressources dans Experience Manager.
Comment obtenir des autorisations pour modifier le statut d’approbation d’une ressource ? permissions-edit-approval-status
Pour obtenir les autorisations de modification du statut d’approbation d’une ressource, un administrateur doit accorder un accès en modification au champ Statut de révision dans le schéma de métadonnées appliqué au dossier de ressources. En tant qu’utilisateur de la gestion des ressources numériques (DAM), vous ne disposez peut-être pas des autorisations nécessaires pour approuver les ressources par défaut, car l’approbation et la modification du statut de révision sont contrôlées au niveau du schéma de métadonnées plutôt que par l’accès général aux dossiers.
Les administrateurs peuvent activer cet accès en procédant comme suit :
- Ouvrez le schéma de métadonnées par défaut ou tout autre schéma de métadonnées appliqué au dossier de ressources approprié.
- Recherchez le champ Statut de la révision dans ce schéma.
- Fournissez des autorisations de modification au champ Statut de la révision.
L’octroi d’autorisations de modification au champ Statut de révision garantit que les utilisateurs DAM désignés peuvent modifier directement le statut d’approbation d’une ressource, ce qui simplifie le processus de révision. Pour plus d’informations, voir Comment désactiver la modification du champ Statut de révision.
Quelle est la taille de fichier prise en charge pour les vidéos ? supported-file-formats-videos
Dynamic Media avec fonctionnalités OpenAPI prend en charge les vidéos de forme longue avec une taille de fichier maximale de 50 Go et une durée maximale de 2 heures par vidéo. Ces limites définissent les limites supérieures d’un seul chargement vidéo, ce qui permet la diffusion de contenu complet tel que des webinaires enregistrés, des sessions de formation, des démonstrations de produits et des présentations étendues sans diviser le métrage en segments plus courts.
Dynamic Media prenant en charge des fichiers d’une taille allant jusqu’à 50 Go, il est possible de charger et de diffuser des séquences haute résolution et à débit élevé tout en préservant la qualité. Le plafond de durée de 2 heures garantit que les ressources de forme longue s’intègrent dans un seul fichier continu, ce qui simplifie la gestion de contenu et la lecture pour les visionneuses.
En quoi Dynamic Media avec les fonctionnalités OpenAPI diffère de la solution Dynamic Media ? dynamic-media-and-dynamic-media-with-openapi-differences
Dynamic Media avec des fonctionnalités OpenAPI et Dynamic Media sont des solutions distinctes, chacune offrant ses propres fonctionnalités de diffusion spécialisées. Examinez attentivement vos besoins spécifiques afin de déterminer la solution la mieux adaptée à vos besoins.
Adobe recommande d’utiliser la pile Dynamic Media avec OpenAPI (Open Application Programming Interface) pour tous les cas d’utilisation d’intégration, qu’ils impliquent des applications propriétaires ou tierces. Les deux piles utilisant des structures d’URL différentes, utilisez les règles de décision suivantes pour choisir la bonne approche :
- Intégrations existantes : si une intégration existe déjà avec la pile Dynamic Media, ne la modifiez pas, car les URL de la pile OpenAPI ont une structure différente.
- Nouvelles intégrations : pour tout nouveau cas d’utilisation d’intégration, utilisez la pile OpenAPI.
- Modificateurs avancés : si votre cas d’utilisation nécessite des modificateurs avancés qui ne sont pas encore disponibles avec la pile OpenAPI, évitez cette dernière jusqu’à ce qu’Adobe comble le fossé.
- Diffusion native de base : même pour la diffusion native de base à partir des services cloud Assets de Adobe Experience Manager (AEM), la pile OpenAPI peut être évaluée, à condition que votre cas d’utilisation soit couvert par les modificateurs disponibles avec la pile OpenAPI.
En conclusion, Dynamic Media et la pile Dynamic Media avec OpenAPI peuvent coexister, selon la nature de votre cas d’utilisation.
Voici quelques-unes des principales différences entre Dynamic Media avec les fonctionnalités OpenAPI et Dynamic Media :
Comment Dynamic Media avec les fonctionnalités OpenAPI résout les limites de la fonctionnalité de ressources connectées ? dynamic-media-openapi-addresses-connected-assets-limitations
Dynamic Media avec les fonctionnalités OpenAPI surmonte les principales limites de la fonctionnalité Assets connectée en éliminant la copie binaire, en prenant en charge tous les types de format AEM Assets (y compris les vidéos), en supprimant la limite de connexion à quatre instances, en activant les intégrations personnalisées extensibles et en fournissant des mises à jour des ressources en temps quasi réel. Le tableau ci-dessous présente les principales différences entre les deux solutions :
Certains modificateurs sont marqués comme étant en disponibilité limitée. Comment commencer à les utiliser ? use-limited-availability-modifiers
Les modificateurs de disponibilité limitée nécessitent une activation explicite sur votre compte avant de pouvoir être utilisés en production. Adobe n’active pas ces modificateurs par défaut. Vous devez donc demander l’accès via la prise en charge d’Adobe. Le processus se compose de deux étapes : ouverture d’un dossier d’assistance et fourniture des détails d’identification dont Adobe a besoin pour fournir les fonctionnalités demandées.
Pour activer l’utilisation en production de modificateurs en disponibilité limitée sur votre compte :
-
Créez un dossier d’assistance Adobe à l’aide d’Admin Console.
-
Indiquez les informations suivantes dans le dossier d’assistance Adobe afin qu’Adobe puisse identifier votre organisation et fournir les fonctionnalités demandées :
-
Organisation IMS (identifiant d’organisation du système Identity Management)
-
Liste des modificateurs à activer
-
-
Soumettez le dossier et attendez la prise en charge d’Adobe pour confirmer que les modificateurs Disponibilité limitée requis ont été activés pour votre organisation IMS. Une fois qu’Adobe a confirmé l’activation, les modificateurs spécifiés peuvent être utilisés en production sur votre compte.
Comment tester des modificateurs expérimentaux ? modifiers-not-generally-available
Les API expérimentales vous permettent de tester tout modificateur qui n’est pas encore disponible pour tous. Les API expérimentales (ou bêta) donnent aux développeurs et aux développeuses un accès anticipé à des fonctionnalités encore en cours d’évaluation, afin que vous puissiez valider de nouveaux modificateurs avant qu’ils ne soient promus au jeu stable et généralement disponible. Vous pouvez ainsi tester les fonctionnalités à venir, vérifier qu’elles se comportent comme prévu dans vos workflows et fournir des commentaires avant la publication d’une version générale.
Pour tester un modificateur qui n’est pas généralement disponible, appelez-le via le chemin d’accès expérimental de l’API. Par exemple :
</adobe/experimental/advancemodifiers-expires-YYYYMMDD/assets>
Le segment expires-YYYYMMDD indique que le modificateur expérimental est limité dans le temps, signalant la date à laquelle la version expérimentale devrait changer ou expirer, un rappel pour migrer vers l’équivalent généralement disponible une fois qu’il est libéré.
Pour plus d’informations sur l’appel de ces points d’entrée, consultez les conseils sur l’utilisation des API expérimentales. Pour identifier les modificateurs disponibles, consultez la liste complète des modificateurs .
Voir également
- Traduire les ressources
- API HTTP Assets
- Formats de fichiers pris en charge par Assets
- Rechercher des ressources
- Ressources connectées
- Rapports de ressources
- Schémas de métadonnées
- Télécharger des ressources
- Gestion des métadonnées
- Gérer les modèles Dynamic Media
- Gérer les rapports dans la vue Assets
- Facettes de recherche
- Gérer les collections
- Import des métadonnées en bloc
- Publier des ressources sur AEM et Dynamic Media