Descargar recursos de Adobe Experience Manager

Última actualización: 2023-11-29
  • Creado para:
  • User
Versión Vínculo del artículo
AEM 6.5 Haga clic aquí
AEM as a Cloud Service Este artículo

Puede descargar recursos, incluidas representaciones estáticas y dinámicas. También puede enviar correos electrónicos con vínculos a recursos directamente desde Adobe Experience Manager Assets. Los recursos descargados están agrupados en un archivo ZIP.

No se pueden descargar los siguientes tipos de recursos: conjuntos de imágenes, conjuntos de giros, conjuntos de medios mixtos y conjuntos de carrusel.

Puede descargar recursos desde Experience Manager mediante los siguientes métodos:

Descarga de recursos mediante Experience Manager interfaz

Experience Manager optimiza la experiencia de descarga en función de la cantidad y el tamaño del recurso. Los archivos más pequeños se descargan de la interfaz de usuario en tiempo real. Experience Manager descarga directamente solicitudes de recursos únicas para el archivo original, en lugar de incluir recursos únicos en un archivo ZIP para permitir descargas más rápidas. Experience Manager admite descargas grandes con solicitudes asincrónicas. Las solicitudes de descarga superiores a 100 GB se dividen en varios archivos ZIP con un tamaño máximo de 100 MB cada uno.

De forma predeterminada, Experience Manager déclencheur una notificación en el Experience Manager Bandeja de entrada tras la generación de un archivo de descarga.

Notificación de bandeja de entrada

Habilitar notificaciones por correo electrónico para descargas grandes

Las descargas asincrónicas se activan en cualquiera de los siguientes casos:

  • Si hay más de diez recursos
  • Si el tamaño de la descarga es superior a 100 MB
  • Si la descarga tarda más de 30 segundos en prepararse

Mientras que la descarga asincrónica se ejecuta en el back-end de, el usuario puede seguir explorando y trabajando más en Experience Manager. Además de las notificaciones de la bandeja de entrada del Experience Manager, el Experience Manager puede enviar correos electrónicos para notificar al usuario una vez completado el proceso de descarga. Para habilitar esta función, los administradores pueden configurar el servicio de correo electrónico de la siguiente manera: configuración de una conexión de servidor SMTP.

Una vez configurado el servicio de correo electrónico, los administradores y los usuarios pueden activar las notificaciones por correo electrónico desde la interfaz del Experience Manager.

Para habilitar las notificaciones por correo electrónico:

  1. Iniciar sesión en Experience Manager Assets.

  2. Haga clic en el icono de usuario en la esquina superior derecha y, a continuación, haga clic en Mis preferencias para abrir la ventana Preferencias de usuario.

  3. Seleccione el Notificaciones de correo electrónico de descarga de recursos y haga clic en Aceptar.

    enable-email-notifications-for-large-downloads

Para descargar recursos, siga estos pasos:

  1. Entrada Experience Manager interfaz de usuario, haga clic en Assets > Archivos.

  2. Desplácese hasta los recursos que desee descargar. Seleccione la carpeta o seleccione uno o varios recursos de la carpeta. En la barra de herramientas, haga clic en Descargar.

    Opciones disponibles al descargar recursos desde Experience Manager Assets

  3. En el cuadro de diálogo de descarga, seleccione las opciones de descarga que desee.

    Opción Descargar Descripción
    Crear una carpeta independiente para cada recurso Seleccione esta opción para crear una carpeta para cada recurso que contenga todas las representaciones descargadas para el recurso. Si no se selecciona, cada recurso (y sus representaciones si se seleccionan para su descarga) se encuentra en la carpeta principal del archivo generado.
    Correo electrónico Seleccione esta opción para enviar una notificación por correo electrónico (que contenga un vínculo a la descarga) a otro usuario. El usuario destinatario debe ser miembro de dam-users grupo. Las plantillas de correo electrónico estándar están disponibles en las siguientes ubicaciones:
    • /libs/settings/dam/workflow/notification/email/downloadasset.
    • /libs/settings/dam/workflow/notification/email/transientworkflowcompleted.
    Las plantillas que personaliza durante la implementación están disponibles en las siguientes ubicaciones:
    • /apps/settings/dam/workflow/notification/email/downloadasset.
    • /apps/settings/dam/workflow/notification/email/transientworkflowcompleted.
    Puede almacenar plantillas personalizadas específicas del inquilino en las siguientes ubicaciones:
    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/downloadasset.
    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/transientworkflowcompleted.
    Recursos Seleccione esta opción para descargar el recurso en su forma original.
    La opción subrecursos está disponible si el recurso original tiene subrecursos.
    Representaciones Una representación es la representación binaria de un recurso. Los recursos tienen una representación principal: la del archivo cargado. Pueden tener cualquier número de representaciones.
    Con esta opción, puede seleccionar las representaciones que desee descargar. Las representaciones disponibles dependen del recurso seleccionado.
    Recortes inteligentes Seleccione esta opción para descargar todas las representaciones de recorte inteligente del recurso seleccionado desde Experience Manager. Se crea un archivo zip con las representaciones de recorte inteligente y se descarga en el equipo local.
    Representaciones dinámicas Seleccione esta opción para generar una serie de representaciones alternativas en tiempo real. Al seleccionar esta opción, también puede seleccionar las representaciones que desea crear dinámicamente seleccionando en el Ajuste preestablecido de imagen lista.
    Además, puede seleccionar el tamaño y la unidad de medida, el formato, el espacio de color, la resolución y cualquier modificador de imagen opcional, como la inversión de la imagen. La opción solo está disponible si tiene Dynamic Media activado.
  4. En el cuadro de diálogo, haga clic en Descargar.

    Si la notificación por correo electrónico está habilitada para descargas grandes, aparecerá en la bandeja de entrada un mensaje de correo electrónico con la URL de descarga de la carpeta zip archivada. Haga clic en el vínculo de descarga del correo electrónico para descargar el archivo zip.

    email-notifications-for-large-downloads

    También puede ver la notificación en su Experience Manager Bandeja de entrada.

    inbox-notifications-for-large-downloads

