使用资产微服务和处理配置文件 get-started-using-asset-microservices
资产微服务使用云原生应用程序(也称为工作程序)提供可扩展和弹性的资产处理。 Adobe管理服务以优化处理各种资源类型和处理选项。
资产微服务允许您处理多种文件类型,这些类型涵盖的现成格式比以前版本的Experience Manager可能具有的格式更多。 例如,现在可以提取PSD和PSB格式的缩略图,但以前需要第三方解决方案,如ImageMagick。
资源处理依赖于 处理配置文件 中的配置。 Experience Manager提供了基本的默认设置,并允许管理员添加更具体的资源处理配置。 管理员创建、维护和修改后处理工作流的配置,包括可选自定义。 通过自定义工作流,开发人员可以扩展默认产品。
DAM Update Asset
工作流模型。 大多数标准演绎版生成和元数据相关步骤已由资产微服务处理替换,其余步骤(如果有)可由后处理工作流配置替换。了解资源处理选项 get-started
Experience Manager允许进行以下级别的处理。
- Assets用户界面使用的标准缩略图(48、140和319像素)
- 大型预览(Web呈现版本 — 1280像素)
- 元数据和文本提取。
- FPO演绎版。
- 更改图像的文件格式和分辨率
- 有条件地应用于配置的文件类型。
支持的文件格式 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
要创建标准处理配置文件,请执行以下步骤:
-
管理员可访问 工具 > Assets > 处理配置文件。 单击 创建。
-
提供一个名称,帮助您在应用到文件夹时唯一地标识配置文件。
-
要生成FPO呈现版本,请在 图像 选项卡上启用 创建FPO呈现版本。 输入1-100之间的 质量 值。
-
要生成其他演绎版,请单击 新增 并提供以下信息:
- 每个演绎版的文件名。
- 每个演绎版的文件格式(PNG、JPEG、GIF或WebP)。
- 每个演绎版的宽度和高度(以像素为单位)。 如果未指定这些值,则使用原始图像的完整像素大小。
- 每个JPEG和WebP演绎版的质量(百分比)。
- 包含和排除MIME类型以定义用户档案的适用性。
-
单击 保存。
自定义用户档案和用例 custom-config
Asset Compute Service支持各种用例,如默认处理、处理特定于Adobe的格式(如Photoshop文件)以及实施自定义或特定于组织的处理。 过去需要自定义DAM更新资产工作流,这些工作流或者自动处理,或者通过处理用户档案配置的方式进行处理。 如果这些处理选项无法满足业务需求,Adobe建议开发和使用Asset Compute Service来扩展默认功能。 有关概述,请参阅了解可扩展性和何时使用它。
它可以将图像、视频、文档和其他文件格式转换为不同的呈现形式,包括缩略图、提取的文本和元数据以及存档。
开发人员可以使用Asset Compute Service到为支持的用例创建自定义应用程序。 Experience Manager可以使用管理员配置的自定义配置文件从用户界面调用这些自定义应用程序。 Asset Compute Service支持以下调用外部服务的用例:
- 使用Adobe Photoshop的ImageCutout API并将结果保存为演绎版。
- 调用第三方系统以更新数据,例如PIM系统。
- 使用Photoshop API根据Photoshop模板生成各种演绎版。
- 使用Adobe Lightroom API优化摄取的资源并将它们另存为演绎版。
创建自定义配置文件 create-custom-profile
要创建自定义配置文件,请执行以下步骤:
-
管理员可访问 工具 > Assets > 处理配置文件。 单击 创建。
-
单击 自定义 选项卡。 单击 新增。 提供所需的格式副本文件名。
-
提供以下信息。
- 每个演绎版的文件名和支持的文件扩展名。
- App Builder自定义应用的端点URL。 应用程序必须来自Experience Manager帐户所在的相同组织。
- 将服务参数添加到可将额外信息或参数传递给自定义应用程序。
- 包含和排除的MIME类型可将处理限制为几种特定的文件格式。
单击 保存。
自定义应用程序是Headless Project App Builder应用程序。 如果您的自定义应用程序获取所有提供的文件(如果已使用处理配置文件进行设置)。 应用程序必须筛选文件。
自定义用户档案的示例 custom-profile-example
为了说明自定义用户档案的使用情况,我们考虑一个用例,将一些自定义文本应用到Campaign图像。 您可以创建使用Photoshop API编辑图像的处理配置文件。
asset compute服务集成允许Experience Manager使用服务参数字段将这些参数传递到自定义应用程序。 然后,自定义应用程序调用Photoshop API并将这些值传递到API。 例如,您可以传递字体名称、文本颜色、文本粗细和文本大小,以将自定义文本添加到促销活动图像。
图:使用服务参数字段将添加的信息传递到自定义应用程序中的预定义参数。 在此示例中,在上传促销活动图像时,将使用Arial-BoldMT
字体中的Jumanji
文本更新图像。
使用处理配置文件处理资产 use-profiles
创建其他自定义处理配置文件并将其应用到特定文件夹,以便Experience Manager处理在这些文件夹中上传或更新来的资源。 默认的内置标准处理配置文件始终执行,但在用户界面中不可见。 如果您添加自定义配置文件,则两个配置文件都会用于处理上传的资产。
使用以下方法之一将处理配置文件应用到文件夹:
-
管理员可以在 工具 > Assets > 处理配置文件 中选择处理配置文件定义,并使用 将配置文件应用到文件夹 操作。 它会打开一个内容浏览器,允许您导航到特定文件夹,选择它们并确认配置文件的应用程序。
-
用户可以在Assets用户界面中选择文件夹,使用 属性 操作打开文件夹属性屏幕,单击 资产处理 选项卡,然后在处理配置文件列表中,为该文件夹选择适当的处理配置文件。 要保存更改,请单击 “保存并关闭”。
-
用户可以在Assets用户界面中选择文件夹或特定资源以应用处理配置文件,然后从顶部可用的选项中选择 重新处理Assets 选项。
在处理配置文件应用于文件夹后,该文件夹或其任何子文件夹中上传(或更新)的所有新资产都将使用配置的其他处理配置文件进行处理。 这种处理是在标准默认配置文件之外进行的。
要验证是否已处理资源,请在左边栏的呈现版本视图中预览生成的呈现版本。 打开资源预览并打开左边栏以访问 呈现版本 视图。 处理配置文件中的特定演绎版(其特定资产的类型与MIME类型包含规则匹配)应当可见且可访问。
图:由应用于父文件夹的处理配置文件生成的两个其他呈现形式的示例。
后处理工作流 post-processing-workflows
对于需要使用处理配置文件无法实现的额外资产处理的情况,可以向配置添加额外的后处理工作流。 后处理允许您在使用资产微服务的可配置处理之上添加完全自定义的处理。
后期处理工作流,或自动启动工作流(如果已配置),在微服务处理完成后,由Experience Manager自动执行。 无需手动添加工作流启动器即可触发工作流。 示例包括:
- 用于处理资产的自定义工作流步骤。
- 集成以将元数据或属性从外部系统添加到资源,例如产品或流程信息。
- 由外部服务完成的附加处理。
要将后处理工作流配置添加到Experience Manager,请执行以下步骤:
- 创建一个或多个工作流模型。 这些自定义模型在本文档中称为 后处理工作流模型。 这些是常规的Experience Manager工作流模型。
- 将所需的工作流步骤添加到这些模型中。 查看默认工作流的步骤,并将所有必需的默认步骤添加到自定义工作流中。 这些步骤基于工作流模型配置在资产上运行。 例如,如果您希望在上传资产时自动进行智能标记,请将步骤添加到自定义后处理工作流模型中。
- 添加DAM更新资产工作流在末尾已完成进程步骤。 添加此步骤可确保Experience Manager知道处理何时结束,并且可以将该资源标记为已处理,即 New 显示在资源上。
- 为自定义工作流运行器服务创建配置,以允许通过路径(文件夹位置)或正则表达式配置后处理工作流模型的执行。
有关可在后处理工作流中使用的标准工作流步骤的详细信息,请参阅developer reference中的后处理工作流中的工作流步骤。
创建后处理工作流模型 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
对于典型的后处理用例,考虑使用方法将工作流应用到文件夹。 要在文件夹属性中应用工作流模型,请执行以下步骤:
-
创建工作流模型。
-
选择一个文件夹,单击工具栏中的 属性,然后单击 Assets处理 选项卡。
-
在 自动启动工作流 下,选择所需的工作流,提供工作流的标题,然后保存更改。
配置自定义工作流运行器服务 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。
禁用后处理工作流执行
当不需要后期处理时,在 自动启动工作流 选择中创建并使用“空”工作流模型。
创建禁用的自动启动工作流模型
-
导航到 工具>工作流>模型
-
从顶部操作栏中选择 创建>创建模型
-
提供新工作流模型的标题和名称,例如:
- Title:禁用自动启动工作流
- 名称:disable-auto-start-workflow
-
选择 完成 以创建工作流模型
-
选择 和 编辑 已创建的工作流模型
-
在工作流模型编辑器中,从模型定义中选择 步骤1 并将其删除
-
打开 侧面板,然后选择 步骤
-
将 DAM更新资产工作流已完成 步骤拖动到模型定义中
-
选择 页面信息 按钮(在 侧面板 切换旁边),然后选择 打开属性
-
在 基本 选项卡下,选择 临时工作流
-
从顶部操作栏中选择 保存并关闭
-
在顶部操作栏中选择 同步
-
关闭工作流模型编辑器
应用禁用的自动启动工作流模型
按照中概述的步骤将工作流模型应用到文件夹,并将 禁用自动启动工作流 设置为 文件夹的自动启动工作流 不需要对资产进行后处理。
最佳实践和限制 best-practices-limitations-tips
- 在设计工作流时,请考虑您对所有类型的演绎版的需求。 如果您预计将来不需要节目,请从工作流中删除其创建步骤。 之后无法批量删除节目。 长时间使用Experience Manager后,不需要的演绎版可能会占用大量存储空间。 对于单个资源,您可以从用户界面手动删除演绎版。 对于多个资源,您可以自定义Experience Manager以删除特定演绎版,或删除这些资源并重新上传。
- 目前,支持仅限于生成演绎版。 不支持生成新资产。
- 目前,元数据提取的文件大小限制约为15 GB。 上传非常大的资源时,有时元数据提取操作失败。
另请参阅