Documentation AEM as a Cloud Service Guide de l’utilisateur

Télécharger des ressources depuis Adobe Experience Manager download-assets-from-aem

Last update: Tue Oct 08 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Rubriques :
Gestion des ressources numériques

Créé pour :

Utilisateur ou utilisatrice

Bonnes pratiques de recherche

Bonnes pratiques en matière de métadonnées

Hub de contenus

Dynamic Media avec fonctionnalités OpenAPI

Documentation destinée aux développeurs AEM Assets

Version

Lien de l’article

AEM 6.5

Cliquez ici

AEM as a Cloud Service

Cet article

Vous pouvez télécharger des ressources, dont des rendus statiques et dynamiques. Vous pouvez également envoyer des liens vers des ressources par courrier électronique, directement depuis Adobe Experience Manager Assets. Les ressources téléchargées sont regroupées dans un fichier ZIP.

Les types de ressources suivants ne peuvent pas être téléchargés : visionneuses d’images, visionneuses à 360°, visionneuses de supports variés et visionneuses de carrousel.

Vous pouvez télécharger des ressources à partir d’Experience Manager à l’aide des méthodes suivantes :

Télécharger des ressources à l’aide de l’interface Experience Manager download-assets

Experience Manager optimise l’expérience de téléchargement en fonction de la quantité et de la taille des ressources. Les fichiers plus petits sont téléchargés en temps réel depuis l’interface utilisateur. Experience Manager télécharge directement les requêtes de ressources uniques pour le fichier original au lieu de compresser les ressources uniques dans une archive ZIP afin de permettre des téléchargements plus rapides. Experience Manager prend en charge les téléchargements volumineux avec des requêtes asynchrones. Les requêtes de téléchargement dʼune taille supérieure à 100 Go sont divisées en plusieurs archives ZIP, dʼune taille maximale de 100 Go chacune.

Par défaut, Experience Manager déclenche une notification dans la Experience Manager Boîte de réception lorsque qu’une archive de téléchargement est générée.

Notification dans la boîte de réception

Activer les notifications par e-mail pour les téléchargements volumineux enable-emails-for-large-downloads

Les téléchargements asynchrones sont déclenchés dans l’un des cas suivants :

S’il y a plus de dix ressources
Si la taille de téléchargement est supérieure à 100 Mo
Si la préparation du téléchargement prend plus de 30 secondes

Bien que le téléchargement asynchrone s’exécute sur le serveur principal, l’utilisateur peut continuer à explorer et à travailler dans Experience Manager. Outre les notifications dans la boîte de réception d’Experience Manager, Experience Manager peut également envoyer des e-mails pour avertir l’utilisateur ou l’utilisatrice de la fin du processus de téléchargement. Pour activer cette fonctionnalité, les administrateurs et administratrices peuvent configurer le service e-mail en configurant une connexion au serveur SMTP.

Une fois que le service de messagerie est configuré, les administrateurs et les utilisateurs peuvent activer les notifications par e-mail provenant de l’interface Experience Manager.

Pour activer les notifications par e-mail :

Connectez-vous à Experience Manager Assets.
Cliquez sur l’icône utilisateur dans le coin supérieur droit, puis sur Mes préférences pour afficher la fenêtre Préférences utilisateur.
Sélectionnez la case à cocher Notifications par e-mail du téléchargement de ressources et cliquez sur Accepter.

Pour télécharger des ressources, procédez comme suit :

Dans l’interface utilisateur d’Experience Manager, cliquez sur Ressources > Fichiers.
Accédez aux ressources à télécharger. Sélectionnez le dossier ou une ou plusieurs ressources qu’il contient. Dans la barre d’outils, cliquez sur Télécharger.

Dans la boîte de dialogue Télécharger, sélectionnez les options de téléchargement de votre choix.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Option de téléchargement	Description
Créer un dossier distinct pour chaque ressource	Sélectionnez cette option pour créer un dossier pour chaque ressource contenant tous les rendus téléchargés de la ressource. Si cette option n’est pas sélectionnée, chaque ressource (et ses rendus s’ils sont sélectionnés pour le téléchargement) est contenue dans le dossier parent de l’archive générée.
E-mail	Sélectionnez cette option pour envoyer une notification par e-mail (contenant un lien vers votre téléchargement) à un autre utilisateur. Le destinataire doit être membre du groupe `dam-users`. Les modèles standard d’email sont disponibles aux emplacements suivants : `/libs/settings/dam/workflow/notification/email/downloadasset`. `/libs/settings/dam/workflow/notification/email/transientworkflowcompleted`. Les modèles que vous personnalisez lors du déploiement sont disponibles aux emplacements suivants : `/apps/settings/dam/workflow/notification/email/downloadasset`. `/apps/settings/dam/workflow/notification/email/transientworkflowcompleted`. Vous pouvez stocker des modèles personnalisés spécifiques au client à ces emplacements : `/conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/downloadasset`. `/conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/transientworkflowcompleted`.
Ressource(s)	Sélectionnez cette option pour télécharger la ressource dans son format d’origine. L’option Sous-ressources est disponible si la ressource d’origine comporte des sous-ressources.
Rendu(s)	Un rendu est une représentation binaire d’une ressource. Les ressources possèdent une représentation principale, à savoir celle du fichier téléchargé. Elles peuvent avoir un nombre illimité de représentations. Avec cette option, vous pouvez sélectionner les rendus que vous souhaitez télécharger. Les rendus disponibles dépendent de la ressource que vous avez sélectionnée.
Recadrages intelligents	Sélectionnez cette option pour télécharger tous les rendus de recadrage intelligent de la ressource sélectionnée depuis Experience Manager. Un fichier zip contenant les rendus de recadrage intelligent est créé et téléchargé sur votre ordinateur local.
Rendu(s) dynamique(s)	Sélectionnez cette option pour générer une série de rendus alternatifs en temps réel. Lorsque vous sélectionnez cette option, vous sélectionnez également les rendus à créer dynamiquement dans la liste Paramètre d’image prédéfini. De plus, vous pouvez sélectionner la taille, l’unité de mesure, le format, l’espace colorimétrique, la résolution, ainsi que les éventuels modificateurs d’image (pour inverser l’image, par exemple). Cette option n’est disponible que si vous avez activé Dynamic Media.

