Téléchargement de ressources depuis Adobe Experience Manager

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 compressées dans un fichier ZIP.

REMARQUE

Les destinataires du courrier électronique doivent être membres du groupe dam-users pour accéder au lien de téléchargement ZIP contenu dans le message. Pour télécharger les ressources, ils doivent disposer des autorisations de lancement des workflows qui déclenchent le téléchargement.

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

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

Téléchargement de ressources à l’aide de l’interface Experience Manager

Le service de téléchargement asynchrone fournit un framework permettant le téléchargement transparent de ressources de grande taille. Les fichiers plus petits sont téléchargés en temps réel depuis l’interface utilisateur. Experience Manager ne archive pas les téléchargements de ressources uniques où le fichier d’origine est téléchargé. Cette fonctionnalité permet des téléchargements plus rapides. Les fichiers volumineux sont téléchargés de manière asynchrone et Experience Manager sont avertis de la fin par le biais de notifications dans la boîte de réception. Voir comprendre Experience Manager Boîte de réception.

Notification de téléchargement

Figure : Notification de téléchargement via la boîte de réception d’Experience Manager.

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

  • S’il y a plus de 10 ressources ou plus de 100 Mo à télécharger.
  • Si la préparation du téléchargement prend plus de 30 secondes.

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

  1. Dans l’interface utilisateur d’Experience Manager, cliquez sur Ressources > Fichiers.

  2. 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.

    Options disponibles lors du téléchargement de ressources à partir d’Experience Manager Assets

    Figure : Options de la boîte de dialogue Télécharger.

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

    Option de téléchargement Description
    Créer un dossier distinct pour chaque ressource Sélectionnez cette option pour inclure chaque ressource que vous téléchargez (y compris les ressources dans des dossiers enfants imbriqués sous le dossier parent de la ressource) dans un dossier sur votre ordinateur local. Lorsque cette option n’est pas sélectionnée, par défaut, la hiérarchie de dossiers est ignorée et toutes les ressources sont téléchargées dans un dossier de votre ordinateur local.
    Courrier électronique Sélectionnez cette option pour envoyer une notification par email au destinataire. 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 sans aucun rendu.
    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 transféré. 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.
  4. Dans la boîte de dialogue, cliquez sur Télécharger.

Activation du servlet de téléchargement de ressources

Le servlet par défaut d’Experience Manager permet aux utilisateurs authentifiés d’émettre des demandes de téléchargement simultanées de grande taille et de taille arbitraire 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 permettre le téléchargement de fichiers depuis votre DAM (par exemple, lorsque vous utilisez un élément comme Asset Share Commons ou une autre implémentation de type portail), activez manuellement le servlet via une configuration OSGi. Adobe recommande de définir la taille de téléchargement autorisée sur la valeur la plus basse possible sans affecter les exigences de téléchargement au quotidien. Une valeur élevée peut avoir une incidence sur les performances.

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

    /apps/<your-app-name>/config.publish

  2. Dans le dossier de configuration, créez un fichier de type nt:file nommé com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config.

  3. 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.

    enabled=B"true"
    asset.download.prezip.maxcontentsize=I"102400"
    

Désactivation du servlet de téléchargement de ressources

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. La fonction Asset Download Servlet peut être désactivée sur les instances Experience Manager d’auteur et de publication 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.

  1. 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*" }

Sur cette page