开发Asset compute元数据工作程序

上次更新: 2023-12-04
  • 创建对象:
  • Intermediate
    Experienced
    Developer

自定义Asset compute工作进程可以生成发送回AEM并作为元数据存储在资源上的XMP (XML)数据。

常见用例包括:

  • 与第三方系统(如PIM (产品信息管理系统))的集成,在这些第三方系统中,必须检索其他元数据并将其存储在资产上
  • 与Adobe服务(例如Content and Commerce AI)集成,通过其他机器学习属性来增强资产元数据
  • 从资源的二进制文件中获取有关该资源的元数据,并将其作为资源元数据存储在AEMas a Cloud Service中

您将要做什么

在本教程中,我们将创建一个Asset compute元数据工作器,该工作器可派生图像资源中最常用的颜色,并将这些颜色的名称写回到AEM中的资源元数据。 虽然工作进程本身是基础的,但本教程将使用该工作进程来探索如何使用Asset compute工作进程将as a Cloud Service的元数据写回到AEM中的资源。

asset compute元数据工作进程调用的逻辑流

对Asset compute元数据工作程序的调用与的调用几乎相同 二进制演绎版生成工作程序,主要区别在于返回类型是XMP (XML)演绎版,其值也会写入资源的元数据。

asset compute工作程序在实施Asset computeSDK工作程序API合同时,位于 renditionCallback(...) 函数,其概念为:

  • 输入: AEM资产的原始二进制文件和处理配置文件参数
  • 输出: XMP (XML)演绎版作为演绎版保留在AEM资源中,并保留在资源的元数据中

asset compute元数据工作进程逻辑流

  1. AEM Author服务调用Asset compute元数据工作程序,提供资源的 (1a) 原始二进制文件,和 (1b) 在处理配置文件中定义的任何参数。
  2. asset computeSDK可协调自定义Asset compute元数据工作进程的 renditionCallback(...) 函数,根据资产的二进制文件派生XMP (XML)演绎版 (1a) 和任何处理配置文件参数 (1b).
  3. asset compute工作进程将XMP (XML)表示形式保存到 rendition.path.
  4. 写入的XMP (XML)数据 rendition.path 通过Asset computeSDK传输到AEM创作服务,并将其公开为 (4a) 文本呈现版本和 (4b) 保留到资产的元数据节点。

配置manifest.yml

所有Asset compute工作程序都必须在 manifest.yml.

打开项目的 manifest.yml 并添加一个工作人员条目来配置新工作人员,在本例中 metadata-colors.

记住 .yml 对空格敏感。

packages:
  __APP_PACKAGE__:
    license: Apache-2.0
    actions:
      worker:
        function: actions/worker/index.js
        web: 'yes'
        runtime: 'nodejs:12'
        limits:
          timeout: 60000 # in ms
          memorySize: 512 # in MB
          concurrency: 10
        annotations:
          require-adobe-auth: true
      metadata-colors:
        function: actions/metadata-colors/index.js
        web: 'yes'
        runtime: 'nodejs:12'
        limits:
          memorySize: 512 # in MB

function 指向在中创建的工作程序实施 下一步. 语义上命名工作人员(例如, actions/worker/index.js 也许更适合指名道姓 actions/rendition-circle/index.js),如下所示 工作人员的URL 并且还确定 工作线程的测试套件文件夹名称.

limitsrequire-adobe-auth 每个工作人员单独进行配置。 在这个工人中, 512 MB 当代码检查(潜在地)大的二进制图像数据时,分配存储器的CPU和CPU。 其他 limits 将删除以使用默认值。

开发元数据工作程序

在路径下的Asset compute项目中创建新的元数据工作器JavaScript文件 为新辅助进程定义了manifest.yml,在 /actions/metadata-colors/index.js

安装npm模块

安装额外的npm模块(@adobe/asset-compute-xmpget-image-colors、和 color-namer),该变量在此Asset compute工作进程中使用。

$ npm install @adobe/asset-compute-xmp
$ npm install get-image-colors
$ npm install color-namer

元数据工作进程代码

此工作人员与 演绎版生成工作人员,主要区别在于它将XMP (XML)数据写入 rendition.path 以保存回AEM。

"use strict";

const { worker, SourceCorruptError } = require("@adobe/asset-compute-sdk");
const fs = require("fs").promises;

// Require the @adobe/asset-compute-xmp module to create XMP
const { serializeXmp } = require("@adobe/asset-compute-xmp");

