Hämta resurser från Adobe Experience Manager download-assets-from-aem

Version
Artikellänk
AEM 6.5
Klicka här
AEM as a Cloud Service
Den här artikeln

Du kan hämta resurser, inklusive statiska och dynamiska återgivningar. Du kan också skicka e-postmeddelanden med länkar till resurser direkt från Adobe Experience Manager Assets. Hämtade resurser paketeras i en ZIP-fil.

Följande resurstyper kan inte laddas ned: Bilduppsättningar, snurpuppsättningar, blandade medieuppsättningar och Carousel-uppsättningar.

Du kan hämta resurser från Experience Manager på följande sätt:

Hämta resurser med gränssnittet Experience Manager download-assets

Experience Manager optimerar nedladdningen baserat på resurskvantitet och storlek. Mindre filer hämtas från användargränssnittet i realtid. Experience Manager hämtar direkt enskilda resursbegäranden för den ursprungliga filen i stället för att bifoga enskilda resurser i ett ZIP-arkiv för snabbare nedladdningar. Experience Manager stöder stora nedladdningar med asynkrona begäranden. Hämtningsbegäranden som är större än 100 GB delas upp i flera ZIP-arkiv med en maximal storlek på 100 MB vardera.

Som standard utlöser Experience Manager ett meddelande i Experience Manager Inkorgen när ett hämtningsarkiv skapas.

Inkorgsmeddelande

Aktivera e-postmeddelanden för stora nedladdningar enable-emails-for-large-downloads

Asynkrona nedladdningar aktiveras i följande fall:

  • Om det finns fler än tio resurser
  • Om hämtningsstorleken är större än 100 MB
  • Om nedladdningen tar mer än 30 sekunder att förbereda

Medan den asynkrona nedladdningen körs i bakgrunden kan användaren fortsätta utforska och arbeta vidare i Experience Manager. Utöver meddelanden i inkorgen för Experience Manager kan Experience Manager skicka e-post för att meddela användaren när hämtningen är klar. Om du vill aktivera den här funktionen kan administratörerna konfigurera e-posttjänsten genom att konfigurera en SMTP-serveranslutning.

När e-posttjänsten har konfigurerats kan administratörer och användare aktivera e-postmeddelanden från Experience Manager-gränssnittet.

Så här aktiverar du e-postmeddelanden:

  1. Logga in på Experience Manager Assets.

  2. Klicka på användarikonen i det övre högra hörnet och klicka sedan på My Preferences för att öppna fönstret Användarinställningar.

  3. Markera kryssrutan Asset Download email notifications och klicka på Accept.

    enable-email-notifications-for-large-downloads

Så här hämtar du resurser:

  1. I användargränssnittet för Experience Manager klickar du på Assets > Files.

  2. Navigera till resurserna som du vill hämta. Markera mappen eller välj en eller flera resurser i mappen. Klicka på Download i verktygsfältet.

    Tillgängliga alternativ vid hämtning av resurser från Experience Manager Assets

  3. I hämtningsdialogrutan väljer du de hämtningsalternativ som du vill ha.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Hämtningsalternativ Beskrivning
    Create separate folder for each asset Välj det här alternativet om du vill skapa en mapp för varje resurs som innehåller alla hämtade återgivningar för resursen. Om du inte markerar det här alternativet finns varje resurs (och dess återgivningar om de har valts för hämtning) i den överordnade mappen för det genererade arkivet.
    Email

    Välj det här alternativet om du vill skicka ett e-postmeddelande (som innehåller en länk till din hämtning) till en annan användare. Mottagaranvändaren måste vara medlem i gruppen dam-users. Standardmallar för e-post finns på följande platser:

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

    Mallar som du anpassar under distributionen finns på följande platser:

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

    Du kan lagra klientspecifika anpassade mallar på följande platser:

    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/downloadasset.
    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/transientworkflowcompleted.
    Asset(s) Välj det här alternativet om du vill hämta resursen i dess ursprungliga form.
    Alternativet för delresurser är tillgängligt om den ursprungliga resursen har delresurser.
    Rendition(s) En återgivning är den binära representationen av en resurs. Assets har en primär representation - den överförda filen. De kan ha ett valfritt antal representationer.
    Med det här alternativet kan du välja de återgivningar du vill hämta. Vilka återgivningar som är tillgängliga beror på vilken resurs du har valt.
    Smart Crops Välj det här alternativet om du vill hämta alla smarta beskärningsåtergivningar för den valda resursen inifrån Experience Manager. En ZIP-fil med renderingarna Smart Crop skapas och hämtas till din lokala dator.
    Dynamic Rendition(s) Välj det här alternativet om du vill generera en serie alternativa återgivningar i realtid. När du väljer det här alternativet väljer du också de återgivningar som du vill skapa dynamiskt genom att välja i listan Bildförinställning.
    Du kan dessutom välja storlek och måttenhet, format, färgrymd, upplösning och valfria bildmodifierare som att invertera bilden. Alternativet är bara tillgängligt om du har Dynamic Media aktiverat.
  4. Klicka på Download i dialogrutan.

    Om e-postmeddelanden har aktiverats för stora nedladdningar visas ett e-postmeddelande med en nedladdnings-URL för den arkiverade zip-mappen i inkorgen. Klicka på nedladdningslänken i e-postmeddelandet för att ladda ned zip-arkivet.

    email-notifications-for-large-downloads

    Du kan även visa meddelandet i din Experience Manager-inkorg.

    inbox-notifications-for-large-downloads

