与AEM处理用户档案集成

要让Asset compute工作进程在AEM as a Cloud Service中生成自定义演绎版,必须通过处理用户档案在AEM as a Cloud Service创作服务中注册这些演绎版。 受该处理配置文件约束的所有资产将在上传或重新处理时调用工作进程,并生成自定义演绎版,然后通过资产的演绎版提供该演绎版。

定义处理配置文件

首先创建新的处理配置文件,该配置文件将使用可配置的参数调用工作进程。

正在处理配置文件

  1. 以​ AEM管理员 ​身份登录AEM as a Cloud Service创作服务。 由于这是一个教程,我们建议在沙盒中使用开发环境或环境。

  2. 导航到​ 工具> Assets >处理配置文件

  3. 点按​ 创建 ​按钮

  4. 命名处理配置文件,WKND Asset Renditions

  5. 点按​ 自定义 ​选项卡,然后点按​ 新增

  6. 定义新服务

    • 演绎版名称: Circle

      • 用于在AEM Assets中标识此演绎版的文件名
    • 扩展名:png

      • 生成的演绎版的扩展。 设置为png,因为这是辅助进程的Web服务支持的输出格式,并且会在圆切出后产生透明背景。
    • 终结点: https://...adobeioruntime.net/api/v1/web/wkndAemAssetCompute-0.0.1/worker

      • 这是通过aio app get-url获取的辅助进程的URL。 根据AEM as a Cloud Service环境,确保URL指向正确的工作区。
      • 确保Worker URL指向正确的工作区。 AEM as a Cloud Service Stage应使用Stage Workspace URL,而AEM as a Cloud Service Production应使用Production Workspace URL。
    • 服务参数

      • 点按​ 添加参数

        • 键: size
        • 值: 1000
      • 点按​ 添加参数

        • 键: contrast
        • 值: 0.25
      • 点按​ 添加参数

        • 键: brightness
        • 值: 0.10
      • 这些键/值对将传递到Asset compute工作进程,并可通过rendition.instructions JavaScript对象使用。

    • Mime类型

      • 包括: image/jpegimage/pngimage/gifimage/bmpimage/tiff
        • 这些MIME类型是工作人员的npm模块中仅有的类型。 此列表限制由自定义工作进程处理的工作。
      • 排除: Leave blank
        • 切勿使用此服务配置处理具有这些MIME类型的资产。 在这种情况下,我们仅使用允许列表。
  7. 点按右上方的​ 保存

应用和调用处理配置文件

  1. 选择新创建的处理配置文件,WKND Asset Renditions

  2. 点按顶部操作栏中的​ 将配置文件应用到文件夹

  3. 选择要将处理配置文件应用到的文件夹,如WKND,然后点按​ 应用

  4. 通过​ AEM > Assets > Files ​导航到未应用处理配置文件的文件夹,然后点按WKND

  5. 在应用了处理配置文件的文件夹下的任意文件夹中上传一些新图像资产(sample-1.jpgsample-2.jpgsample-3.jpg),并等待处理上传的资产。

  6. 点按资产以打开其详细信息

    • 在AEM中,默认演绎版的生成和显示速度可能比自定义演绎版更快。
  7. 从左侧边栏打开​ 呈现版本 ​视图

  8. 点按名为Circle.png的资源并查看生成的演绎版

    生成的演绎版

已完成!

恭喜!您已完成有关如何扩展AEM as a Cloud ServiceAsset compute微服务的教程! 您现在应该能够设置、开发、测试、调试和部署自定义Asset compute工作程序,以供AEM as a Cloud Service Author服务使用。

在Github上查看完整项目源代码

Github上提供了最终Asset compute项目,网址为:

Github包含项目的最终状态,已使用辅助进程和测试用例完全填充,但不包含任何凭据,即 .env.config.json.aio.

疑难解答

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69