// Require supporting npm modules to derive image colors from image data
const getColors = require("get-image-colors");
// Require supporting npm modules to convert image colors to color names
const namer = require("color-namer");

exports.main = worker(async (source, rendition, params) => {
  // Perform any necessary source (input) checks
  const stats = await fs.stat(source.path);
  if (stats.size === 0) {
    // Throw appropriate errors whenever an erring condition is met
    throw new SourceCorruptError("source file is empty");
  }
  const MAX_COLORS = 10;
  const DEFAULT_COLORS_FAMILY = 'basic';

  // Read the color family parameter to use to derive the color names
  let colorsFamily = rendition.instructions.colorsFamily || DEFAULT_COLORS_FAMILY;

  if (['basic', 'hex', 'html', 'ntc', 'pantone', 'roygbiv'].indexOf(colorsFamily) === -1) {
      colorsFamily = DEFAULT_COLORS_FAMILY;
  }

  // Use the `get-image-colors` module to derive the most common colors from the image
  let colors = await getColors(source.path, { options: MAX_COLORS });

  // Convert the color Chroma objects to their closest names
  let colorNames = colors.map((color) => getColorName(colorsFamily, color));

  // Serialize the data to XMP metadata
  // These properties are written to the [dam:Asset]/jcr:content/metadata resource
  // This stores
  // - The list of color names is stored in a JCR property named `wknd:colors`
  // - The colors family used to derive the color names is stored in a JCR property named `wknd:colorsFamily`
  const xmp = serializeXmp({
      // Use a Set to de-duplicate color names
      "wknd:colors": [...new Set(colorNames)],
      "wknd:colorsFamily": colorsFamily
    }, {
      // Define any property namespaces used in the above property/value definition
      // These namespaces are automatically registered in AEM if they do not yet exist
      namespaces: {
        wknd: "https://wknd.site/assets/1.0/",
      },
    }
  );

  // Save the XMP metadata to be written back to the asset's metadata node
  await fs.writeFile(rendition.path, xmp, "utf-8");
});

/**
 * Helper function that derives the closest color name for the color, based on the colors family
 *
 * @param {*} colorsFamily the colors name family to use
 * @param {*} color the color to convert to a name
 */
function getColorName(colorsFamily, color) {
    if ('hex' === colorsFamily) {  return color; }

    let names = namer(color.rgb())[colorsFamily];

    if (names.length >= 1) { return names[0].name; }
}

在本地运行元数据工作程序

在工作程序代码完成后,可以使用本地Asset compute开发工具执行该代码。

因为我们的Asset compute项目包含两个工作进程(前一个 循环演绎版 这个 metadata-colors 员工), asset compute开发工具的 配置文件定义列出了两个工作人员的执行配置文件。 第二个配置文件定义指向新的 metadata-colors 工人。

XML元数据演绎版

  1. 从Asset compute项目的根目录

  2. 执行 aio app run 启动Asset compute开发工具

  3. 选择文件…… 下拉列表,选择 示例图像 待处理

  4. 在第二个用户档案定义配置中,它指向 metadata-colors 工作人员,更新 "name": "rendition.xml" 在此工作线程生成XMP (XML)演绎版时。 (可选)添加 colorsFamily 参数(支持的值) basichexhtmlntcpantoneroygbiv)。

    {
        "renditions": [
            {
                "worker": "...",
                "name": "rendition.xml",
                "colorsFamily": "pantone"
            }
        ]
    }
    
  5. 点按 运行 并等待XML演绎版生成

    • 由于这两个工作人员都在用户档案定义中列出,因此将生成这两个演绎版。 (可选)顶部配置文件定义指向 循环演绎版工作人员 可删除,以避免从开发工具中执行该操作。
  6. 节目 部分预览生成的解释。 点按 rendition.xml 进行下载,并在VS Code(或您喜爱的XML/文本编辑器)中打开它以进行审查。

测试工作程序

