使用资产微服务和处理配置文件 get-started-using-asset-microservices

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

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

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

资产处理的高级视图

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

了解资源处理选项 get-started

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

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

支持的文件格式 supported-file-formats

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

默认配置 default-config

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

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

标准配置 standard-config

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完整文档.

创建标准配置文件 create-standard-profile

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

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

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

  3. 要生成FPO格式副本,请在 图像 选项卡,启用 创建FPO呈现版本. 输入 质量 1-100。

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

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

    processing-profiles-adding

  5. 单击​ 保存

自定义用户档案和用例 custom-config

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

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

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

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

  • 使用 Adobe Photoshop的 ImageCutout API 并将结果保存为演绎版。
  • 调用第三方系统以更新数据,例如PIM系统。
  • 使用 Photoshop 用于根据Photoshop模板生成各种呈现的API。
  • 使用 ADOBE LIGHTROOM API 以优化摄取的资产并将这些资产另存为演绎版。
NOTE
无法使用自定义应用程序编辑标准元数据。 您只能修改自定义元数据。

创建自定义配置文件 create-custom-profile

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

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

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

  3. 提供以下信息。

    单击​ 保存

自定义应用程序是Headless 项目应用程序生成器 应用程序。 如果您的自定义应用程序获取所有提供的文件(如果已使用处理配置文件进行设置)。 应用程序必须筛选文件。

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

自定义用户档案的示例 custom-profile-example

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

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

custom-processing-profile

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

使用处理配置文件处理资产 use-profiles

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

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

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

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

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

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

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

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

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

其他节目

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

后处理工作流 post-processing-workflows

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

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

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

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

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

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

创建后处理工作流模型 create-post-processing-workflow-models

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

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

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

配置后处理工作流执行 configure-post-processing-workflow-execution

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

将工作流模型应用到文件夹 apply-workflow-model-to-folder

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

  1. 创建工作流模型。

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

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

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

配置自定义工作流运行器服务 configure-custom-workflow-runner-service

您可以为高级配置配置配置自定义工作流运行器服务,这些配置无法通过将工作流应用到文件夹来轻松完成。 例如,使用正则表达式的工作流。 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. 提供新工作流模型的标题和名称,例如:

    • Title:禁用自动启动工作流
    • 名称:disable-auto-start-workflow
  4. 选择 完成 创建工作流模型

  5. 选择编辑 已创建的工作流模型

  6. 在工作流模型编辑器中,选择 步骤1 从模型定义中删除它

  7. 打开 侧面板,并选择 步骤

  8. 拖动 DAM更新资产工作流已完成 逐步执行模型定义

  9. 选择 页面信息 按钮(位于 侧面板 切换),并选择 打开属性

  10. 基本 选项卡,选择 瞬态工作流

  11. 选择 保存并关闭 从顶部操作栏

  12. 选择 同步 在顶部操作栏中

  13. 关闭工作流模型编辑器

应用禁用的自动启动工作流模型

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

最佳实践和限制 best-practices-limitations-tips

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

另请参阅

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