Elementen downloaden van Adobe Experience Manager download-assets-from-aem

Versie
Artikelkoppeling
AEM 6,5
Klik hier
AEM as a Cloud Service
Dit artikel

U kunt elementen downloaden, zoals statische en dynamische uitvoeringen. U kunt ook e-mails met koppelingen naar middelen rechtstreeks verzenden vanuit Adobe Experience Manager Assets. Gedownloade elementen worden opgenomen in een ZIP-bestand.

De volgende elementtypen kunnen niet worden gedownload: Afbeeldingssets, Spin-sets, Gemengde mediasets en Carousel-sets.

U kunt elementen van Experience Manager downloaden met de volgende methoden:

Elementen downloaden met Experience Manager interface download-assets

Experience Manager optimaliseert de downloadervaring op basis van de hoeveelheid en de grootte van het element. Kleinere bestanden worden in real-time gedownload vanuit de gebruikersinterface. Experience Manager downloadt direct enkele elementaanvragen voor het oorspronkelijke bestand in plaats van één element in een ZIP-archief te plaatsen, zodat sneller kan worden gedownload. Experience Manager ondersteunt grote downloads met asynchrone verzoeken. Downloadaanvragen die groter zijn dan 100 GB worden gesplitst in meerdere ZIP-archieven met een maximale grootte van 100 MB elk.

Standaard, Experience Manager activeert een melding in de Experience Manager Inbox bij het genereren van een downloadarchief.

Inbox-melding

E-mailmeldingen inschakelen voor grote downloads enable-emails-for-large-downloads

Asynchrone downloads worden in een van de volgende gevallen geactiveerd:

  • Indien er meer dan tien activa zijn
  • Als de downloadgrootte groter is dan 100 MB
  • Als het downloaden meer dan 30 seconden duurt om voor te bereiden

Terwijl de asynchrone download achteraan loopt, kan de gebruiker blijven onderzoeken en verder in Experience Manager werken. Naast de meldingen in het Postvak IN van de Experience Manager kan Experience Manager e-mails verzenden om de gebruiker op de hoogte te stellen wanneer het downloadproces is voltooid. Om deze functie in te schakelen, kunnen de beheerders de e-mailservice configureren door configureren van een SMTP-serververbinding.

Nadat de e-mailservice is geconfigureerd, kunnen beheerders en gebruikers e-mailmeldingen inschakelen via de interface Experience Manager.

E-mailmeldingen inschakelen:

  1. Aanmelden bij Experience Manager Assets.

  2. Klik op het gebruikerspictogram in de rechterbovenhoek en klik vervolgens op My Preferences om het venster Gebruikersvoorkeuren te openen.

  3. Selecteer de Asset Download email notifications selectievakje en klik op Accept.

    inschakelen-e-mailmeldingen voor grote downloads

Voer de volgende stappen uit om elementen te downloaden:

  1. In Experience Manager gebruikersinterface, klik Assets > Files.

  2. Navigeer naar de elementen die u wilt downloaden. Selecteer de map of selecteer een of meer middelen in de map. Klik op de werkbalk op Download.

    Beschikbare opties voor het downloaden van elementen van Experience Manager Assets

  3. Selecteer in het dialoogvenster Downloaden de gewenste downloadopties.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Downloadoptie Beschrijving
    Create separate folder for each asset Selecteer deze optie om een map te maken voor elk element dat alle gedownloade uitvoeringen voor het element bevat. Als deze optie niet is geselecteerd, bevindt elk element (en de bijbehorende uitvoeringen als deze zijn geselecteerd om te worden gedownload) zich in de bovenliggende map van het gegenereerde archief.
    Email

    Selecteer deze optie om een e-mailbericht (met een koppeling naar uw download) naar een andere gebruiker te verzenden. De ontvangende gebruiker moet lid van zijn dam-users groep. De standaard e-mailsjablonen zijn beschikbaar op de volgende locaties:

    • /libs/settings/dam/workflow/notification/email/downloadasset.
    • /libs/settings/dam/workflow/notification/email/transientworkflowcompleted.

    De malplaatjes die u tijdens plaatsing aanpast zijn beschikbaar bij de volgende plaatsen:

    • /apps/settings/dam/workflow/notification/email/downloadasset.
    • /apps/settings/dam/workflow/notification/email/transientworkflowcompleted.

    U kunt huurdersspecifieke douanemalplaatjes bij de volgende plaatsen opslaan:

    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/downloadasset.
    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/transientworkflowcompleted.
    Asset(s) Selecteer deze optie als u het element in de oorspronkelijke vorm wilt downloaden.
    De optie Subassets is beschikbaar als het oorspronkelijke element subassets heeft.
    Rendition(s) Een vertoning is de binaire representatie van een element. Elementen hebben een primaire representatie, namelijk die van het geüploade bestand. Zij kunnen om het even welk aantal vertegenwoordiging hebben.
    Met deze optie kunt u de uitvoeringen selecteren die u wilt downloaden. Welke uitvoeringen beschikbaar zijn, is afhankelijk van het geselecteerde element.
    Smart Crops Selecteer deze optie als u alle slimme uitsnijduitvoeringen van het geselecteerde element vanuit Experience Manager. Er wordt een ZIP-bestand met de Smart Crop-uitvoeringen gemaakt en gedownload naar uw lokale computer.
    Dynamic Rendition(s) Selecteer deze optie als u een reeks alternatieve vertoningen in real-time wilt genereren. Wanneer u deze optie selecteert, selecteert u ook de uitvoeringen die u dynamisch wilt maken door een van de opties Voorinstelling afbeelding lijst.
    Bovendien kunt u de grootte en maateenheid, de indeling, de kleurruimte, de resolutie en eventuele optionele afbeeldingsaanpassingen selecteren, zoals het omkeren van de afbeelding. De optie is alleen beschikbaar als u Dynamic Media ingeschakeld.
  4. Klik op Download.

    Als e-mailmelding is ingeschakeld voor grote downloads, wordt een e-mail met een download-URL van de gearchiveerde ZIP-map in uw Postvak IN weergegeven. Klik op de downloadkoppeling in de e-mail om het ZIP-archief te downloaden.

    e-mailmeldingen voor grote downloads

    U kunt de melding ook weergeven in uw Experience Manager Postvak IN.

    inbox-notifications-voor-grote downloads

