Eventos de ação e AEM do Adobe I/O Runtime

Saiba como receber Eventos AEM usando a Ação Adobe I/O Runtime e revise os detalhes do evento, como carga, cabeçalhos e metadados.

O Adobe I/O Runtime é uma plataforma sem servidor que permite a execução de código em resposta a eventos Adobe I/O. Dessa forma, você pode criar aplicativos orientados por eventos sem se preocupar com a infraestrutura.

Neste exemplo, você cria uma Ação do Adobe I/O Runtime que recebe Eventos AEM e registra os detalhes do evento.
https://developer.adobe.com/runtime/docs/guides/overview/what_is_runtime/

As etapas de alto nível são:

  • Criar projeto no Adobe Developer Console
  • Inicializar projeto para desenvolvimento local
  • Configurar projeto no Adobe Developer Console
  • Acione o evento AEM e verifique a execução da ação

Pré-requisitos

Para concluir este tutorial, você precisa:

IMPORTANT
O AEM as a Cloud Service Eventing só está disponível para usuários registrados no modo de pré-lançamento. Para habilitar eventos de AEM no seu ambiente AEM as a Cloud Service, entre em contato com a equipe de eventos de AEM.

Criar projeto no Adobe Developer Console

Para criar um projeto no Adobe Developer Console, siga estas etapas:

  • Navegue até Adobe Developer Console e clique no botão Console.

  • Na seção Início Rápido, clique em Criar projeto a partir do modelo. Em seguida, na caixa de diálogo Procurar modelos, selecione o modelo App Builder.

  • Atualize o título do projeto, o nome do aplicativo e adicione o espaço de trabalho, se necessário. Em seguida, clique em Salvar.

    Criar projeto no Adobe Developer Console

Inicializar projeto para desenvolvimento local

Para adicionar uma Ação do Adobe I/O Runtime ao projeto, você deve inicializar o projeto para desenvolvimento local. No terminal aberto do computador local, navegue até o local em que deseja inicializar o projeto e siga estas etapas:

  • Inicializar projeto executando

    code language-bash
    aio app init
    
  • Selecione o Organization, o Project que você criou na etapa anterior e o espaço de trabalho. Na etapa What templates do you want to search for?, selecione a opção All Templates.

    Org-Project-Selection - Inicializar projeto

  • Na lista de modelos, selecione a opção @adobe/generator-app-excshell.

    Modelo de extensibilidade - Inicializar projeto

  • Abra o projeto em seu IDE favorito, por exemplo, VSCode.

  • O Modelo de extensibilidade (@adobe/generator-app-excshell) selecionado fornece uma ação de tempo de execução genérica; o código está no arquivo src/dx-excshell-1/actions/generic/index.js. Vamos atualizá-la para manter a simplicidade, registrar os detalhes do evento e retornar uma resposta de sucesso. No entanto, no próximo exemplo, ele é aprimorado para processar os Eventos AEM recebidos.

    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;
    
  • Por fim, implante a ação atualizada no Adobe I/O Runtime executando.

    code language-bash
    aio app deploy
    

Configurar projeto no Adobe Developer Console

Para receber Eventos AEM e executar a Ação do Adobe I/O Runtime criada na etapa anterior, configure o projeto no Adobe Developer Console.

  • No Adobe Developer Console, navegue até o projeto criado na etapa anterior e clique para abri-lo. Selecione o espaço de trabalho Stage. Aqui é onde a ação foi implantada.

  • Clique no botão Adicionar Serviço e selecione a opção API. No modal Adicionar uma API, selecione Adobe Services > API de Gerenciamento de E/S e clique em Avançar, siga as etapas de configuração adicionais e clique em Salvar API configurada.

    Adicionar Serviço - Configurar projeto

  • Da mesma forma, clique no botão Adicionar Serviço e selecione a opção Evento. Na caixa de diálogo Adicionar eventos, selecione Experience Cloud > AEM Sites e clique em Avançar. Siga as etapas adicionais de configuração, selecione a instância do AEM, os tipos de evento e outros detalhes.

  • Finalmente, na etapa Como receber eventos, expanda a opção Ação em tempo de execução e selecione a ação genérica criada na etapa anterior. Clique em Salvar eventos configurados.

    Ação em tempo de execução - Configurar projeto

  • Revise os detalhes do Registro de eventos, também a guia Rastreamento de depuração e verifique a solicitação e a resposta do Teste de desafio.

    Detalhes de Inscrição no Evento

Acionar eventos de AEM

Para acionar eventos de AEM do seu ambiente do AEM as a Cloud Service que foi registrado no projeto do Adobe Developer Console acima, siga estas etapas:

  • Acesse e faça logon no ambiente de criação do AEM as a Cloud Service via Cloud Manager.

  • Dependendo dos seus Eventos nos quais você se inscreveu, crie, atualize, exclua, publique ou cancele a publicação de um Fragmento de conteúdo.

Revisar detalhes do evento

Depois de concluir as etapas acima, você deve ver os Eventos de AEM sendo entregues à ação genérica.

Você pode examinar os detalhes do evento na guia Rastreamento de Depuração dos detalhes de Registro de Eventos.

Detalhes do evento AEM

Próximas etapas

No próximo exemplo, vamos aprimorar essa ação para processar eventos do AEM, chamar de volta o serviço de autor do AEM para obter detalhes do conteúdo, armazenar detalhes no armazenamento do Adobe I/O Runtime SPA e exibi-los por meio do aplicativo de página única ().

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