Att dela resurser med hjälp av en länk är ett bekvämt sätt att göra det tillgängligt för intresserade personer utan att de behöver logga in på Assets. Se Funktionen för länkdelning.

När användare hämtar resurser från delade länkar använder Assets en asynkron tjänst som erbjuder snabbare och oavbrutna hämtningar. De resurser som ska laddas ned köas i bakgrunden i en inkorg i ZIP-arkiv med hanterbar filstorlek. För större nedladdningar grupperas nedladdningen i filer på 100 GB.

Download Inbox visar bearbetningsstatus för varje arkiv. När bearbetningen är klar kan du hämta arkiven från inkorgen.

Hämta inkorgen

Aktivera resurshämtningsserver enable-asset-download-servlet

Med standardservleten i Experience Manager kan autentiserade användare utfärda godtyckligt stora, samtidiga hämtningsbegäranden för att skapa ZIP-filer med resurser. Förberedelsen kan påverka prestanda eller till och med överbelasta servern och nätverket. För att minska sådana potentiella DoS-liknande risker som orsakas av den här funktionen är AssetDownloadServlet OSGi-komponenten inaktiverad för publiceringsinstanser. Om du inte behöver nedladdningsfunktionen för författarinstanser inaktiverar du den som skapade den.

Om du vill tillåta hämtning av resurser från DAM, till exempel när du använder Assets Share Commons eller någon annan portalliknande implementering, aktiverar du servleten manuellt via en OSGi-konfiguration. Adobe rekommenderar att du anger en så låg hämtningsstorlek som möjligt utan att det påverkar den dagliga hämtningen. Ett högt värde kan påverka prestandan.

  1. Skapa en mapp med en namnkonvention som anger publiceringskörningsläget som mål, det vill säga config.publish:

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

  2. Skapa en fil av typen nt:file med namnet com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config i konfigurationsmappen.

  3. Fyll i com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config med följande: Anger en maximal storlek (i byte) för hämtningen som värdet asset.download.prezip.maxcontentsize. Nedanstående exempel konfigurerar den maximala storleken för ZIP-nedladdningen till högst 100 kB.

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

Inaktivera resurshämtningsserver disable-asset-download-servlet

Om du inte behöver nedladdningsfunktionen kan du inaktivera servleten för att förhindra DoS-liknande risker. Asset Download Servlet kan inaktiveras på en Experience Manager-författare och publicera instanser genom att uppdatera dispatcherkonfigurationen för att blockera eventuella hämtningsbegäranden. Servern kan även inaktiveras manuellt via OSGi-konsolen direkt.

  1. Om du vill blockera resurshämtningsbegäranden via en dispatcherkonfiguration redigerar du konfigurationen dispatcher.any och lägger till en ny regel i filteravsnittet.

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

OnTime- eller OffTime-återgivning on-off-time-rendition

Om du vill aktivera tjänsten OnOffTimeAssetAccessFilter måste du skapa en OSGi-konfiguration. Den här tjänsten tillåter blockering av åtkomst till återgivningar och metadata utöver själva resursen baserat på tidsinställningarna på/av. OSGi-konfigurationen ska vara för com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter. Följ stegen nedan:

  1. Skapa en konfigurationsfil på /apps/system/config/com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter.cfg.json i din projektkod i Git. Filen ska innehålla {} som innehåll, vilket anger en tom OSGi-konfiguration för motsvarande OSGi-komponent. Den här åtgärden aktiverar tjänsten.
  2. Distribuera koden, inklusive den nya konfigurationen, via Cloud Manager.
  3. När de distribuerats är återgivningarna och metadata tillgängliga enligt objektens tidsinställningar. Om det aktuella datumet eller den aktuella tiden infaller före eller efter tidpunkten för avaktiveringen visas ett felmeddelande.
    Mer information om hur du lägger till en tom OSGi-konfiguration finns i den här guiden.

Tips och begränsningar tips-limitations

  • Om du hämtar en tom mapp skickar Experience Manager ett meddelande om att ett ZIP-arkiv har skapats, men arkivet skapas inte.

Se även

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