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

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

资产微服务允许您处理 广泛的文件类型 可开箱即用地涵盖比以前版本 Experience Manager. 例如，现在可以提取PSD和PSB格式的缩略图，但之前需要的第三方解决方案，例如 ImageMagick.

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

了解资产处理选项

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

支持的文件格式

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

默认配置

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

使用默认配置，只配置了最基本的处理配置文件。 此类处理配置文件在用户界面上不可见，您无法对其进行修改。 系统始终会执行以处理上传的资产。 此类默认处理配置文件可确保 Experience Manager 已完成。

标准配置

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

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

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

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

处理配置文件可以包含FPO（仅用于放置）演绎版。 请参阅 Adobe Asset Link 文档 以了解是否需要为处理用户档案打开该设置。 有关更多信息，请参阅 Adobe资产链接完整文档.

创建标准用户档案

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

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

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

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

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

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

   

5. 单击​保存。

自定义用户档案和用例

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

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

开发人员可以使用 Asset Compute Service to 创建自定义应用程序 的用例。 Experience Manager 可以使用管理员配置的自定义配置文件从用户界面调用这些自定义应用程序。 Asset Compute Service 支持以下调用外部服务的用例：

• 使用 Adobe Photoshop's ImageCutout API 并将结果另存为演绎版。
• 调用第三方系统以更新数据，例如PIM系统。
• 使用 Photoshop 用于根据Photoshop模板生成各种演绎版的API。
• 使用 Adobe Lightroom API 以优化摄取的资产，并将这些资产另存为演绎版。

创建自定义用户档案

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

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

2. 单击 自定义 选项卡。 单击 新增. 提供所需的演绎版文件名。

3. 提供以下信息。

   • 每个演绎版的文件名和支持的文件扩展名。
   • Firefly自定义应用程序的端点URL. 应用程序必须来自与Experience Manager帐户相同的组织。
   • 将服务参数添加到 将其他信息或参数传递到自定义应用程序.
   • 包含和排除的MIME类型，可将处理限制为几种特定的文件格式。

   单击​保存。

自定义应用程序是无头的 萤火虫项目 应用程序。 如果自定义应用程序使用处理配置文件进行设置，则会获取提供的所有文件。 应用程序必须筛选文件。

自定义用户档案的示例

为了说明自定义用户档案的用法，我们考虑使用一个用例将一些自定义文本应用到营销活动图像。 您可以创建利用Photoshop API编辑图像的处理配置文件。

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

图：使用 服务参数 字段，以将添加的信息传递到自定义应用程序中的预定义参数。 在此示例中，上传营销活动图像时，图像会更新为 Jumanji 文本 Arial-BoldMT 字体。

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

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

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

• 管理员可以在 工具 > 资产 > 处理配置文件，使用 将配置文件应用到文件夹 操作。 此时将打开一个内容浏览器，通过该浏览器可导航到特定文件夹，选择它们并确认配置文件的应用程序。

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

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

在将处理配置文件应用到文件夹后，系统会使用配置的附加处理配置文件处理该文件夹或其任何子文件夹中上传（或更新）的所有新资产。 这种处理是在标准默认配置文件之外进行的。

要确认已处理资产，请在 演绎版 视图。 打开资产预览并打开左边栏以访问 演绎版 中。 处理配置文件中的特定演绎版（其特定资产类型与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):可以根据不同的正则表达式列出多个工作流模型。 表达式和模型应使用冒号分隔。 正则表达式应直接指向“资产”节点，而不是任何演绎版或文件。 例如：/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。 上传超大型资产时，有时元数据提取操作会失败。