在Experience Manager Sites中使用“连接的Assets”共享DAM资源 use-connected-assets-to-share-dam-assets-in-aem-sites

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

在大型企业中,可以分发创建网站所需的基础环境。有时,网站创建功能和用于创建这些网站的数字资产可能驻留在不同的部署中。一个原因可能是地理上分散但需要协同工作的现有部署。 另一个原因可能是并购导致基础架构存在差异,包括母公司希望一起使用的不同Experience Manager版本。

通过集成Experience Manager Sites和Experience Manager Assets,“连接的Assets”功能支持上述用例。 用户可以在Sites中创建使用来自单独Assets部署的数字资产的网页。

NOTE
只有在您需要使用远程DAM部署中的可用资产来进行单独的Sites部署创作网页时,才配置“连接的Assets”。

连接的Assets概述 overview-of-connected-assets

在页面编辑器中作为目标目标目标位置编辑页面时,作者可以从作为资产源的其他Assets部署中无缝搜索、浏览和嵌入资产。 管理员创建具有Sites功能的Experience Manager的部署与具有Assets功能的Experience Manager的另一个部署的一次性集成。 站点作者还可以通过Connected Assets在其站点的网页中使用Dynamic Media图像,并使用Dynamic Media功能,如智能裁切和图像预设。

对于Sites作者,远程资产可用作只读本地资产。 该功能支持在站点编辑器中无缝搜索和访问远程资产。 对于可能要求在站点上提供完整资产语料的任何其他用例,请考虑批量迁移资产,而不是使用“连接的Assets”。 请参阅Experience Manager Assets迁移指南

先决条件和支持的部署 prerequisites

在使用或配置此功能之前,请确保:

  • 用户是每个部署中相应用户组的一部分。

  • 对于Adobe Experience Manager部署类型,满足一个支持的条件。 Experience Manager 6.5 Assets与Experience Manageras a Cloud Service配合使用。 有关此功能如何在Experience Manager中作为Cloud Service使用的更多信息,请参阅Experience Manageras a Cloud Service🔗中的连接的Assets。

    table 0-row-4 1-row-4 2-row-4 3-row-4
    Sites as a Cloud Service AMS上的Experience Manager 6.5 Sites Experience Manager 6.5 Sites内部部署
    Experience Manager Assetsas aCloud Service 支持 支持 支持
    AMS 上的 ​Experience Manager 6.5 Assets 支持 支持 支持
    Experience Manager6.5 Assets内部部署 不支持 不支持 不支持

支持的文件格式 mimetypes

作者在内容查找器中搜索图像和以下类型的文档,并在页面编辑器中拖动搜索到的资产。 文档已添加到Download组件,图像已添加到Image组件。 作者还可以在任何自定义Experience Manager组件中添加远程资产,以扩展默认DownloadImage组件。 支持的格式包括:

涉及的用户和组 users-and-groups-involved

下面介绍了配置和使用该功能所涉及的各种角色,及其相应的用户组。对于作者创建网页的用例,使用本地范围。 对于托管所需资产的 DAM 部署,使用远程范围。Sites作者获取这些远程资产。

角色
范围
用户组
演示中的用户名
描述
Sites管理员
本地
Experience Manager administrators
admin
设置Experience Manager并配置与远程Assets部署的集成。
DAM 用户
本地
Authors
ksaner
用于查看和复制在 /content/DAM/connectedassets/ 上获取的资产。
Sites作者
本地
  • Authors (对远程DAM具有读取访问权限,对本地Sites具有作者访问权限)
  • 本地Sites上的dam-users
ksaner
最终用户是使用此集成提高内容速度的Sites作者。 作者使用内容查找器在本地Web页中使用所需的图像在远程DAM中搜索和浏览资产。 使用的 DAM 用户的 ksaner 凭据。
Assets管理员
远程
Experience Manager administrators
远程Experience Manager上的admin
配置跨源资源共享 (CORS)。
DAM 用户
远程
Authors
远程Experience Manager上的ksaner
远程Experience Manager部署上的作者角色。 使用内容查找器在“连接的Assets”中搜索和浏览资源。
DAM 分发人员(技术用户)
远程
Sites Authors
远程Experience Manager上的ksaner
Experience Manager本地服务器(不是Sites作者角色)代表Sites作者使用远程部署上的此用户获取远程资产。 此角色与上述两个 ksaner 角色不同,它属于另一个不同的用户组。

连接的Assets架构 connected-assets-architecture

Experience Manager允许您将远程DAM部署作为源连接到多个Experience ManagerSites部署。 但是,您只能将Sites部署与一个远程DAM部署连接。

评估连接到远程DAM部署的最佳站点实例数量。 Adobe建议将Sites实例增量连接到部署,并测试远程DAM上的性能不会受到影响,因为每个连接的Sites实例都会贡献远程DAM上的数据流量。

下图说明了支持的场景:

连接的Assets架构

下图说明了不支持的方案:

连接的Assets架构

配置Sites和Assets部署之间的连接 configure-a-connection-between-sites-and-assets-deployments

Experience Manager管理员可以创建此集成。 创建后,使用该集成所需的权限是通过用户组建立的。 用户组是在Sites部署和DAM部署中定义的。

要配置“连接的Assets”和本地Sites连接,请执行以下步骤:

  1. 访问现有Sites部署或使用以下命令创建部署:

    1. 在JAR文件的文件夹中,在终端上执行以下命令以创建每个Experience Manager服务器。

      java -Xmx4096m -jar <quickstart jar filepath> -r samplecontent -p 4502 -nofork -gui -nointeractive &

    2. 几分钟后,Experience Manager服务器成功启动。 将此Sites部署视为用于网页创作的本地计算机,例如https://[local_sites]:4502

  2. 确保Sites部署和AMS上的Assets部署中存在具有适当范围的用户和角色。 在Assets部署上创建技术用户,并将其添加到涉及的用户和组中提到的用户组。

  3. 访问位于https://[local_sites]:4502的本地Sites部署。 单击​ 工具 > 资产 > 连接的资产配置,并提供以下值:

    1. 配置的​ 标题
    2. 远程DAM URL ​是Assets位置的URL,格式为https://[assets_servername]:[port]
    3. DAM 分发人员(技术用户)的凭据。
    4. 在​ 装入点 ​字段中,输入Experience Manager获取资产的本地Experience Manager路径。 例如,remoteassets文件夹。 从DAM获取的资产存储在Sites部署的此文件夹中。
    5. 本地站点URL ​是Sites部署的位置。 Assets部署使用此值维护对此Sites部署获取的数字资产的引用。
    6. Sites技术用户的凭据。
    7. 原始二进制传输优化阈值 ​字段的值指定是否同步传输原始资产(包括演绎版)。 具有较小文件大小的Assets可以轻松获取,而文件大小相对较大的资源最好进行异步同步。 该值取决于您的网络功能。
    8. 如果您使用数据存储来存储您的资源并且数据存储在这两个部署之间共享,请选择​ 与连接的Assets共享的数据存储。 在这种情况下,阈值限制并不重要,因为实际的资产二进制文件在数据存储上可用并且不会传输。

    连接的Assets功能的典型配置

    图:连接的Assets功能的典型配置。

  4. 已处理Assets部署上的现有数字资产,并生成演绎版。 使用此功能获取这些演绎版,因此无需重新生成演绎版。 禁用工作流启动器以防止重新生成节目。 调整(Sites)部署上的启动器配置以排除connectedassets文件夹(在此文件夹中获取资产)。

    1. 在Sites部署中,单击​ 工具 > 工作流 > 启动器

    2. 搜索工作流为 DAM 更新资产 ​和 DAM 元数据写回 ​的启动器。

    3. 选择工作流启动器,然后单击操作栏上的​ 属性

    4. 在属性向导中,将​ 路径 ​字段更改为以下映射来更新其正则表达式,以排除装入点​ connectedassets

    table 0-row-2 1-row-2 2-row-2 3-row-2
    之前 之后
    /content/dam(/((?!/subassets).)*/)renditions/original /content/dam(/((?!/subassets)(?!connectedassets).)*/)renditions/original
    /content/dam(/.*/)renditions/original /content/dam(/((?!connectedassets).)*/)renditions/original
    /content/dam(/.*)/jcr:content/metadata /content/dam(/((?!connectedassets).)*/)jcr:content/metadata
    note note
    NOTE
    在作者获取资产时,将会获取远程部署中可用的所有演绎版。 如果要为获取的资产创建更多演绎版,请跳过此配置步骤。触发DAM更新资产工作流并创建更多演绎版。 这些演绎版仅在本地Sites部署中可用,在远程DAM部署中不可用。
  5. 在Assets部署的CORS配置中将Sites部署添加为允许的源。 有关详细信息,请参阅了解CORS

  6. 配置相同站点Cookie支持

您可以检查配置的Sites部署和Assets部署之间的连接。

已配置 连接的Assets的连接测试Sites
图:连接的Assets的连接测试配置了Sites。

使用Dynamic Media资源 dynamic-media-assets

通过连接的Assets,您可以使用Dynamic Media从站点页面上的远程DAM部署处理的图像资源,并使用Dynamic Media功能,如智能裁切和图像预设。

要将Dynamic Media与连接的Assets一起使用:

  1. 在启用了同步模式的远程DAM部署上配置Dynamic Media。
  2. 配置连接的Assets
  3. 使用在远程DAM上配置的相同公司名称在站点实例上配置Dynamic Media。 Sites部署必须对Dynamic Media帐户具有只读访问权限,才能使用连接的资源。 因此,请确保在站点实例的Dynamic Media配置中禁用同步模式。
CAUTION
使用“连接的Assets”和Dynamic Media配置,无法使用Dynamic Media处理Sites部署中可用的本地资源。

配置 Dynamic Media configure-dynamic-media

要在Assets和Sites部署中配置Dynamic Media,请执行以下操作:

  1. 在远程Assets作者部署上启用Dynamic Media并将其配置为全局配置。 要配置Dynamic Media,请参阅配置Dynamic Media
    在远程Assets部署中,在Dynamic Media同步模式中,选择​ 默认启用

  2. 创建连接的Assets配置,如配置站点与资源部署之间的连接中所述。 此外,选择​ 为Dynamic Media连接的Assets获取原始演绎版 ​选项。

  3. 在本地Sites和远程Assets部署上配置Dynamic Media。 按照说明配置 Dynamic Media

    • 在所有配置中使用相同的公司名称。
    • 在本地Sites上,在Dynamic Media同步模式中,选择​ 默认情况下已禁用。 Sites部署必须对Dynamic Media帐户具有只读访问权限。
    • 在本地Sites上的​ Publish Assets ​选项中,选择​ 选择性Publish。 不要选择​ 同步所有内容
  4. 在图像核心组件🔗中启用Dynamic Media 支持。 此功能允许当作者在本地Sites部署的网页中使用Dynamic Media个图像时,默认的图像组件显示Dynamic Media个图像。

使用远程资产 use-remote-assets

网站作者使用内容查找器连接到DAM部署。 作者可以浏览、搜索以及拖动组件中的远程资产。要验证远程DAM,请准备好管理员提供的凭据(如果有)。

作者可以在单个网页中使用本地DAM和远程DAM部署上可用的资产。 使用内容查找器,可在搜索本地 DAM 与搜索远程 DAM 之间切换。

仅获取那些具有完全对应的标记以及相同分类层次结构(在本地Sites部署中可用)的远程资产标记。 任何其他标记都将被丢弃。作者可以使用远程Experience Manager部署中存在的所有标记搜索远程资产,因为它提供全文搜索。

使用说明演示 walk-through-of-usage

使用上述设置尝试创作体验,以了解该功能是如何运作的。使用您在远程 DAM 部署中选择的文档或图像。

  1. 通过从Experience Manager工作区访问​ Assets > 文件,导航到远程部署上的Assets界面。 或者,也可以在浏览器中访问 https://[assets_servername_ams]:[port]/assets.html/content/dam。上传您选择的资产。

  2. 在Sites部署上,在右上角的配置文件激活器中单击​ 模拟为。 提供 ksaner 作为用户名,选择提供的选项,然后单击​ 确定

  3. 打开 We.Retail 网页:Sites > We.Retail > us > en。编辑页面。或者,也可以在浏览器中访问 https://[aem_server]:[port]/editor.html/content/we-retail/us/en/men.html 以编辑页面。

    单击页面左上角的​ 切换侧面板

  4. 打开Assets选项卡(远程内容查找器),然后单击​ 登录到连接的Assets

  5. 提供凭据 – ksaner 作为用户名,password 作为密码。此用户对Experience Manager部署都具有创作权限。

  6. 搜索您添加到 DAM 的资产。远程资产会显示在左侧面板中。筛选图像或文档,并进一步筛选支持的文档类型。拖动 Image 组件上的图像和 Download 组件上的文档。

    获取的资产在本地Sites部署上是只读的。 您仍然可以使用Sites组件提供的选项来编辑获取的资产。 通过组件进行的编辑是无损的。

    在远程 DAM 上搜索资产时,筛选文档类型和图像的选项

    图:在远程DAM上搜索资产时,筛选文档类型和图像的选项。

  7. 如果异步获取资产的原始资产且获取任务失败,会通知站点作者。 在创作过程中甚至是创作后,作者可以在异步作业用户界面中查看有关获取任务和错误的详细信息。

    关于在后台进行的异步获取资产的通知。

    图:关于在后台进行的异步获取资产的通知。

  8. 发布页面时,Experience Manager显示页面上使用的资产的完整列表。 请确保在发布时成功获取了远程资产。要检查每个获取的资产的状态,请参阅异步作业用户界面。

    note note
    NOTE
    即使未完全获取一个或多个远程资产,页面也会发布。 Experience Manager通知区域显示异步作业页面中显示的错误通知。
CAUTION
获取的远程资产一经在网页中使用后,有权访问本地文件夹的任何人都可以搜索和使用这些资产。 获取的资产存储在本地文件夹中(上述演练中的connectedassets)。 此外,还可通过内容查找器,搜索和查看本地存储库中的资产。

获取的资产可用作任何其他本地资产,但关联的元数据无法编辑。

检查跨网页的资源使用 asset-usage-references

Experience Manager允许DAM用户检查对资产的所有引用。 它有助于了解和管理远程Sites和复合资产中的资产使用情况。 部署Experience Manager Sites的网页的许多作者可以在不同网页中使用远程Assets上的资产。 要简化资产管理且不会导致引用损坏,DAM用户务必要检查本地和远程网页上资源的使用情况。 资产的属性页面中的引用选项卡列出了资产的本地和远程引用。

要查看和管理Assets部署中的引用,请执行以下步骤:

  1. 在Assets控制台中选择资源,然后单击工具栏中的​ 属性

  2. 单击​ 引用 ​选项卡。 查看​ 本地引用 ​以在Assets部署中使用资产。 请参阅**远程引用,以在Sites部署上使用资产,其中资产是使用连接的Assets功能获取的。

    资产属性页面中的 远程引用

  3. Sites页的引用显示每个本地Sites的引用总数。 查找所有引用并显示引用总数可能需要一些时间。

  4. 引用列表是交互式的,DAM用户可以单击引用以打开引用页面。 如果由于某个原因无法获取远程引用,则会显示通知以告知用户该故障。

  5. 用户可以移动或删除资源。 移动或删除资源时,所有选定资源/文件夹的引用总数都会显示在警告对话框中。 删除尚未检索其引用的资产时,会显示警告对话框。

    强制删除警告

管理远程DAM中资产的更新 manage-updates-in-remote-dam

在远程DAM和Sites部署之间配置连接后,远程DAM上的资源将在Sites部署中可用。 然后,您可以对远程DAM资源或文件夹执行更新、删除、重命名和移动操作。 更新在Sites部署中自动可用,但有一些延迟。 此外,如果在本地Experience Manager Sites页面上使用远程DAM上的资产,则对Sites页面上显示的远程DAM上资产的更新。

将资产从一个位置移动到另一个位置时,请确保您调整引用,以便资产显示在Sites页面上。 如果将资产移动到无法从本地Sites部署访问的位置,则该资产无法在Sites部署中显示。

您还可以更新远程DAM上资产的元数据属性,并且所做的更改可在本地Sites部署中使用。

Sites作者可以预览Sites部署中的可用更新,然后重新发布更改以使其在Experience Manager发布实例中可用。

Experience Manager在Remote Assets Content Finder中的资产上显示已过期状态视觉标志,以阻止网站作者在Sites页面上使用该资产。 如果您在Sites页面上使用具有过期状态的资源,则该资源无法在Experience Manager发布实例上显示。

常见问题解答 frequently-asked-questions

如果需要使用Sites部署中可用的资源,是否应该配置“连接的Assets”?
在这种情况下,无需配置“连接的Assets”。 您可以使用Sites部署中可用的资产。
何时需要配置“连接的Assets”功能?
仅当您需要在Sites部署中使用远程DAM部署上可用的资源时,才配置“连接的Assets”功能。
配置“连接的Assets”后,是否可以将多个Sites部署连接到远程DAM部署?
是,在配置“连接的Assets”后,您可以将多个Sites部署连接到远程DAM部署。 有关详细信息,请参阅连接的Assets架构
在配置“连接的Assets”后,可以连接到Sites部署的远程DAM部署数量是多少?
在配置“连接的Assets”后,您可以将一个远程DAM部署连接到Sites部署。 有关详细信息,请参阅连接的Assets架构
配置“连接的Dynamic Media”后,能否使用Sites部署中的Assets资源?
配置“连接的Assets”后,Dynamic Media资源在只读模式下可在Sites部署中使用。 因此,无法使用Dynamic Media处理Sites部署中的资产。 有关详细信息,请参阅在Sites和Dynamic Media部署之间配置连接
配置“连接的Assets”后,能否在Sites部署上使用远程DAM部署中的图像和文档格式类型资产?
是,在配置连接的Assets后,您可以在Sites部署上使用远程DAM部署中的图像和文档格式类型资产。
配置“连接的Assets”后,能否在Sites部署上使用来自远程DAM部署的内容片段和视频资产?
不能,在配置“连接的Assets”后,您无法在Sites部署上使用来自远程DAM部署的内容片段和视频资产。
配置“连接的Dynamic Media”后,能否在Sites部署上使用来自远程DAM部署的Assets资源?
是,您可以在配置“连接的Dynamic Media”后,在Sites部署上从远程DAM部署配置并使用Assets图像资产。 有关详细信息,请参阅在Sites和Dynamic Media部署之间配置连接
配置“连接的Assets”后,能否对远程DAM资源或文件夹执行更新、删除、重命名和移动操作?
是,在配置“连接的Assets”后,您可以对远程DAM资源或文件夹执行更新、删除、重命名和移动操作。 更新会在Sites部署中自动提供,但会有一些延迟。 有关详细信息,请参阅管理远程DAM中资产的更新
配置“连接的Assets”后,能否在Sites部署中添加或修改资源并使其在远程DAM部署中可用?
您可以将资源添加到Sites部署,但是,这些资源无法用于远程DAM部署。

限制和最佳实践 tip-and-limitations

  • 要获取有关资源使用情况的见解,请在Sites实例上配置Assets Insight功能。

  • 无法将远程资产拖到图像组件“配置”对话框上。 但是,您无需单击​ 配置,即可将远程资产直接拖到“站点”页面上的图像组件中。

权限和资产管理 permissions-and-managing-assets

  • 本地资产是只读副本。Experience Manager个组件对资源进行无损编辑。 不允许进行其他编辑。
  • 本地获取的资产只能用于创作。不能应用资产更新工作流,也不能编辑元数据。
  • 仅支持图像和列出的文档格式。不支持Content Fragments和Experience Fragments。
  • Experience Manager未获取元数据架构。 这意味着可能无法显示所有获取的元数据。 如果在Sites部署中单独更新架构,则会显示所有元数据属性。
  • 所有Sites作者都拥有对获取的副本的读取权限,即使作者无法访问远程DAM部署。
  • 没有支持自定义集成的 API。
  • 该功能支持无缝搜索和使用远程资产。为了能够在本地部署中一次使用许多远程资产,请考虑批量迁移这些资产。请参阅 Assets 迁移指南
  • 无法在页面属性用户界面上将远程资产用作页面缩略图。 您可以从缩略图的页面属性用户界面中设置网页的缩略图,方法是单击选择图像。

设置和许可 setup-licensing

  • 支持Adobe Managed Services上的Assets部署。
  • Sites一次可以连接到单个Assets部署。
  • 需要Assets的许可证用作远程存储库。
  • 需要Sites的一个或多个许可证用作本地创作部署。

用途 usage

  • 用户可以在创作时搜索远程资产并将这些资产拖动到本地页面上。 不支持其他功能。
  • 获取操作会在 5 秒后超时。作者在获取资产时可能会遇到问题,比如,网络问题。作者可以通过将远程资产从内容查找器拖到页面编辑器来重新尝试。
  • 可以对获取的资产执行无损的简单编辑以及通过Image组件支持的编辑。 资产是只读的。
  • 重新获取资产的唯一方法是将其拖动到页面上。 没有API支持或其他方法可重新获取资产以对其进行更新。
  • 如果从DAM中停用资产,则这些资产将继续在Sites页面上使用。
  • 资产的远程引用条目是异步获取的。 引用和总计数不是实时的,并且如果Sites作者在DAM用户查看引用时使用资产,则可能会有一些差异。 DAM用户可以刷新页面,并在几分钟后重试以获取总计数。

问题疑难解答 troubleshoot

要排除常见错误,请执行以下步骤:

  • 如果无法从内容查找器搜索远程资产,请确保已具备所需的角色和权限。

  • 出于一个或多个原因,从远程DAM获取的资产可能不会发布到网页上。 它不存在于远程服务器上,缺少获取它的相应权限,或者可能是网络故障所致。 确保资产没有从远程DAM中删除。 确保具有适当的权限并且满足先决条件。 重试将资产添加到页面并重新发布。 检查异步作业列表,查看是否发生了资产获取错误。

  • 如果您无法从本地Sites部署访问远程DAM部署,请确保允许跨站点Cookie并配置了相同的站点Cookie支持。 如果跨站点Cookie被阻止,Experience Manager的部署可能无法进行身份验证。 例如,无痕模式下的Google Chrome可能会阻止第三方Cookie。 要在Chrome浏览器中允许Cookie,请单击地址栏中的“眼睛”图标,导航到​ 站点无法工作 > 已阻止,选择远程DAM URL,并允许登录令牌Cookie。 或者,请参阅如何启用第三方Cookie

    在无痕模式下Chrome浏览器中出现 Cookie错误

  • 如果您无法从Managed Servicesas a Cloud Service站点Adobe访问Experience Manager Sites远程DAM部署,请更新位于"/etc/httpd/conf.d/available_vhostsaem_author.vhost文件,以便远程DAM在Dispatcher配置中包含以下标头:

    code language-xml
    Header Set Access-Control-Allow-Origin <Local Sites instance host>
    Header Set Access-Control-Allow-Credentials true
    
  • 如果未检索到远程引用并导致错误消息,请检查Sites部署是否可用并检查网络连接问题。 请稍后重试以检查。 Assets部署尝试与Sites部署建立连接两次,然后报告失败。

    无法检索资源远程引用

  • 如果未将Cookie从Sites服务器发送到Google Chrome中的Assets服务器,这是因为Assets连接不是通过HTTPS进行的。 如果您没有在Assets实例上使用HTTPS,则在您使用Assets服务器进行身份验证后,无法将SameSite=None标头添加到响应中。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2