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

资产微型服务提供使用云本机应用程序(也称为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服务。 支持云本机和可扩展方法中更复杂的要求。 请参阅允许的用例

支持的文件格式

资产微型服务支持各种文件格式,用于处理、生成演绎版或提取元数据。 有关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 文档以了解您是否需要为处理用户档案打开它。 有关详细信息,请参阅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扩展默认功能。 有关概述,请参阅了解可扩展性以及何时使用它

注意

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模板生成各种再现。
  • 使用AdobeLightroomAPI优化所摄取的资产并将其另存为演绎版。
注意

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

创建自定义用户档案

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

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

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

  3. 提供以下信息。

    单击​保存

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

注意

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

自定义用户档案的示例

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

asset compute服务集成允许Experience Manager使用服务参数字段将这些参数传递到自定义应用程序。 然后,自定义应用程序调用PhotoshopAPI并将这些值传递给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知道资产处理何时完成。

配置后处理工作流执行

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

自定义工作流运行器服务(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服务的配置。 有关如何部署OSGi配置的信息,请参阅部署到Experience Manager
与Experience Manager的内部部署和托管服务部署不同,OSGi Web控制台在云服务部署中不直接可用。

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

最佳实践和限制

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

在此页面上