使用资产微服务和处理配置文件

资产微服务使用云原生应用程序(也称为工作程序)提供可扩展和可复原的资产处理。 Adobe管理服务以优化处理各种资源类型和处理选项。

通过资产微服务,您可以处理 多种文件类型 比早期版本可用的格式有更多现成可用 Experience Manager. 例如,现在可以提取PSD和PSB格式的缩略图,但以前需要第三方解决方案,例如 ImageMagick.

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

资源处理的高级视图
注意

此处描述的资产处理将取代 DAM Update Asset 早期版本中存在的工作流模型 Experience Manager. 大多数标准演绎版生成和元数据相关步骤已由资产微服务处理替换,其余步骤(如果有)可由后处理工作流配置替换。

了解资源处理选项

Experience Manager 允许进行以下级别的处理。

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

支持的文件格式

资产微服务为处理、生成演绎版或提取元数据的各种文件格式提供支持。 参见 支持的文件格式 获取MIME类型的完整列表以及每种类型支持的功能。

默认配置

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

使用默认配置时,仅配置最基本的处理配置文件。 此类处理配置文件在用户界面中不可见,您无法对其进行修改。 它始终执行以处理上传的资产。 此类默认处理配置文件可确保进行以下操作所需的基本处理 Experience Manager 在所有资源上完成。

标准配置

Experience Manager 提供根据用户需求为常见格式生成更具体演绎版的功能。 管理员可以创建其他 处理配置文件 以方便此类演绎版创建。 然后,用户将一个或多个可用配置文件分配给特定文件夹,以完成其他处理。 例如,附加处理可以为Web、移动设备和平板电脑生成演绎版。 以下视频演示了如何创建和应用 处理配置文件 以及如何访问创建的演绎版。

  • 演绎版宽度和高度:演绎版宽度和高度规范提供所生成输出图像的最大大小。 资源微服务会尝试生成可能的最大演绎版,其宽度和高度分别不大于指定的宽度和高度。 纵横比保持不变,即与原始纵横比相同。 空值意味着资产处理会假定原始资产的像素尺寸。

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

  • 特殊FPO演绎版:从以下位置放置大型资产时 Experience Manager 到 Adobe InDesign 文件,一个富有创造力的专业人士会等待很长一段时间 放置资产. 同时,用户被阻止使用 InDesign. 这会中断创作流并对用户体验产生负面影响。 Adobe功能允许临时将小型演绎版放入 InDesign 文档开始,稍后可根据需要使用全分辨率资产替换。 Experience Manager 提供仅用于置入(FPO)的演绎版。 这些FPO呈现版本的文件大小较小,但具有相同的纵横比。

处理配置文件可以包含FPO(仅用于放置)演绎版。 参见 Adobe Asset Link 文档 以了解是否需要为处理配置文件启用它。 有关更多信息,请参阅 AdobeAsset Link完整文档.

创建标准配置文件

要创建标准处理配置文件,请执行以下步骤:

  1. 管理员访问权限 工具 > 资产 > 处理配置文件. 单击​创建

  2. 提供一个名称,帮助您在应用到文件夹时唯一地标识该配置文件。

  3. 要生成FPO演绎版,请在 图像 选项卡,启用 创建FPO演绎版. 输入 质量 值介于1和100之间。

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

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

    processing-profiles-adding

  5. 单击“保存”。

自定义用户档案和用例

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

注意

Adobe建议仅在无法使用默认配置或标准配置文件满足业务需求时才使用自定义应用程序。

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

开发人员可以使用 Asset Compute Service 到 创建自定义应用程序 ,以了解支持的用例。 Experience Manager 可以使用管理员配置的自定义用户档案,从用户界面中调用这些自定义应用程序。 Asset Compute Service 支持调用外部服务的以下用例:

  • 使用 Adobe Photoshop的 ImageCutout API 并将结果保存为演绎版。
  • 调用第三方系统以更新数据,例如PIM系统。
  • 使用 Photoshop 用于根据Photoshop模板生成各种演绎版的API。
  • 使用 ADOBE LIGHTROOM API 以优化摄取的资产并将它们另存为演绎版。
注意

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

创建自定义用户档案

要创建自定义配置文件,请执行以下步骤:

  1. 管理员访问权限 工具 > 资产 > 处理配置文件. 单击​创建

  2. 单击 自定义 选项卡。 单击 新增. 提供所需的格式副本文件名。

  3. 提供以下信息。

    单击“保存”。

自定义应用程序是Headless Project App Builder 应用程序。 如果您的自定义应用程序使用处理配置文件设置所有提供的文件,则会获取这些文件。 应用程序必须筛选文件。

注意

如果App Builder应用程序和 Experience Manager 帐户不是来自同一组织,集成无法正常工作。

自定义用户档案示例

为了说明自定义配置文件的用法,让我们考虑一个用例,将一些自定义文本应用到Campaign图像。 您可以创建利用Photoshop API编辑图像的处理配置文件。

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

custom-processing-profile

图:使用 服务参数 用于将添加的信息传递到自定义应用程序中预定义的参数的字段。 在本例中,在上传促销活动图像时,图像将更新为 Jumanji 文本输入 Arial-BoldMT 字体。

使用处理配置文件处理资产

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

使用以下方法之一将处理配置文件应用到文件夹:

  • 管理员可以在中选择处理配置文件定义 工具 > 资产 > 处理配置文件,并使用 将配置文件应用到文件夹 操作。 它会打开一个内容浏览器,允许您导航到特定文件夹,选择它们并确认配置文件的应用程序。

  • 用户可以在Assets用户界面中选择文件夹,使用 属性 要打开文件夹属性屏幕,请单击 资产处理 选项卡,在 处理配置文件 列表中,为该文件夹选择适当的处理配置文件。 要保存更改,请单击​“保存并关闭”
    从资产属性选项卡将处理配置文件应用到文件夹

  • 用户可以在Assets用户界面中选择文件夹或特定资产以应用处理配置文件,然后选择 资产重新处理图标 重新处理资产 选项(从顶部可用的选项中)。

小贴士

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

在处理配置文件应用于文件夹后,该文件夹或其任何子文件夹中上传(或更新)的所有新资产都将使用配置的其他处理配置文件进行处理。 这种处理是在标准默认配置文件之外进行的。

注意

应用于文件夹的处理配置文件适用于整个树,但可以替换为应用于子文件夹的其他配置文件。 将资源上传到文件夹后,Experience Manager会检查包含文件夹的属性以查找处理配置文件。 如果未应用任何配置文件,则会检查层级中的父文件夹以确定要应用的处理配置文件。

要验证是否处理了资源,请在 演绎版 在左边栏中查看。 打开资源预览并打开左边栏以访问 演绎版 视图。 处理配置文件中的特定演绎版(其特定资产的类型与MIME类型包含规则匹配)应可见且可访问。

其他演绎版

图:由应用于父文件夹的处理配置文件生成的两个附加演绎版的示例。

后处理工作流

对于需要使用处理配置文件无法实现的额外资产处理的情况,可以向配置中添加其他后处理工作流。 后处理允许您在使用资产微服务的可配置处理之上添加完全自定义的处理。

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

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

将后处理工作流配置添加到 Experience Manager,请按照以下步骤操作:

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

有关可在后处理工作流中使用的标准工作流步骤的详细信息,请参阅 后处理工作流中的工作流步骤 在开发人员参考中。

创建后处理工作流模型

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

根据需要添加处理步骤。 您可以同时使用两个受支持的可用步骤以及任何自定义实施的工作流步骤。

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

配置后处理工作流执行

在资产微服务完成对已上传资产的处理之后,您可以定义后处理工作流以进一步处理资产。 要使用工作流模型配置后处理,您可以执行以下操作之一:

将工作流模型应用到文件夹

对于典型的后处理用例,请考虑使用方法将工作流应用到文件夹。 在文件夹中应用工作流模型 属性,请按照以下步骤操作:

  1. 创建工作流模型。

  2. 选择一个文件夹,然后单击 属性 工具栏中,然后单击 资产处理 选项卡。

  3. 自动启动工作流,选择所需的工作流,提供工作流的标题,然后保存更改。

    将后处理工作流应用于文件夹属性中的文件夹

配置自定义工作流运行器服务

您可以为高级配置配置配置自定义工作流运行器服务,这些配置无法通过将工作流应用于文件夹来轻松完成。 例如,使用正则表达式的工作流。 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):可以根据不同的正则表达式列出多个工作流模型。 表达式和模型应以冒号分隔。 正则表达式应直接指向Asset节点,而不是演绎版或文件之一。 例如:/content/dam(/.*/)(marketing/seasonal)(/.*):/var/workflow/models/my-workflow

要了解如何部署OSGi配置,请参阅 部署到 Experience Manager.

禁用后处理工作流执行

如果不需要后期处理,请在中创建并使用“空”工作流模型 自动启动工作流 选择。

创建禁用的自动启动工作流模型
  1. 导航到 “工具”>“工作流”>“模型”
  2. 选择 “创建”>“创建模型” 形成顶部操作栏
  3. 提供新工作流模型的标题和名称,例如:
    • 标题:禁用自动启动工作流
    • 名称:disable-auto-start-workflow
  4. 选择 完成 创建工作流模型
  5. 选择编辑 新创建的工作流模型
  6. 在工作流模型编辑器中,选择 步骤1 从模型定义中删除它
  7. 打开 侧面板,并选择 步骤
  8. 拖动 DAM更新资产工作流已完成 逐步定义模型
  9. 选择 页面信息 按钮(位于 侧面板 切换),并选择 打开属性
  10. 基本 选项卡,选择 瞬态工作流
  11. 选择 保存并关闭 从顶部操作栏中
  12. 选择 同步 在顶部操作栏中
  13. 关闭工作流模型编辑器
应用禁用的自动启动工作流模型

按照中概述的步骤操作 将工作流模型应用到文件夹 并设置 禁用自动启动工作流 作为 自动启动工作流 (对于文件夹)不需要对资源进行后处理。

最佳实践和限制

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

另请参阅

在此页面上