使用资产微服务和处理用户档案

Asset Microservices使用云本机应用程序(也称为Worker)为资产提供可扩展且具有弹性的处理。 Adobe管理服务,以优化不同资产类型和处理选项。

Asset microservices允许您处理范围广泛的文件类型,这些文件类型比早期版本的Experience Manager可能处理的格式更多。 例如,PSD和PSB格式的缩览图提取现在可能是之前需要的第三方解决方案,如ImageMagick。

资产处理取决于​处理用户档案​中的配置。 Experience Manager提供了基本的默认设置,并允许管理员添加更具体的资产处理配置。 管理员创建、维护和修改后处理工作流的配置,包括可选自定义。 自定义工作流允许开发人员扩展默认产品。

资产处理的高级视图资

注意

此处介绍的资产处理将替换Experience Manager早期版本中存在的DAM Update Asset工作流模型。 大多数标准再现生成和与元数据相关的步骤会被资产microservices处理所取代,其余步骤(如果有)可以被后处理工作流配置替换。

了解资产处理选项

Experience Manager允许以下处理级别。

选项 描述 涵盖的使用案例
默认配置 它按原样可用,无法修改。 此配置提供了非常基本的再现生成功能。
  • Assets用户界面使用的标准缩览图(48、140和319像素)
  • 大预览(Web再现 — 1280像素)
  • 元数据和文本提取。
自定义配置 由管理员通过用户界面进行配置。 通过扩展默认选项,为生成再现提供更多选项。 扩展开箱即用选项,以提供不同的格式和再现。
  • FPO再现。
  • 更改图像的文件格式和分辨率
  • 有条件地应用于已配置的文件类型。
自定义用户档案 由管理员通过用户界面配置,以通过自定义应用程序使用自定义代码来调用Asset compute服务。 支持云本机和可扩展方法中更复杂的要求。 请参见允许的用例

支持的文件格式

Asset microservices支持各种文件格式以处理、生成演绎版或提取元数据。 有关MIME类型的完整列表以及每种类型支持的功能,请参阅支持的文件格式

默认配置

已预配置一些默认设置,以确保Experience Manager中所需的默认演绎版可用。 默认配置还确保可以执行元数据提取和文本提取操作。 用户可以立即开始上传或更新资产,并且默认情况下基本处理可用。

使用默认配置,只配置最基本的处理用户档案。 此类处理用户档案在用户界面上不可见,您无法修改它。 它始终执行以处理上传的资产。 此默认处理用户档案可确保Experience Manager所需的基本处理在所有资产上完成。

标准配置

Experience Manager 根据用户的需要,提供生成更多特定格式演绎版的功能。管理员可以创建额外的处理用户档案以便创建此类再现。 然后,用户将一个或多个可用用户档案分配给特定文件夹,以完成附加处理。 例如,附加处理可以为Web、移动设备和平板电脑生成再现。 以下视频说明了如何创建和应用处理用户档案以及如何访问创建的演绎版。

  • 演绎版宽度和高度:演绎版宽度和高度规范提供了生成的输出图像的最大大小。Asset microservices会尝试生成最大的可能再现,其宽度和高度分别不大于指定的宽度和高度。 将保留宽高比,即与原始宽高比相同。 空值表示资产处理采用原始图像的像素尺寸。

  • MIME类型包含规则:当处理具有特定MIME类型的资产时,首先会根据演绎版规范的排除的MIME类型值检查MIME类型。如果与该列表匹配,则不会为资产(阻止列表)生成此特定演绎版。 否则,将根据包含的MIME类型检查MIME类型,如果该类型与列表匹配,则会生成演绎版(允许列表)。

  • 特殊FPO再现:将大型资产从放入 Experience Manager 文档 Adobe InDesign 时,创意专业人士会在放置资产后等 待相当长时间。同时,用户被阻止使用InDesign。 这会中断创作流程,并对用户体验造成负面影响。 Adobe允许将小型演绎版临时置入InDesign文档,以开始,稍后可以用全分辨率资产按需替换。 Experience Manager 提供仅用于放置(FPO)的再现。这些FPO再现的文件大小较小,但长宽比相同。

处理用户档案可以包括FPO(仅用于放置)再现。 请参阅Adobe Asset Link 文档以了解您是否需要为处理用户档案打开它。 有关详细信息,请参阅Adobe资产链接完整文档

创建标准用户档案