可以使用测试元数据工作程序 与二进制呈现相同的Asset compute测试框架. 唯一的区别是 rendition.xxx 测试用例中的文件必须是预期的XMP (XML)演绎版。

  1. 在Asset compute项目中创建以下结构:

    /test/asset-compute/metadata-colors/success-pantone/
    
        file.jpg
        params.json
        rendition.xml
    
  2. 使用 示例文件 作为测试用例的 file.jpg.

  3. 将以下JSON添加到 params.json.

    {
        "fmt": "xml",
        "colorsFamily": "pantone"
    }
    

    请注意 "fmt": "xml" 要指示测试套件生成 .xml 基于文本的演绎版。

  4. 在中提供预期的XML rendition.xml 文件。 这可以通过以下方式获得:

    • 通过开发工具运行测试输入文件并保存(已验证的)XML呈现版本。
    <?xml version="1.0" encoding="UTF-8"?><rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:wknd="https://wknd.site/assets/1.0/"><rdf:Description><wknd:colors><rdf:Seq><rdf:li>Silver</rdf:li><rdf:li>Black</rdf:li><rdf:li>Outer Space</rdf:li></rdf:Seq></wknd:colors><wknd:colorsFamily>pantone</wknd:colorsFamily></rdf:Description></rdf:RDF>
    
  5. 执行 aio app test 从Asset compute项目的根目录执行所有测试包。

将工作人员部署到Adobe I/O Runtime

要从AEM Assets调用此新元数据工作程序,必须使用命令将其部署到Adobe I/O Runtime:

$ aio app deploy

aio应用程序部署

请注意,这将部署项目中的所有工作人员。 查看 未删节的部署说明 了解如何部署到暂存和生产工作区。

与AEM处理用户档案集成

通过创建新的自定义处理配置文件服务或修改现有的自定义处理配置文件服务,从AEM调用工作程序,此服务将调用已部署的工作程序。

处理配置文件

  1. 以身份登录AEMas a Cloud Service创作服务 AEM管理员
  2. 导航到 工具>资产>处理配置文件
  3. 创建 新的,或 编辑 和现有,处理配置文件
  4. 点按 自定义 选项卡,然后点击 新增
  5. 定义新服务
    • 创建元数据演绎版:切换到活动状态
    • 端点: https://...adobeioruntime.net/api/v1/web/wkndAemAssetCompute-0.0.1/metadata-colors
      • 这是工作人员的URL,获取时间是 部署 或使用命令 aio app get-url. 根据AEMas a Cloud Service环境,确保URL指向正确的工作区。
    • 服务参数
      • 点按 添加参数
        • 键: colorFamily
        • 值: pantone
          • 支持的值: basichexhtmlntcpantoneroygbiv
    • Mime类型
      • 包括: image/jpegimage/pngimage/gifimage/svg
        • 这些是第三方npm模块支持的唯一用于派生颜色的MIME类型。
      • 排除: Leave blank
  6. 点按 保存 在右上方
  7. 将处理配置文件应用到AEM Assets文件夹(如果尚未这样做)

更新元数据架构

要查看颜色元数据,请将图像元数据架构上的两个新字段映射到工作进程填充的新元数据数据属性。

元数据架构

  1. 在AEM Author服务中,导航到 工具>资产>元数据架构
  2. 导航到 默认 并选择并编辑 图像 和添加只读表单字段以公开生成的颜色元数据
  3. 添加 单行文本
    • 字段标签Colors Family
    • 映射到属性./jcr:content/metadata/wknd:colorsFamily
    • 规则>字段>禁用编辑:已选中
  4. 添加 多值文本
    • 字段标签Colors
    • 映射到属性./jcr:content/metadata/wknd:colors
  5. 点按 保存 在右上方

正在处理资产

资源详细信息

  1. 在AEM Author服务中,导航到 资源>文件
  2. 导航到文件夹或子文件夹,处理配置文件将应用于
  3. 将新图像(JPEG、PNG、GIF或SVG)上传到文件夹,或使用更新的重新处理现有图像 处理配置文件
  4. 处理完成后,选择资产,然后点击 属性 以显示其元数据
  5. 查看 Colors FamilyColors 元数据字段 对于从自定义Asset compute元数据工作器回写的元数据。

将颜色元数据写入到资源的元数据中,在 [dam:Asset]/jcr:content/metadata 对资源建立索引可以提高通过搜索使用这些术语的资源发现能力,如果出现这种情况,甚至可以将它们写回资源的二进制文件 DAM元数据写回 在该页面上调用工作流。

AEM Assets中的元数据演绎版

AEM Assets元数据呈现文件

asset compute元数据工作进程生成的实际XMP文件也作为离散格式副本存储在资源上。 通常不使用此文件,而是使用对资源的元数据节点应用的值,但工作进程的原始XML输出在AEM中可用。

Github上的metadata-colors工作代码

最终的 metadata-colors/index.js 可在Github上获取,网址为:

最终的 test/asset-compute/metadata-colors Github上的测试套件位于:

在此页面上