在Experience Manager Sites中使用“连接的Assets”共享DAM资源 use-connected-assets-to-share-dam-assets-in-aem-sites
在大型企业中,可以分发创建网站所需的基础环境。有时,网站创建功能和用于创建这些网站的数字资产可能驻留在不同的部署中。一个原因可能是地理上分散但需要协同工作的现有部署。 另一个原因可能是并购导致基础架构存在差异,包括母公司希望一起使用的不同Experience Manager版本。
通过集成Experience Manager Sites和Experience Manager Assets,“连接的Assets”功能支持上述用例。 用户可以在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组件中添加远程资产,以扩展默认Download
或Image
组件。 支持的格式包括:
涉及的用户和组 users-and-groups-involved
下面介绍了配置和使用该功能所涉及的各种角色,及其相应的用户组。对于作者创建网页的用例,使用本地范围。 对于托管所需资产的 DAM 部署,使用远程范围。Sites作者获取这些远程资产。
administrators
admin
Authors
ksaner
/content/DAM/connectedassets/
上获取的资产。Authors
(对远程DAM具有读取访问权限,对本地Sites具有作者访问权限)- 本地Sites上的
dam-users
ksaner
ksaner
凭据。administrators
admin
Authors
ksaner
Authors
ksaner
ksaner
角色不同,它属于另一个不同的用户组。连接的Assets架构 connected-assets-architecture
Experience Manager允许您将远程DAM部署作为源连接到多个Experience ManagerSites部署。 但是,您只能将Sites部署与一个远程DAM部署连接。
评估连接到远程DAM部署的最佳站点实例数量。 Adobe建议将Sites实例增量连接到部署,并测试远程DAM上的性能不会受到影响,因为每个连接的Sites实例都会贡献远程DAM上的数据流量。
下图说明了支持的场景:
下图说明了不支持的方案:
配置Sites和Assets部署之间的连接 configure-a-connection-between-sites-and-assets-deployments
Experience Manager管理员可以创建此集成。 创建后,使用该集成所需的权限是通过用户组建立的。 用户组是在Sites部署和DAM部署中定义的。
要配置“连接的Assets”和本地Sites连接,请执行以下步骤:
-
访问现有Sites部署或使用以下命令创建部署:
-
在JAR文件的文件夹中,在终端上执行以下命令以创建每个Experience Manager服务器。
java -Xmx4096m -jar <quickstart jar filepath> -r samplecontent -p 4502 -nofork -gui -nointeractive &
-
几分钟后,Experience Manager服务器成功启动。 将此Sites部署视为用于网页创作的本地计算机,例如
https://[local_sites]:4502
。
-
-
确保Sites部署和AMS上的Assets部署中存在具有适当范围的用户和角色。 在Assets部署上创建技术用户,并将其添加到涉及的用户和组中提到的用户组。
-
访问位于
https://[local_sites]:4502
的本地Sites部署。 单击 工具 > 资产 > 连接的资产配置,并提供以下值:- 配置的 标题。
- 远程DAM URL 是Assets位置的URL,格式为
https://[assets_servername]:[port]
。 - DAM 分发人员(技术用户)的凭据。
- 在 装入点 字段中,输入Experience Manager获取资产的本地Experience Manager路径。 例如,
remoteassets
文件夹。 从DAM获取的资产存储在Sites部署的此文件夹中。 - 本地站点URL 是Sites部署的位置。 Assets部署使用此值维护对此Sites部署获取的数字资产的引用。
- Sites技术用户的凭据。
- 原始二进制传输优化阈值 字段的值指定是否同步传输原始资产(包括演绎版)。 具有较小文件大小的Assets可以轻松获取,而文件大小相对较大的资源最好进行异步同步。 该值取决于您的网络功能。
- 如果您使用数据存储来存储您的资源并且数据存储在这两个部署之间共享,请选择 与连接的Assets共享的数据存储。 在这种情况下,阈值限制并不重要,因为实际的资产二进制文件在数据存储上可用并且不会传输。
图:连接的Assets功能的典型配置。
-
已处理Assets部署上的现有数字资产,并生成演绎版。 使用此功能获取这些演绎版,因此无需重新生成演绎版。 禁用工作流启动器以防止重新生成节目。 调整(Sites)部署上的启动器配置以排除
connectedassets
文件夹(在此文件夹中获取资产)。-
在Sites部署中,单击 工具 > 工作流 > 启动器。
-
搜索工作流为 DAM 更新资产 和 DAM 元数据写回 的启动器。
-
选择工作流启动器,然后单击操作栏上的 属性。
-
在属性向导中,将 路径 字段更改为以下映射来更新其正则表达式,以排除装入点 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部署中不可用。 -
-
在Assets部署的CORS配置中将Sites部署添加为允许的源。 有关详细信息,请参阅了解CORS。
-
配置相同站点Cookie支持。
您可以检查配置的Sites部署和Assets部署之间的连接。
已配置
图:连接的Assets的连接测试配置了Sites。
使用Dynamic Media资源 dynamic-media-assets
通过连接的Assets,您可以使用Dynamic Media从站点页面上的远程DAM部署处理的图像资源,并使用Dynamic Media功能,如智能裁切和图像预设。
要将Dynamic Media与连接的Assets一起使用:
- 在启用了同步模式的远程DAM部署上配置Dynamic Media。
- 配置连接的Assets。
- 使用在远程DAM上配置的相同公司名称在站点实例上配置Dynamic Media。 Sites部署必须对Dynamic Media帐户具有只读访问权限,才能使用连接的资源。 因此,请确保在站点实例的Dynamic Media配置中禁用同步模式。
配置 Dynamic Media configure-dynamic-media
要在Assets和Sites部署中配置Dynamic Media,请执行以下操作:
-
在远程Assets作者部署上启用Dynamic Media并将其配置为全局配置。 要配置Dynamic Media,请参阅配置Dynamic Media。
在远程Assets部署中,在Dynamic Media同步模式中,选择 默认启用。 -
创建连接的Assets配置,如配置站点与资源部署之间的连接中所述。 此外,选择 为Dynamic Media连接的Assets获取原始演绎版 选项。
-
在本地Sites和远程Assets部署上配置Dynamic Media。 按照说明配置 Dynamic Media。
- 在所有配置中使用相同的公司名称。
- 在本地Sites上,在Dynamic Media同步模式中,选择 默认情况下已禁用。 Sites部署必须对Dynamic Media帐户具有只读访问权限。
- 在本地Sites上的 Publish Assets 选项中,选择 选择性Publish。 不要选择 同步所有内容。
-
在图像核心组件🔗中启用Dynamic Media 支持。 此功能允许当作者在本地Sites部署的网页中使用Dynamic Media个图像时,默认的图像组件显示Dynamic Media个图像。
使用远程资产 use-remote-assets
网站作者使用内容查找器连接到DAM部署。 作者可以浏览、搜索以及拖动组件中的远程资产。要验证远程DAM,请准备好管理员提供的凭据(如果有)。
作者可以在单个网页中使用本地DAM和远程DAM部署上可用的资产。 使用内容查找器,可在搜索本地 DAM 与搜索远程 DAM 之间切换。
仅获取那些具有完全对应的标记以及相同分类层次结构(在本地Sites部署中可用)的远程资产标记。 任何其他标记都将被丢弃。作者可以使用远程Experience Manager部署中存在的所有标记搜索远程资产,因为它提供全文搜索。
使用说明演示 walk-through-of-usage
使用上述设置尝试创作体验,以了解该功能是如何运作的。使用您在远程 DAM 部署中选择的文档或图像。
-
通过从Experience Manager工作区访问 Assets > 文件,导航到远程部署上的Assets界面。 或者,也可以在浏览器中访问
https://[assets_servername_ams]:[port]/assets.html/content/dam
。上传您选择的资产。 -
在Sites部署上,在右上角的配置文件激活器中单击 模拟为。 提供
ksaner
作为用户名,选择提供的选项,然后单击 确定。 -
打开 We.Retail 网页:Sites > We.Retail > us > en。编辑页面。或者,也可以在浏览器中访问
https://[aem_server]:[port]/editor.html/content/we-retail/us/en/men.html
以编辑页面。单击页面左上角的 切换侧面板。
-
打开Assets选项卡(远程内容查找器),然后单击 登录到连接的Assets。
-
提供凭据 –
ksaner
作为用户名,password
作为密码。此用户对Experience Manager部署都具有创作权限。 -
搜索您添加到 DAM 的资产。远程资产会显示在左侧面板中。筛选图像或文档,并进一步筛选支持的文档类型。拖动
Image
组件上的图像和Download
组件上的文档。获取的资产在本地Sites部署上是只读的。 您仍然可以使用Sites组件提供的选项来编辑获取的资产。 通过组件进行的编辑是无损的。
图:在远程DAM上搜索资产时,筛选文档类型和图像的选项。
-
如果异步获取资产的原始资产且获取任务失败,会通知站点作者。 在创作过程中甚至是创作后,作者可以在异步作业用户界面中查看有关获取任务和错误的详细信息。
图:关于在后台进行的异步获取资产的通知。
-
发布页面时,Experience Manager显示页面上使用的资产的完整列表。 请确保在发布时成功获取了远程资产。要检查每个获取的资产的状态,请参阅异步作业用户界面。
note note NOTE 即使未完全获取一个或多个远程资产,页面也会发布。 Experience Manager通知区域显示异步作业页面中显示的错误通知。
connectedassets
)。 此外,还可通过内容查找器,搜索和查看本地存储库中的资产。获取的资产可用作任何其他本地资产,但关联的元数据无法编辑。
检查跨网页的资源使用 asset-usage-references
Experience Manager允许DAM用户检查对资产的所有引用。 它有助于了解和管理远程Sites和复合资产中的资产使用情况。 部署Experience Manager Sites的网页的许多作者可以在不同网页中使用远程Assets上的资产。 要简化资产管理且不会导致引用损坏,DAM用户务必要检查本地和远程网页上资源的使用情况。 资产的属性页面中的引用选项卡列出了资产的本地和远程引用。
要查看和管理Assets部署中的引用,请执行以下步骤:
-
在Assets控制台中选择资源,然后单击工具栏中的 属性。
-
单击 引用 选项卡。 查看 本地引用 以在Assets部署中使用资产。 请参阅**远程引用,以在Sites部署上使用资产,其中资产是使用连接的Assets功能获取的。
资产属性页面中的
-
Sites页的引用显示每个本地Sites的引用总数。 查找所有引用并显示引用总数可能需要一些时间。
-
引用列表是交互式的,DAM用户可以单击引用以打开引用页面。 如果由于某个原因无法获取远程引用,则会显示通知以告知用户该故障。
-
用户可以移动或删除资源。 移动或删除资源时,所有选定资源/文件夹的引用总数都会显示在警告对话框中。 删除尚未检索其引用的资产时,会显示警告对话框。
管理远程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
限制和最佳实践 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浏览器中出现
-
如果您无法从Managed Servicesas a Cloud Service站点Adobe访问Experience Manager Sites远程DAM部署,请更新位于
"/etc/httpd/conf.d/available_vhosts
的aem_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
标头添加到响应中。