要创建标准处理用户档案,请执行以下步骤:

  1. 管理员访问​工具 > 资产 > 处理用户档案。 单击​创建

  2. 提供一个名称,帮助您在应用到文件夹时唯一标识用户档案。

  3. 要生成FPO演绎版,请在​标准​选项卡上,启用​创建FPO演绎版。 输入介于1和100之间的​Quality​值。

  4. 要生成其他演绎版,请单击​添加新​并提供以下信息:

    • 每个再现的文件名。
    • 每个再现的文件格式(PNG、JPEG、GIF或WebP)。
    • 每个演绎版的宽度和高度(以像素为单位)。 如果未指定值,则使用原始图像的全像素大小。
    • 每个JPEG和WebP再现的质量百分比。
    • 包含和排除的MIME类型可定义用户档案的适用性。

    处理用户档案 — 添加

  5. 单击​保存

自定义用户档案和用例

Asset Compute Service支持各种用例,如默认处理、处理特定于Adobe的格式(如Photoshop文件)以及实现自定义或组织特定处理。 过去需要的DAM更新资产工作流自定义可以自动处理,也可以通过处理用户档案配置。 如果这些处理选项不能满足业务需求,Adobe建议开发并使用Asset Compute Service扩展默认功能。 有关概述,请参阅了解可扩展性以及何时使用它

注意

Adobe建议仅在无法使用默认配置或标准用户档案完成业务需求时使用自定义应用程序。

它可以将图像、视频、文档和其他文件格式转换为不同的再现,包括缩略图、提取的文本和元数据以及存档。

开发人员可以使用Asset Compute Service为支持的用例创建自定义应用程序](/docs/asset-compute/using/extend/develop-custom-application.html?lang=zh-Hans)。 [Experience Manager 可以使用管理员配置的自定义用户档案从用户界面调用这些自定义应用程序。Asset Compute Service 支持以下调用外部服务的用例:

  • 使用Adobe Photoshop的ImageCutout API将结果保存为再现。
  • 呼叫第三方系统以更新数据,例如PIM系统。
  • 使用Photoshop API根据Photoshop模板生成各种再现。
  • 使用AdobeLightroom API优化所摄取的资产并将这些资产另存为演绎版。
注意

无法使用自定义应用程序编辑标准元数据。 您只能修改自定义元数据。

创建自定义用户档案

要创建自定义用户档案,请执行以下步骤:

  1. 管理员访问​工具 > 资产 > 处理用户档案。 单击​创建

  2. 单击​自定义​选项卡。 单击​添加新。 提供再现所需的文件名。

  3. 提供以下信息。

    单击​保存

自定义应用程序是无标题Project Firefly应用程序。 如果自定义应用程序是使用处理用户档案设置的,则它们将获取所有提供的文件。 应用程序必须过滤文件。

注意

如果Firefly应用程序和Experience Manager帐户不来自同一组织,则集成不起作用。

自定义用户档案的示例

为了说明自定义用户档案的用法,让我们考虑将一些自定义文本应用于活动图像的用例。 您可以创建一个处理用户档案,它利用Photoshop API编辑图像。

asset compute服务集成允许Experience Manager使用服务参数字段将这些参数传递给自定义应用程序。 然后,自定义应用程序调用Photoshop API并将这些值传递给API。 例如,您可以传递字体名称、文本颜色、文本权重和文本大小,以将自定义文本添加到活动图像。

自定义处理用户档案

图:使用 Service Parametersfield 将添加的信息传递到自定义应用程序中的预定义参数。在此示例中,上传活动图像时,将使用Arial-BoldMT字体中的Jumanji文本更新图像。

使用处理用户档案处理资产

创建附加的自定义处理用户档案并将其应用到特定文件夹,以便Experience Manager处理上传到这些文件夹或在这些文件夹中更新的资产。 默认的内置标准处理用户档案始终会执行,但在用户界面上不可见。 如果您添加了自定义用户档案,则两个用户档案都用于处理上传的资产。

使用以下方法之一将处理用户档案应用到文件夹:

  • 管理员可以在​工具 > 资产 > 处理用户档案​中选择处理用户档案定义,然后使用​将用户档案应用到文件夹​操作。 它会打开一个内容浏览器,允许您导航到特定文件夹,选择这些文件夹并确认用户档案的应用程序。
  • 用户可以在“资产”用户界面中选择文件夹,使用​属性​操作打开文件夹属性屏幕,单击​处理用户档案​选项卡,然后在弹出列表中选择相应的该文件夹处理用户档案。 要保存更改,请单击​保存并关闭
    从资产属性选项卡将处理用户档案应用到文件夹
小贴士

只能将一个处理用户档案应用于文件夹。 要生成更多演绎版,请向现有处理用户档案添加更多演绎版定义。

在将处理用户档案应用到文件夹后,此文件夹或其任何子文件夹中上传(或更新)的所有新资产都会使用配置的附加处理用户档案进行处理。 此处理是在标准默认用户档案之外添加的。

注意

应用于文件夹的处理用户档案适用于整个树,但可能与应用于子文件夹的其他用户档案重叠。 当资产上传到文件夹时,Experience Manager会检查包含文件夹的属性以获取处理用户档案。 如果未应用任何文件夹,则会检查层次结构中的父文件夹以查找要应用的处理用户档案。

要验证是否已处理资产,请在左边栏的演绎版视图中预览生成的演绎版。 打开资产预览并打开左边栏以访问​演绎版​视图。 处理用户档案中的特定演绎版(其特定资产的类型与MIME类型包含规则匹配)应可见且可访问。

其他演绎版

图:由应用到父文件夹的处理用户档案生成的两个其他演绎版的示例。

后处理工作流

在需要额外处理资产而无法使用处理用户档案的情况下,可以向配置中添加额外的后处理工作流。 这允许在使用资产微服务的可配置处理之上添加完全自定义的处理。

后处理工作流(如果已配置)由Experience Manager在微服务处理完成后自动执行。 无需手动添加工作流启动器以触发工作流。 示例包括:

  • 处理资产的自定义工作流步骤。
  • 通过集成将元数据或属性从外部系统添加到资产,例如产品或流程信息。
  • 外部服务完成的附加处理。

要向Experience Manager添加后处理工作流配置,请执行以下步骤:

  • 创建一个或多个工作流模型。 这些自定义模型在本文档中称为​后处理工作流模型。 它们是常规的Experience Manager工作流模型。
  • 将所需的工作流步骤添加到这些模型。 查看默认工作流中的步骤,并将所有所需的默认步骤添加到自定义工作流。 这些步骤将根据工作流模型配置对资产执行。 例如,如果您希望在资产上传时自动添加智能标签,请将该步骤添加到您的自定义后期处理工作流模型中。
  • 最后添加DAM更新资产工作流已完成进程步骤。 添加此步骤可确保Experience Manager知道处理何时结束,并且资产可以标记为已处理,即​资产上会显示新
  • 为自定义工作流运行服务创建配置,允许通过路径(文件夹位置)或常规表达式配置后处理工作流模型的执行。

创建后处理工作流模型

后处理工作流模型是常规的Experience Manager工作流模型。 如果您需要针对不同存储库位置或资产类型进行不同的处理,请创建不同的模型。

应根据需要添加处理步骤。 您可以使用任何支持的步骤以及任何自定义实现的工作流步骤。

确保每个后处理工作流的最后一步是DAM Update Asset Workflow Completed Process。 最后一步有助于确保Experience Manager知道资产处理何时完成。

配置后处理工作流执行

要配置在资产微型服务处理完成后,为系统中上传或更新的资产执行的后处理工作流模型,需要配置自定义工作流运行服务。

Adobe CQ DAM自定义工作流运行程序(com.adobe.cq.dam.processor.nui.impl.workflow.CustomDamWorkflowRunnerImpl)是OSGi服务,并提供两个配置选项:

  • 按路径(postProcWorkflowsByPath)进行后处理工作流:可以根据不同的存储库路径列出多个工作流模型。 路径和模型应用冒号分隔。 支持简单的存储库路径,并应映射到/var路径中的工作流模型。 例如:/content/dam/my-brand:/var/workflow/models/my-workflow
  • 按表达式(postProcWorkflowsByExpression)进行后处理工作流:可以根据不同的常规表达式列出多个工作流模型。 表达式和模型应用冒号分隔。 常规表达式应直接指向“资产”节点,而不是指向某个演绎版或文件。 例如:/content/dam(/.*/?lang=zh-Hans)(marketing/seasonal)(/.*?lang=zh-Hans):/var/workflow/models/my-workflow
注意

自定义工作流运行程序的配置是OSGi服务的配置。 有关如何部署OSGi配置的信息,请参阅部署到Experience Manager
与Experience Manager的内部部署和托管服务部署不同,OSGi Web控制台在云服务部署中不直接可用。

有关在后处理工作流中可以使用哪个标准工作流步骤的详细信息,请参阅开发人员参考中的后处理工作流](developer-reference-material-apis.md#post-processing-workflows-steps)中的[工作流步骤。

最佳实践和限制

  • 在设计工作流时,请考虑您对所有类型再现的需求。 如果您预计不会在将来需要再现,请从工作流中删除其创建步骤。 之后无法批量删除演绎版。 在延长使用Experience Manager后,不希望的再现可能会占用大量存储空间。 对于单个资产,您可以从用户界面中手动删除演绎版。 对于多个资产,您可以自定义Experience Manager以删除特定演绎版,或删除资产并再次上传这些资产。
  • 目前,支持仅限于生成再现。 不支持生成新资产。
  • 目前,元数据提取的文件大小限制约为10 GB。 上传超大型资产时,有时元数据提取操作会失败。

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now