Het delen van elementen via een koppeling is een handige manier om deze beschikbaar te maken voor belangstellenden zonder dat zij zich hoeven aan te melden bij Assets. Zie Functionaliteit voor delen koppelen.

Wanneer gebruikers elementen downloaden van gedeelde koppelingen Assets gebruikt een asynchrone service die snellere en ononderbroken downloads biedt. De te downloaden middelen worden op de achtergrond in een Postvak IN in een ZIP-archief met beheerbare bestandsgrootte in een wachtrij geplaatst. Voor grotere downloads wordt de download uitgeknipt in bestanden van 100 GB.

De Download Inbox geeft de verwerkingsstatus van elk archief weer. Zodra de verwerking is voltooid, kunt u de archieven downloaden van inbox.

Postvak IN downloaden

Enable asset download servlet enable-asset-download-servlet

De standaardserver Experience Manager Hiermee kunnen geverifieerde gebruikers willekeurig grote, gelijktijdige downloadaanvragen afgeven om ZIP-bestanden met elementen te maken. De downloadvoorbereiding kan prestatiesimplicaties hebben of kan zelfs de server en het netwerk overbelasten. Om dergelijke potentiële DoS-achtige risico's te verlichten die door deze eigenschap worden veroorzaakt, AssetDownloadServlet De component OSGi is uitgeschakeld voor publicatie-instanties. Schakel het servlet-bestand bij de auteur uit als u de downloadfunctie niet nodig hebt voor instanties van de auteur.

Om het downloaden van activa van uw DAM toe te staan, bijvoorbeeld wanneer het gebruiken van iets zoals de Commons van het Aandeel van Activa of andere portaalachtige implementatie, laat manueel servlet via een configuratie OSGi toe. Adobe raadt u aan de toegestane downloadgrootte zo laag mogelijk in te stellen zonder dat dit van invloed is op de dagelijkse downloadvereisten. Een hoge waarde kan de prestaties beïnvloeden.

  1. Maak een map met een naamgevingsconventie die zich richt op de publicatieroutmodus, namelijk: config.publish:

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

  2. Maak in de configuratiemap een bestandstype nt:file benoemd com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config.

  3. Vullen com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config met het volgende. Hiermee stelt u een maximale grootte (in bytes) in voor het downloaden als waarde van asset.download.prezip.maxcontentsize. In het onderstaande voorbeeld wordt de maximale grootte van de ZIP-download ingesteld op maximaal 100 kB.

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

Asset Download-server uitschakelen disable-asset-download-servlet

Als u de downloadfunctionaliteit niet nodig hebt, dan onbruikbaar servlet om het even welke DoS-gelijkaardige risico's te verhinderen. De Asset Download Servlet kan worden uitgeschakeld op Experience Manager auteur en publiceer instanties door de configuratie van de verzender bij te werken om het even welke verzoeken van de activadownload te blokkeren. servlet kan ook manueel via de console OSGi direct worden onbruikbaar gemaakt.

  1. Als u aanvragen voor het downloaden van middelen wilt blokkeren via een dispatcherconfiguratie, bewerkt u de dispatcher.any en voeg een nieuwe regel toe aan de filtersectie.

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

OnTime- of OffTime-uitvoering on-off-time-rendition

Om het OnOffTimeAssetAccessFilter de dienst, moet u een configuratie tot stand brengen OSGi. Met deze service kunt u naast het element zelf ook toegang tot vertoningen en metagegevens blokkeren op basis van de instellingen voor aan- en uittijd. De OSGi-configuratie moet com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter. Voer de onderstaande stappen uit:

  1. In uw projectcode in Git, creeer een configuratiedossier bij /apps/system/config/com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter.cfg.json. Het bestand moet het volgende bevatten {} als inhoud, die een lege configuratie OSGi voor de overeenkomstige component OSGi betekent. Deze actie laat de dienst toe.
  2. Implementeer uw code, inclusief deze nieuwe configuratie, via Cloud Manager.
  3. Nadat de uitvoeringen en metagegevens zijn geïmplementeerd, zijn deze toegankelijk volgens de instellingen voor aan- en uittijd van de elementen. Als de huidige datum of tijd vóór de on-time of na de off-time valt, wordt een foutenmelding getoond.
    Voor meer details bij het toevoegen van een lege configuratie OSGi, zie dit hulplijn.

Tips en beperkingen tips-limitations

  • Als u een lege map downloadt, Experience Manager geeft een succesbericht weer over het maken van een ZIP-archief, maar het archief wordt niet gemaakt.

Zie ook

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab