Adobe I/O Runtime Action and AEM Events

AEM as a Cloud Service environment with AEM Eventing enabled.

Access to Adobe Developer Console.

Adobe Developer CLI installed on your local machine.

Navigate to Adobe Developer Console and click Console button.

In the Quick Start section, click Create project from template. Then, in the Browse templates dialog, select App Builder template.

Update the Project title, App name, and Add workspace if needed. Then, click Save.

Initialize project by running

aio app init

Select the Organization, the Project you created in the previous step, and the workspace. In What templates do you want to search for? step, select All Templates option.

From the templates list, select @adobe/generator-app-excshell option.

Open project in your favorite IDE, for example VSCode.

The selected Extensibility template (@adobe/generator-app-excshell) provides a generic runtime action, the code is in src/dx-excshell-1/actions/generic/index.js file. Let’s update it to keep it simple, log the event details and return a success response. However in the next example, it is enhanced to process the received AEM Events.

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;

Finally, deploy the updated action on Adobe I/O Runtime by running.

aio app deploy

In Adobe Developer Console, navigate to the project created in the previous step and click to open it. Select the Stage workspace, this is where action got deployed.

Click Add Service button and select API option. In the Add an API modal, select Adobe Services > I/O Management API and click Next, follow additional configuration steps and click Save configured API.

Likewise, click Add Service button and select Event option. In the Add Events dialog, select Experience Cloud > AEM Sites, and click Next. Follow additional configuration steps, select AEMCS instance, event types, and other details.

Finally, in the How to receive events step, expand Runtime action option and select the generic action created in the previous step. Click Save configured events.

Review the Event Registration details, also the Debug Tracing tab and verify the Challenge Probe request and response.

Access and login to your AEM as a Cloud Service author environment via Cloud Manager.

Depending on your Subscribed Events, create, update, delete, publish or unpublish a Content Fragment.