Téléchargement de ressources depuis Adobe Experience Manager download-assets-from-aem

Version
Lien de l’article
AEM as a Cloud Service
Cliquez ici
AEM 6.5
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 compressées dans un fichier ZIP. La taille maximale du fichier ZIP compressé est de 1 Go pour la tâche d’exportation. Un maximum de 500 ressources par tâche d’exportation est autorisé.

NOTE
Tout utilisateur disposant d’autorisations de lecture à l’emplacement /var/dam/share peut accéder au lien de téléchargement partagé dans l’e-mail.
Tout utilisateur disposant des autorisations de lecture à l’emplacement /var/dam/jobs/download peut télécharger des ressources.
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.

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

  1. Dans le coin supérieur gauche, cliquez sur le logo. Dans le rail de gauche, cliquez sur Navigation.

  2. Sur la page de navigation, cliquez sur Ressources > Fichiers.

  3. Accédez à un dossier contenant les ressources à télécharger.

  4. Sélectionnez le dossier ou une ou plusieurs ressources qu’il contient.

  5. Dans la barre d’outils, cliquez sur Télécharger.

  6. 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 d’exportation ou 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

    Une notification par e-mail est envoyée à l’utilisateur ou l’utilisatrice. 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 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 sélectionnez. L’option est disponible si la ressource comporte des rendus.
    Recadrages intelligents Sélectionnez cette option pour télécharger tous les rendus de recadrage intelligent de la ressource sélectionnée depuis AEM. 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.
  7. Dans la boîte de dialogue, cliquez sur Télécharger.

Lorsque vous sélectionnez un dossier à télécharger, l’ensemble de la hiérarchie de ressources dans ce dossier est téléchargé. Pour inclure chaque ressource que vous téléchargez (y compris les ressources figurant dans des dossiers enfants imbriqués dans le dossier parent) dans un dossier particulier, sélectionnez Créer un dossier distinct pour chaque ressource.

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

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 pour créer des fichiers ZIP de ressources visibles, susceptibles de surcharger le serveur et le réseau. Pour atténuer les risques d’attaques par déni de service, le composant OSGi AssetDownloadServlet est désactivé par défaut pour les instances de publication.

Pour autoriser le téléchargement de ressources à 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 le 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.

  1. Créez un dossier avec une convention de nommage qui cible le mode d’exécution de publication (config.publish) : /apps/<your-app-name>/config.publish. Pour définir les propriétés de configuration d’un mode d’exécution, consultez les Modes d’exécution.

  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.

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

Par défaut, pour les requêtes GET de téléchargement de fichiers, Experience Manager applique une limite de 50 Mo à la taille de téléchargement de l’archive ZIP. Les téléchargements lancés à l’aide des requêtes POST ou de l’interface utilisateur ne sont pas affectés par cette limite.

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

Le Asset Download Servlet peut être désactivé sur les instances de publication 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.

  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 filtre. /0100 { /type "deny" /url "*.assetdownload.zip/assets.zip*" }

  2. Pour désactiver le composant OSGi sur une instance de publication, accédez à la console OSGi à l’adresse http://[aem_server]:[port]/system/console/components. Recherchez com.day.cq.dam.core.impl.servlet.AssetDownloadServlet et cliquez ensuite sur Désactiver.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2