Compartir recursos mediante un vínculo es una forma cómoda de ponerlos a disposición de las personas interesadas sin tener que iniciar sesión en Assets. Consulte Funcionalidad de vínculo compartido.

Cuando los usuarios descargan recursos desde vínculos compartidos, Assets utiliza un servicio asincrónico que ofrece descargas más rápidas e ininterrumpidas. Los recursos que se van a descargar se colocan en segundo plano en una bandeja de entrada en archivos ZIP de tamaño de archivo manejable. Para descargas mayores, la descarga se divide en archivos de 100 GB.

El Descargar bandeja de entrada muestra el estado de procesamiento de cada archivo. Una vez completado el procesamiento, puede descargar los archivos desde la bandeja de entrada.

Descargar bandeja de entrada

Habilitar servlet de descarga de recursos

El servlet predeterminado en Experience Manager permite a los usuarios autenticados emitir solicitudes de descarga simultáneas y arbitrariamente grandes para crear archivos ZIP de recursos. La preparación de la descarga puede tener implicaciones de rendimiento o incluso puede sobrecargar el servidor y la red. Para mitigar estos riesgos potenciales de tipo DoS causados por esta función, AssetDownloadServlet El componente OSGi está deshabilitado para las instancias de publicación. Si no necesita la función de descarga en instancias de autor, deshabilite el servlet en Author.

Para permitir la descarga de recursos desde su DAM, por ejemplo, cuando utilice algo como Asset Share Commons u otra implementación similar a un portal, habilite manualmente el servlet a través de una configuración OSGi. El Adobe recomienda configurar el tamaño de descarga permitido lo más bajo posible sin afectar a los requisitos de descarga diarios. Un valor alto puede afectar al rendimiento.

  1. Cree una carpeta con una convención de nombres que se dirija al modo de ejecución de publicación, es decir, config.publish:

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

  2. En la carpeta de configuración, cree un archivo de tipo nt:file nombrado com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config.

  3. Rellenar com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config con lo siguiente. Establece un tamaño máximo (en bytes) para la descarga como el valor de asset.download.prezip.maxcontentsize. El siguiente ejemplo configura el tamaño máximo de la descarga ZIP para que no supere los 100 KB.

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

Deshabilitar servlet de descarga de recursos

Si no necesita la funcionalidad de descarga, deshabilite el servlet para evitar riesgos similares al DoS. El Asset Download Servlet se puede deshabilitar en un Experience Manager cree y publique instancias actualizando la configuración de dispatcher para bloquear cualquier solicitud de descarga de recursos. El servlet también se puede deshabilitar manualmente a través de la consola OSGi directamente.

  1. Para bloquear solicitudes de descarga de recursos mediante una configuración de Dispatcher, edite el dispatcher.any y agregue una nueva regla a la sección de filtro.

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

Representación OnTime u OffTime

Para habilitar la variable OnOffTimeAssetAccessFilter , debe crear una configuración OSGi. Este servicio permite bloquear el acceso a representaciones y metadatos, además del propio recurso en función de la configuración de tiempo de activación/desactivación. La configuración de OSGi debe ser para com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter. Complete los siguientes pasos:

  1. En el código del proyecto en Git, cree un archivo de configuración en /apps/system/config/com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter.cfg.json. El archivo debe contener {} como su contenido, lo que significa una configuración OSGi vacía para el componente OSGi correspondiente. Esta acción habilita el servicio.
  2. Implemente su código, incluida esta nueva configuración, a través de Cloud Manager.
  3. Una vez implementados, se puede acceder a las representaciones y los metadatos según la configuración de tiempo de activación y desactivación de los recursos. Si la fecha u hora actual es anterior a la hora de activación o posterior a la hora de inactividad, se muestra un mensaje de error.
    Para obtener más información sobre cómo agregar una configuración OSGi vacía, puede consultar esto guía.

Sugerencias y limitaciones

  • Si descarga una carpeta vacía, Experience Manager transmite un mensaje de éxito acerca de la creación de un archivo ZIP, pero el archivo no se crea.

Consulte también

En esta página