文件 AEM AEM 教學課程 AEM as a Cloud Service 教學課程

Adobe I/O Runtime動作與AEM事件

Last update: Thu Aug 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
開發
App Builder

建立對象：

初學者
開發人員

瞭解如何使用Adobe I/O Runtime動作接收AEM事件，並檢閱事件詳細資料，例如裝載、標頭和中繼資料。

https://video.tv.adobe.com/v/3427053?quality=12&learn=on

Adobe I/O Runtime是無伺服器平台，可讓程式碼執行以回應Adobe I/O事件。因此可協助您建立事件驅動的應用程式，而不需擔心基礎建設問題。

在此範例中，您會建立接收AEM事件並記錄事件詳細資料的Adobe I/O Runtime 動作。
https://developer.adobe.com/runtime/docs/guides/overview/what_is_runtime/

高層級步驟為：

在Adobe Developer Console中建立專案
初始化專案以進行本機開發
在Adobe Developer Console中設定專案
觸發AEM事件並驗證動作執行

先決條件

若要完成本教學課程，您需要：

已啟用AEM事件的AEM as a Cloud Service環境。
存取Adobe Developer Console。
Adobe Developer CLI已安裝在您的本機電腦上。

在Adobe Developer Console中建立專案

若要在Adobe Developer Console中建立專案，請遵循下列步驟：

導覽至Adobe Developer Console並按一下 主控台 按鈕。
在 快速入門 區段中，按一下 從範本建立專案。然後在 瀏覽範本 對話方塊中，選取 App Builder 範本。
視需要更新專案標題、應用程式名稱並新增工作區。然後，按一下儲存。

初始化專案以進行本機開發

若要將Adobe I/O Runtime動作新增至專案，您必須初始化專案以進行本機開發。在本機電腦開啟終端機上，導覽至您要初始化專案的位置，然後依照下列步驟進行：

執行以初始化專案

code language-bash
`aio app init`

選取Organization、您在上一步建立的Project以及工作區。在What templates do you want to search for?步驟中，選取All Templates選項。
從範本清單中選取@adobe/generator-app-excshell選項。
在您最愛的IDE中開啟專案，例如VSCode。

選取的 擴充性範本 (@adobe/generator-app-excshell)提供一般執行階段動作，程式碼在src/dx-excshell-1/actions/generic/index.js檔案中。讓我們更新以保持簡單，記錄事件詳細資料並傳回成功回應。不過在下個範例中，會增強來處理已收到的AEM事件。

code language-javascript

code language-javascript
const fetch = require("node-fetch"); const { Core } = require("@adobe/aio-sdk"); const { errorResponse, getBearerToken, stringParameters, checkMissingRequestInputs, } = require("../utils"); // main function that will be executed by Adobe I/O Runtime async function main(params) { // create a Logger const logger = Core.Logger("main", { level: params.LOG_LEVEL \|\| "info" }); try { // 'info' is the default level if not set logger.info("Calling the main action"); // log parameters, only if params.LOG_LEVEL === 'debug' logger.debug(stringParameters(params)); const response = { statusCode: 200, body: { message: "Received AEM Event, it will be processed in next example", }, }; // log the response status code logger.info(`${response.statusCode}: successful request`); return response; } catch (error) { // log any server errors logger.error(error); // return with 500 return errorResponse(500, "server error", logger); } } exports.main = main;

const fetch = require("node-fetch");
const { Core } = require("@adobe/aio-sdk");
const {
errorResponse,
getBearerToken,
stringParameters,
checkMissingRequestInputs,
} = require("../utils");

// main function that will be executed by Adobe I/O Runtime
async function main(params) {
// create a Logger
const logger = Core.Logger("main", { level: params.LOG_LEVEL || "info" });

try {
    // 'info' is the default level if not set
    logger.info("Calling the main action");

    // log parameters, only if params.LOG_LEVEL === 'debug'
    logger.debug(stringParameters(params));

    const response = {
    statusCode: 200,
    body: {
        message: "Received AEM Event, it will be processed in next example",
    },
    };

    // log the response status code
    logger.info(`${response.statusCode}: successful request`);
    return response;
} catch (error) {
    // log any server errors
    logger.error(error);
    // return with 500
    return errorResponse(500, "server error", logger);
}
}

exports.main = main;

最後，透過執行在Adobe I/O Runtime上部署更新的動作。

code language-bash
`aio app deploy`

在Adobe Developer Console中設定專案

若要接收AEM事件並執行上一步建立的Adobe I/O Runtime動作，請在Adobe Developer Console中設定專案。

在Adobe Developer Console中，導覽至上一步建立的專案，然後按一下以開啟專案。選取Stage工作區，這是部署動作的位置。
按一下 [新增服務]按鈕，然後選取 API 選項。在 新增API 強制回應視窗中，選取 Adobe服務 > I/O管理API，然後按一下 下一步，遵循其他設定步驟，然後按一下 儲存已設定的API。
同樣地，按一下 新增服務 按鈕並選取事件選項。在 新增事件 對話方塊中，選取 Experience Cloud > AEM Sites，然後按一下 下一步。按照其他設定步驟操作，選取AEMCS執行個體、事件型別和其他詳細資訊。
最後，在 如何接收事件 步驟中，展開 執行階段動作 選項，並選取在上一步建立的一般動作。按一下 儲存已設定的事件。
檢閱事件註冊詳細資料，以及 偵錯追蹤 標籤，並驗證 挑戰探查 要求與回應。