開發Asset compute中繼資料背景工作

自訂Asset compute背景工作可產生XMP (XML)資料，這些資料會傳回AEM並儲存為資產上的中繼資料。

常見的使用案例包括：

與協力廠商系統(例如PIM （產品資訊管理系統）)的整合，其中必須擷取其他中繼資料並儲存在資產上
與Adobe服務（例如Content和Commerce AI）整合，以使用其他機器學習屬性來增強資產中繼資料
從資產的二進位檔衍生有關資產的中繼資料，並將其儲存為AEMas a Cloud Service的資產中繼資料

您將要執行的動作

在本教學課程中，我們將建立Asset compute中繼資料背景工作，它會衍生出影像資產中最常使用的顏色，並將顏色名稱寫入AEM中的資產中繼資料。雖然背景工作程式本身至關重要，但本教學課程會使用它來探索如何使用Asset compute背景工作程式將中繼資料回寫至AEMas a Cloud Service中的資產。

asset compute中繼資料工作者叫用的邏輯流程

asset compute中繼資料背景工作程式的叫用方式與的幾乎相同產生背景工作的二進位轉譯，主要差異為傳回型別的是XMP (XML)轉譯，其值也會寫入資產的中繼資料。

asset compute背景工作者在以下位置實作Asset computeSDK背景工作API合約： renditionCallback(...) 函式，其概念為：

輸入： AEM資產的原始二進位檔和處理設定檔引數
輸出： XMP (XML)轉譯持續儲存至AEM資產作為轉譯，並儲存至資產的中繼資料

asset compute中繼資料工作者邏輯流程

AEM Author服務會叫用Asset compute中繼資料背景工作，提供資產的 (1a) 原始二進位檔案，和 (1b) 處理設定檔中定義的任何引數。
asset computeSDK會協調自訂Asset compute中繼資料背景工作程式的執行 renditionCallback(...) 函式，根據資產的二進位衍生出XMP (XML)轉譯 (1a) 以及任何處理設定檔引數 (1b).
asset compute工作者會將XMP (XML)表示法儲存至 rendition.path.
寫入的XMP (XML)資料 rendition.path 會透過Asset compute SDK傳輸至AEM Author Service，並公開為 (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 並且也會決定 worker的測試套裝資料夾名稱.

此 limits 和 require-adobe-auth 是按個別工作者個別設定。在此背景工作程式中， 512 MB 配置記憶體時，程式碼會檢查（潛在）大型二進位影像資料。其他 limits 會移除以使用預設值。

開發中繼資料背景工作

在路徑的Asset compute專案中建立新的中繼資料背景工作JavaScript檔案已為新背景工作定義manifest.yml，在 /actions/metadata-colors/index.js

安裝npm模組

安裝額外的npm模組(@adobe/asset-compute-xmp， get-image-colors、和 color-name)時，才能使用這個值。 )此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 worker)， asset compute開發工具的設定檔定義會列出兩個背景工作者的執行設定檔。第二個設定檔定義指向新的 metadata-colors 背景工作。

XML中繼資料轉譯

從Asset compute專案的根目錄
執行 aio app run 啟動Asset compute開發工具
在 選取檔案…… 下拉式清單，選取範例影像待處理
在第二個設定檔定義設定中，指向 metadata-colors 背景工作，更新 "name": "rendition.xml" 當此背景工作產生XMP (XML)轉譯時。選擇性地新增 colorsFamily 引數（支援的值） basic， hex， html， ntc， pantone， roygbiv)。
```
{
    "renditions": [
        {
            "worker": "...",
            "name": "rendition.xml",
            "colorsFamily": "pantone"
        }
    ]
}
```
點選執行並等待XML轉譯產生
- 由於兩個背景工作都列在設定檔定義中，因此兩個轉譯都會產生。選擇性地指向以下連結的上層設定檔定義：圓形轉譯背景工作可刪除，以避免從開發工具中執行。
此轉譯區段會預覽產生的轉譯。點選 rendition.xml 若要下載檔案，並以VS Code （或您最愛的XML/文字編輯器）開啟檔案以進行稽核。

測試背景工作

中繼資料背景工作可使用進行測試與二進位轉譯相同的Asset compute測試架構. 唯一的區別是 rendition.xxx 測試案例中的檔案必須是預期的XMP (XML)轉譯。

在Asset compute專案中建立下列結構：

/test/asset-compute/metadata-colors/success-pantone/

    file.jpg
    params.json
    rendition.xml

使用範例檔案作為測試案例的 file.jpg.
將下列JSON新增至 params.json.
```
{
    "fmt": "xml",
    "colorsFamily": "pantone"
}
```
請注意 "fmt": "xml" 需要指示測試套裝產生 .xml 文字型轉譯。

在中提供預期的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>

執行 aio app test 從Asset compute專案的根目錄執行所有測試套裝。

將背景工作部署至Adobe I/O Runtime

若要從AEM Assets叫用這個新的中繼資料工作程式，必須使用命令將其部署到Adobe I/O Runtime：

$ aio app deploy

aio應用程式部署

請注意，這將部署專案中的所有背景工作。檢閱未刪節的部署指示瞭解如何部署至中繼和生產工作區。

與AEM處理設定檔整合

透過建立新的或修改現有的自訂處理設定檔服務來從AEM叫用背景工作程式，此服務會叫用這個已部署背景工作程式。

以身分登入AEMas a Cloud Service作者服務 AEM管理員
導覽至 工具>資產>處理設定檔
建立新的，或編輯和現有，處理設定檔
點選自訂標籤，然後點選新增
定義新服務
- 建立中繼資料轉譯：切換至使用中
- 端點： https://...adobeioruntime.net/api/v1/web/wkndAemAssetCompute-0.0.1/metadata-colors
  - 這是工作者的URL，取得於部署或使用指令 aio app get-url. 根據AEMas a Cloud Service環境，確保URL指向正確的工作區。
- 服務參數
  - 點選 新增引數
    - 金鑰: colorFamily
    - 值: pantone
      - 支援的值： basic， hex， html， ntc， pantone， roygbiv
- Mime 類型
  - 包括： image/jpeg， image/png， image/gif， image/svg
    - 這是第三方npm模組唯一支援的MIME型別，用來衍生顏色。
  - 排除： Leave blank
點選儲存在右上方
將處理設定檔套用至AEM Assets資料夾（如果尚未套用）

更新中繼資料結構

若要檢閱色彩中繼資料，請將影像中繼資料結構描述上的兩個新欄位對應到背景工作填入的新中繼資料屬性。

中繼資料結構

在AEM作者服務中，導覽至 「工具>資產>中繼資料結構」
導覽至預設並選取和編輯影像和新增唯讀表單欄位以公開產生的色彩中繼資料
新增 單行文字
- 欄位標籤: Colors Family
- 映射至屬性: ./jcr:content/metadata/wknd:colorsFamily
- 規則>欄位>停用編輯：已核取
新增 多值文字
- 欄位標籤: Colors
- 映射至屬性: ./jcr:content/metadata/wknd:colors
點選儲存在右上方

正在處理資產

資產詳細內容

在AEM作者服務中，導覽至 「資產」>「檔案」
導覽至資料夾或子資料夾，處理設定檔將套用至
上傳新影像(JPEG、PNG、GIF或SVG)至資料夾，或使用更新的重新處理現有影像處理設定檔
處理完成後，選取資產，然後點選屬性在頂端動作列顯示其中繼資料
檢閱 Colors Family 和 Colors 中繼資料欄位適用於從自訂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上取得，網址為：

aem-guides-wknd-asset-compute/actions/metadata-colors/index.js

最終版 test/asset-compute/metadata-colors 測試套裝可在Github上取得，網址為：

aem-guides-wknd-asset-compute/test/asset-compute/metadata-colors

開發Asset compute中繼資料背景工作

您將要執行的動作

asset compute中繼資料工作者叫用的邏輯流程

設定manifest.yml

開發中繼資料背景工作

安裝npm模組

中繼資料背景工作代碼

在本機執行中繼資料背景工作

測試背景工作

將背景工作部署至Adobe I/O Runtime

與AEM處理設定檔整合

更新中繼資料結構

正在處理資產

AEM Assets中的中繼資料轉譯

Github上的metadata-colors背景工作代碼

Business.Adobe.com 資源

本頁內容

檢視下一個:

學習

說明文件

社群

技術支援

資源

Adobe 帳戶

Adobe