从Adobe Experience Manager下载资源 download-assets-from-aem

版本
文章链接
AEM 6.5
单击此处
AEM as a Cloud Service
本文

您可以下载资源,包括静态和动态演绎版。 或者,您可以直接从Adobe Experience Manager Assets发送带有资产链接的电子邮件。 下载的资源捆绑在一个ZIP文件中。

无法下载以下资源类型:图像集、旋转集、混合媒体集和轮播集。

您可以使用以下方法从Experience Manager下载资源:

使用Experience Manager界面下载资源 download-assets

Experience Manager根据资源数量和大小优化下载体验。 从用户界面实时下载较小的文件。 Experience Manager直接下载原始文件的单个资产请求,而不是将单个资产放在ZIP存档中,以便更快地下载。 Experience Manager支持通过异步请求进行大型下载。 大于100 GB的下载请求将拆分为多个ZIP存档,每个存档的最大大小为100 MB。

默认情况下,Experience Manager会在生成下载存档时在Experience Manager 收件箱中触发通知。

收件箱通知

为大型下载启用电子邮件通知 enable-emails-for-large-downloads

在以下任意情况下都会触发异步下载:

  • 如果有十个以上的资产
  • 如果下载大小大于100 MB
  • 如果下载准备时间超过30秒

在后端运行异步下载时,用户可以继续探索并进一步在Experience Manager中工作。 除了Experience Manager收件箱通知之外,Experience Manager还可以发送电子邮件,以在下载过程完成后通知User。 若要启用此功能,管理员可以通过配置SMTP服务器连接来配置电子邮件服务。

配置电子邮件服务后,管理员和用户可以从Experience Manager界面启用电子邮件通知。

要启用电子邮件通知,请执行以下操作:

  1. 登录到Experience Manager Assets。

  2. 单击右上角的用户图标,然后单击​ 我的首选项 ​以打开“用户首选项”窗口。

  3. 选中​ 资产下载电子邮件通知 ​复选框,然后单击​ 接受

    启用大型下载的电子邮件通知

要下载资产,请执行以下步骤:

  1. 在Experience Manager用户界面中,单击​ Assets > 文件

  2. 导航到要下载的资源。 选择文件夹或文件夹中的一个或多个资源。 在工具栏上,单击​ 下载

    从Experience Manager Assets 下载资源时可用选项

  3. 在下载对话框中,选择所需的下载选项。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
    下载选项 描述
    为每个资产创建单独的文件夹 选择此选项可为每个资源创建一个文件夹,其中包含资源的所有已下载演绎版。 如果未选定该属性,则每个资产(以及所选的下载资产演绎版)都会包含在生成的存档的父文件夹中。
    电子邮件

    选择此选项可向其他用户发送电子邮件通知(包含下载链接)。 收件人用户必须是dam-users组的成员。 标准电子邮件模板可在以下位置使用:

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

    您可以在以下位置找到部署期间自定义的模板:

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

    您可以在以下位置存储特定于租户的自定义模板:

    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/downloadasset
    • /conf/<tenant_specific_config_root>/settings/dam/workflow/notification/email/transientworkflowcompleted
    资源 选择此选项可下载原始格式的资源。
    如果原始资产具有子资产,则子资产选项可用。
    节目 演绎版是资产的二进制表示形式。 Assets具有主要表示形式 — 已上传文件的主要表示形式。 它们可以有任意数量的呈现。
    使用此选项,您可以选择想要下载的演绎版。 可用的演绎版取决于您选择的资源。
    智能裁剪 选择此选项可从Experience Manager内下载所选资源的所有智能裁剪演绎版。 将创建包含智能裁剪呈现的zip文件并下载到本地计算机。
    动态演绎版 选择此选项可实时生成一系列替代演绎版。 选择此选项时,您还可以通过从图像预设列表中选择来选择要动态创建的演绎版。
    此外,您还可以选择大小和度量单位、格式、颜色空间、分辨率以及任何可选的图像修饰符(如反转图像)。 仅当您启用了Dynamic Media时,该选项才可用。
  4. 在该对话框中,单击​ 下载

    如果为大型下载启用了电子邮件通知,则收件箱中会显示一封包含已存档zip文件夹的下载URL的电子邮件。 单击电子邮件中的下载链接以下载zip存档。

    大型下载的电子邮件通知

    您还可以在Experience Manager收件箱中查看通知。

    大型下载收件箱通知

使用链接共享资产是一种方便的方法,使感兴趣的人无需登录到Assets即可访问它。 查看链接共享功能

当用户从共享链接下载资产时,Assets使用异步服务,该服务可提供更快且无中断的下载。 要下载的资产将在收件箱中的后台排入可管理文件大小的ZIP存档中。 对于较大的下载,下载将分块为100 GB的文件。

下载收件箱显示每个存档的处理状态。 处理完成后,您可以从收件箱中下载存档。

下载收件箱

启用资源下载servlet enable-asset-download-servlet

Experience Manager中的默认servlet允许经过身份验证的用户发出任意大小的并发下载请求以创建资产的ZIP文件。 下载准备工作可能会影响性能,甚至可能导致服务器和网络过载。 为了减少此功能引起的此类类似DoS的潜在风险,已为发布实例禁用AssetDownloadServlet OSGi组件。 如果在创作实例上不需要下载功能,请在创作实例上禁用servlet。

要允许从DAM下载资产,例如在使用Asset Share Commons或其他类似门户的实施时,请通过OSGi配置手动启用servlet。 Adobe建议将允许的下载大小设置得尽可能小,而不影响日常下载要求。 高值可能会影响性能。

  1. 创建一个文件夹,该文件夹具有针对发布运行模式的命名约定,即config.publish

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

  2. 在配置文件夹中,创建名为com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.confignt:file类型的文件。

  3. 使用以下内容填充com.day.cq.dam.core.impl.servlet.AssetDownloadServlet.config。 将下载的最大大小(以字节为单位)设置为asset.download.prezip.maxcontentsize的值。 下面的示例将ZIP下载的最大大小配置为不超过100 KB。

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

禁用资源下载servlet disable-asset-download-servlet

如果您不需要下载功能,请禁用Servlet以防止任何类似DoS的风险。 通过更新Dispatcher配置以阻止任何资产下载请求,可以在Experience Manager创作和发布实例上禁用Asset Download Servlet。 也可以直接通过OSGi控制台手动禁用servlet。

  1. 要通过Dispatcher配置阻止资源下载请求,请编辑dispatcher.any配置并向筛选条件部分添加新规则。

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

OnTime或OffTime呈现版本 on-off-time-rendition

要启用OnOffTimeAssetAccessFilter服务,您需要创建OSGi配置。 根据开启/结束时间设置,此服务允许除了资源本身之外,还阻止对演绎版和元数据的访问。 OSGi配置应为com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter。 应遵循以下步骤:

  1. 在Git中的项目代码中,在/apps/system/config/com.day.cq.dam.core.impl.servlet.OnOffTimeAssetAccessFilter.cfg.json处创建一个配置文件。 该文件应包含{}作为其内容,表示相应的OSGi组件的OSGi配置为空。 此操作将启用该服务。
  2. 通过Cloud Manager部署您的代码,包括此新配置。
  3. 部署后,即可根据资源的开启/结束时间设置访问演绎版和元数据。 如果当前日期或时间早于开启时间或晚于关闭时间,则会显示错误消息。
    有关添加空OSGi配置的更多详细信息,请参阅此指南

提示和限制 tips-limitations

  • 如果下载空文件夹,Experience Manager会传达有关创建ZIP存档的成功消息,但并未创建该存档。

另请参阅

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