Dans la boîte de dialogue, cliquez sur Télécharger.

Si vous avez demandé à être averti en cas de téléchargement volumineux, vous recevrez un e-mail dans votre boîte de réception contenant une URL de téléchargement pour le dossier zip archivé. Cliquez sur le lien de téléchargement du courrier électronique pour télécharger l’archive ZIP.

Vous pouvez également consulter la notification dans votre boîte de réception Experience Manager.

Le partage de ressources au moyen d’un lien est très pratique pour le mettre à disposition des personnes intéressées sans avoir besoin de se connecter à Assets. Consultez la section Fonctionnalité de partage de liens.

Lorsque les utilisateurs téléchargent des ressources à partir de liens partagés, Assets utilise un service asynchrone qui offre des téléchargements plus rapides et ininterrompus. Les ressources à télécharger sont placées en file d’attente en arrière-plan dans une boîte de réception dans les archives ZIP de taille de fichier gérable. Pour les téléchargements plus volumineux, le téléchargement est scindé en fichiers de 100 Go.

La boîte de réception de téléchargement affiche l’état du traitement de chaque archive. Une fois le traitement terminé, vous pouvez télécharger les archives à partir de la boîte de réception.

Boîte de réception de téléchargement

Activation du servlet de téléchargement de ressources enable-asset-download-servlet

Le servlet par défaut d’Experience Manager permet aux utilisateurs et utilisatrices authentifiés d’émettre arbitrairement des requêtes de téléchargement simultanées de grande taille afin de créer des fichiers ZIP de ressources. La préparation des téléchargements peut avoir des conséquences sur les performances ou peut même surcharger le serveur et le réseau. Pour atténuer ces risques potentiels de déni de service, le composant OSGi AssetDownloadServlet est désactivé par défaut pour les instances de publication. Si vous n’avez pas besoin de la fonction de téléchargement sur les instances d’auteur, désactivez le servlet sur l’auteur.

Pour autoriser le téléchargement de DAM à partir de votre gestion des ressources numériques (par exemple, lors de l’utilisation d’Asset Share Commons ou une autre mise en œuvre de type portail), activez manuellement la servlet via une configuration OSGi. Adobe recommande de définir la taille de téléchargement autorisée aussi basse que possible, sans pour autant affecter les exigences de téléchargement quotidiennes. Une valeur élevée peut avoir une incidence sur les performances.

Créez un dossier avec une convention de nommage qui cible le mode d’exécution de publication, à savoir config.publish :

/apps/<your-app-name>/config.publish
Dans le dossier de configuration, créez un fichier de type nt:file nommé com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config.

Remplissez com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config avec les éléments suivants. Définit une taille maximale (en octets) pour le téléchargement en tant que valeur de asset.download.prezip.maxcontentsize. L’exemple ci-dessous configure la taille maximale du téléchargement ZIP pour qu’il ne dépasse pas 100 Ko.

code language-java
`enabled=B"true" asset.download.prezip.maxcontentsize=I"102400"`

Désactivation du servlet de téléchargement de ressources disable-asset-download-servlet

Si vous n’avez pas besoin de la fonctionnalité de téléchargement, désactivez le servlet pour éviter tout risque de déni de service. Le Asset Download Servlet peut être désactivé sur les instances d’auteur et de publication d’Experience Manager en mettant à jour la configuration du Dispatcher afin de bloquer toute demande de téléchargement de ressources. Le servlet peut également être désactivé manuellement par l’intermédiaire de la console OSGi.

Pour bloquer les requêtes de téléchargement de ressources via une configuration de Dispatcher, modifiez la configuration dispatcher.any et ajoutez une nouvelle règle à la section /filter.

/0100 { /type "deny" /url "*.assetdownload.zip/assets.zip*" }

Rendu onTime ou OffTime on-off-time-rendition

Pour activer le service OnOffTimeAssetAccessFilter, vous devez créer une configuration OSGi. Ce service permet de bloquer l’accès aux rendus et aux métadonnées en plus de la ressource elle-même en fonction des paramètres d’heure d’activation/de désactivation. La configuration OSGi doit être définie sur com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter. Suivez les étapes ci-dessous :

Dans le code de votre projet dans Git, créez un fichier de configuration à l’emplacement /apps/system/config/com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter.cfg.json. Le fichier doit contenir {} en tant que contenu, ce qui signifie une configuration OSGi vide pour le composant OSGi correspondant. Cette action active le service.
Déployez votre code, y compris cette nouvelle configuration, via Cloud Manager.
Une fois déployé, les rendus et les métadonnées sont accessibles en fonction des paramètres d’heure d’activation/de désactivation des ressources. Si la date ou l’heure actuelle est antérieure à l’heure actuelle ou après l’heure de désactivation, un message d’erreur s’affiche.
Pour plus d’informations sur l’ajout d’une configuration OSGi vide, consultez ce guide.

Conseils et restrictions tips-limitations

Si vous téléchargez un dossier vide, Experience Manager transmet un message de réussite concernant la création d’une archive ZIP, mais l’archive n’est pas créée.

Voir également

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab