Scarica risorse da Adobe Experience Manager download-assets-from-aem

Versione
Collegamento articolo
AEM 6.5
Fai clic qui
AEM as a Cloud Service
Questo articolo

Puoi scaricare risorse, incluse le rappresentazioni statiche e dinamiche. In alternativa, puoi inviare e-mail con collegamenti alle risorse direttamente da Adobe Experience Manager Assets. Le risorse scaricate sono incluse in un file ZIP.

Non è possibile scaricare i seguenti tipi di risorse: Set di immagini, Set 360 gradi, Set di file multimediali diversi e Set carosello.

Puoi scaricare le risorse da Experience Manager utilizzando i seguenti metodi:

Scaricare le risorse tramite l'interfaccia Experience Manager download-assets

Experience Manager ottimizza l’esperienza di download in base alla quantità e alle dimensioni della risorsa. I file più piccoli vengono scaricati dall’interfaccia utente in tempo reale. Experience Manager scarica direttamente le richieste di singole risorse per il file originale anziché racchiudere le singole risorse in un archivio ZIP per consentire download più veloci. Experience Manager supporta i download di grandi dimensioni con richieste asincrone. Le richieste di download di dimensioni superiori a 100 GB vengono suddivise in più archivi ZIP con una dimensione massima di 100 MB ciascuno.

Per impostazione predefinita, Experience Manager attiva una notifica nella Experience Manager Posta in arrivo al momento della generazione di un archivio di download.

Notifica casella in entrata

Abilitare le notifiche e-mail per i download di grandi dimensioni enable-emails-for-large-downloads

I download asincroni vengono attivati in uno dei seguenti casi:

  • Se il numero delle attività è superiore a dieci
  • Se la dimensione del download è superiore a 100 MB
  • Se la preparazione del download richiede più di 30 secondi

Mentre il download asincrono viene eseguito nel backend, l’utente può continuare a esplorare e lavorare ulteriormente in Experience Manager. Oltre alle notifiche della casella in entrata dell’Experience Manager, Experience Manager può inviare e-mail per avvisare l’utente al termine del processo di download. Per abilitare questa funzionalità, gli amministratori possono configurare il servizio e-mail configurando una connessione al server SMTP.

Una volta configurato il servizio e-mail, gli amministratori e gli utenti possono abilitare le notifiche e-mail dall’interfaccia di Experience Manager.

Per abilitare le notifiche e-mail:

  1. Accedi a Experience Manager Assets.

  2. Fai clic sull'icona dell'utente nell'angolo superiore destro, quindi fai clic su Preferenze per aprire la finestra Preferenze utente.

  3. Seleziona la casella di controllo Notifiche e-mail download risorse e fai clic su Accetta.

    enable-email-notifications-for-large-downloads

Per scaricare le risorse, effettua le seguenti operazioni:

  1. Nell'interfaccia utente di Experience Manager, fare clic su Assets > File.

  2. Passa alle risorse da scaricare. Seleziona la cartella o una o più risorse all’interno della cartella. Sulla barra degli strumenti fare clic su Scarica.

    Opzioni disponibili per il download di risorse da Experience Manager Assets

  3. Nella finestra di dialogo Scarica selezionare le opzioni di download desiderate.

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    Opzione di download Descrizione
    Crea una cartella separata per ogni risorsa Seleziona questa opzione per creare una cartella per ogni risorsa contenente tutte le relative rappresentazioni scaricate. Se non è selezionata, ogni risorsa (e le relative rappresentazioni se sono selezionate per il download) è contenuta nella cartella principale dell’archivio generato.
    E-mail

    Seleziona questa opzione per inviare una notifica e-mail (contenente un collegamento al download) a un altro utente. L'utente destinatario deve essere un membro del gruppo dam-users. I modelli di e-mail standard sono disponibili nelle seguenti posizioni:

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

    I modelli personalizzati durante la distribuzione sono disponibili nelle posizioni seguenti:

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

    Puoi memorizzare modelli personalizzati specifici del tenant nelle seguenti posizioni:

    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/downloadasset.
    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/transientworkflowcompleted.
    Risorse Seleziona questa opzione per scaricare la risorsa nella sua forma originale.
    L'opzione Risorse secondarie è disponibile se la risorsa originale contiene risorse secondarie.
    Rappresentazione/i Una rappresentazione è la rappresentazione binaria di una risorsa. Assets dispone di una rappresentazione principale, ovvero quella del file caricato. Possono avere un numero qualsiasi di rappresentazioni.
    Con questa opzione è possibile selezionare le copie trasformate da scaricare. Le rappresentazioni disponibili dipendono dalla risorsa selezionata.
    Ritagli avanzati Seleziona questa opzione per scaricare tutte le rappresentazioni con ritaglio avanzato della risorsa selezionata da Experience Manager. Nel computer locale viene creato e scaricato un file zip con le rappresentazioni di Ritaglio avanzato.
    Rappresentazioni dinamiche Selezionare questa opzione per generare in tempo reale una serie di rappresentazioni alternative. Quando selezioni questa opzione, selezioni anche le rappresentazioni da creare in modo dinamico selezionandole dall'elenco Predefinito immagine.
    È inoltre possibile selezionare le dimensioni e l'unità di misura, il formato, lo spazio colore, la risoluzione ed eventuali modificatori di immagine facoltativi, ad esempio l'inversione dell'immagine. L'opzione è disponibile solo se è stato abilitato Dynamic Media.
  4. Nella finestra di dialogo, fai clic su Scarica.

    Se la notifica e-mail è abilitata per i download di grandi dimensioni, nella casella in entrata viene visualizzato un messaggio e-mail contenente l’URL di download della cartella zip archiviata. Fai clic sul collegamento di download dall’e-mail per scaricare l’archivio zip.

    notifiche e-mail per download di grandi dimensioni

    È inoltre possibile visualizzare la notifica nella Posta in arrivo Experience Manager.

    inbox-notifications-for-large-downloads

La condivisione delle risorse tramite un collegamento è un modo pratico per renderlo disponibile agli utenti interessati senza dover accedere a Assets. Consulta la funzionalità di condivisione collegamenti.

Quando gli utenti scaricano risorse da collegamenti condivisi, Assets utilizza un servizio asincrono che offre download più veloci e ininterrotti. Le risorse da scaricare vengono accodate in background in una casella in entrata in archivi ZIP di dimensioni file gestibili. Per i download di dimensioni maggiori, il download viene suddiviso in file da 100 GB.

Nella cartella Posta in arrivo Download viene visualizzato lo stato di elaborazione di ogni archivio. Una volta completata l’elaborazione, puoi scaricare gli archivi dalla casella in entrata.

Scarica casella in entrata

Abilita servlet di download risorse enable-asset-download-servlet

Il servlet predefinito in Experience Manager consente agli utenti autenticati di inviare richieste di download simultanee di grandi dimensioni arbitrarie per creare file ZIP di risorse. La preparazione del download può avere implicazioni sulle prestazioni o può addirittura sovraccaricare il server e la rete. Per attenuare tali potenziali rischi di tipo DoS causati da questa funzionalità, il componente OSGi AssetDownloadServlet è disabilitato per le istanze di pubblicazione. Se non hai bisogno della funzione di download nelle istanze di authoring, disabilita il servlet in Author.

Per consentire il download di risorse dal DAM, ad esempio quando utilizzi qualcosa come Asset Share Commons o un’altra implementazione simile a un portale, abilita manualmente il servlet tramite una configurazione OSGi. L’Adobe consiglia di impostare la dimensione di download consentita il più bassa possibile senza influire sui requisiti di download giornalieri. Un valore elevato può influire sulle prestazioni.

  1. Creare una cartella con una convenzione di denominazione che esegue il targeting della modalità di esecuzione di pubblicazione, ovvero config.publish:

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

  2. Nella cartella di configurazione, creare un file di tipo nt:file denominato com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config.

  3. Popolare com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config con quanto segue. Imposta una dimensione massima (in byte) per il download come valore di asset.download.prezip.maxcontentsize. L’esempio seguente configura la dimensione massima del download ZIP a un massimo di 100 KB.

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

Disabilita servlet di download risorse disable-asset-download-servlet

Se non hai bisogno della funzionalità di download, disattiva il servlet per evitare rischi di tipo DoS. È possibile disabilitare Asset Download Servlet in un'istanza di authoring e pubblicazione Experience Manager aggiornando la configurazione del dispatcher per bloccare eventuali richieste di download di risorse. Il servlet può anche essere disabilitato manualmente tramite la console OSGi direttamente.

  1. Per bloccare le richieste di download di risorse tramite una configurazione di Dispatcher, modifica la configurazione dispatcher.any e aggiungi una nuova regola alla sezione filtro.

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

Rappresentazione OnTime o OffTime on-off-time-rendition

Per abilitare il servizio OnOffTimeAssetAccessFilter, è necessario creare una configurazione OSGi. Questo servizio consente di bloccare l’accesso alle rappresentazioni e ai metadati, oltre che alla risorsa stessa, in base alle impostazioni di ora di attivazione/disattivazione. La configurazione OSGi deve essere per com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter. Effettua le seguenti operazioni:

  1. Nel codice del progetto in Git, crea un file di configurazione in /apps/system/config/com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter.cfg.json. Il file deve contenere {} come contenuto, a indicare una configurazione OSGi vuota per il componente OSGi corrispondente. Questa azione abilita il servizio.
  2. Distribuire il codice, inclusa la nuova configurazione, tramite Cloud Manager.
  3. Una volta implementati, i rendering e i metadati sono accessibili in base alle impostazioni di orario di attivazione/disattivazione delle risorse. Se la data o l’ora corrente cade prima dell’ora di attivazione o dopo l’ora di disattivazione, viene visualizzato un messaggio di errore.
    Per ulteriori dettagli sull'aggiunta di una configurazione OSGi vuota, consulta questa guida.

Suggerimenti e limitazioni tips-limitations

  • Se si scarica una cartella vuota, Experience Manager trasmette un messaggio di operazione riuscita sulla creazione di un archivio ZIP, ma l'archivio non viene creato.

Consulta anche

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