Aplicativo Node.js de servidor para servidor
- Aplica-se a:
- Experience Manager as a Cloud Service
- Tópicos:
- Fragmentos de conteúdo
Criado para:
- Iniciante
- Desenvolvedor
AEM Headless as a Cloud Service
Aplicativos de exemplo são uma ótima maneira de explorar os recursos headless do Adobe Experience Manager (AEM). Este aplicativo de servidor para servidor demonstra como consultar conteúdo usando as APIs GraphQL do AEM usando consultas persistentes e imprimi-las no terminal.
Exibir o código-fonte no GitHub
Pré-requisitos
As seguintes ferramentas devem ser instaladas localmente:
Requisitos do AEM
O aplicativo Node.js funciona com as seguintes opções de implantação do AEM. Todas as implantações exigem que o WKND Site v3.0.0+ esteja instalado.
- AEM as a Cloud Service
- Opcionalmente, credenciais de serviço, se estiver autorizando solicitações (por exemplo, conectando-se ao serviço do AEM Author).
Este aplicativo Node.js pode se conectar ao AEM Author ou ao AEM Publish com base nos parâmetros da linha de comando.
Como usar
-
Clonar o repositório
adobe/aem-guides-wknd-graphql:$ git clone git@github.com:adobe/aem-guides-wknd-graphql.git -
Abra um terminal e execute os comandos:
$ cd aem-guides-wknd-graphql/server-to-server-app $ npm install -
O aplicativo pode ser executado usando o comando:
$ node index.js <AEM_HOST> <OPTIONAL_SERVICE_CONFIG_FILE_PATH>Por exemplo, para executar o aplicativo em relação ao AEM Publish sem autorização:
$ node index.js https://publish-p123-e789.adobeaemcloud.comPara executar o aplicativo em relação ao AEM Author com autorização:
$ node index.js https://author-p123-e456.adobeaemcloud.com ./service-config.json -
Uma lista JSON de aventuras do site de referência da WKND deve ser impressa no terminal.
O código
Abaixo está um resumo de como o aplicativo Node.js servidor a servidor é criado, como ele se conecta ao AEM Headless para recuperar conteúdo usando consultas persistentes do GraphQL e como esses dados são apresentados. O código completo pode ser encontrado no GitHub.
O caso de uso comum para aplicativos headless do AEM de servidor para servidor é sincronizar dados do fragmento de conteúdo do AEM com outros sistemas, no entanto, esse aplicativo é intencionalmente simples e imprime os resultados JSON da consulta persistente.
Consultas persistentes
Seguindo as práticas recomendadas do AEM Headless, o aplicativo usa consultas persistentes do AEM GraphQL para consultar dados de aventura. O aplicativo usa duas consultas persistentes:
wknd/adventures-allconsulta persistente, que retorna todas as aventuras no AEM com um conjunto abreviado de propriedades. Essa consulta persistente direciona a lista de aventura da visualização inicial.
# Retrieves a list of all Adventures
#
# Optional query variables:
# - { "offset": 10 }
# - { "limit": 5 }
# - {
# "imageFormat": "JPG",
# "imageWidth": 1600,
# "imageQuality": 90
# }
query ($offset: Int, $limit: Int, $sort: String, $imageFormat: AssetTransformFormat=JPG, $imageWidth: Int=1200, $imageQuality: Int=80) {
adventureList(
offset: $offset
limit: $limit
sort: $sort
_assetTransform: {
format: $imageFormat
width: $imageWidth
quality: $imageQuality
preferWebp: true
}) {
items {
_path
slug
title
activity
price
tripLength
primaryImage {
... on ImageRef {
_path
_dynamicUrl
}
}
}
}
}
Criar cliente do AEM Headless
const { AEMHeadless, getToken } = require('@adobe/aem-headless-client-nodejs');
async function run() {
// Parse the AEM host, and optional service credentials from the command line arguments
const args = process.argv.slice(2);
const aemHost = args.length > 0 ? args[0] : null; // Example: https://author-p123-e456.adobeaemcloud.com
const serviceCredentialsFile = args.length > 1 ? args[1] : null; // Example: ./service-config.json
// If service credentials are provided via command line argument,
// use `getToken(..)` to exchange them with Adobe IMS for an AEM access token
let accessToken;
if (serviceCredentialsFile) {
accessToken = (await getToken(serviceCredentialsFile)).accessToken;
}
// Instantiate withe AEM Headless client to query AEM GraphQL APIs
// The endpoint is left blank since only persisted queries should be used to query AEM's GraphQL APIs
const aemHeadlessClient = new AEMHeadless({
serviceURL: aemHost,
endpoint: '', // Avoid non-persisted queries
auth: accessToken // accessToken only set if the 2nd command line parameter is set
})
...
}
Executar consulta persistente do GraphQL
As consultas persistentes do AEM são executadas por HTTP GET e, portanto, o cliente AEM Headless para Node.js é usado para executar as consultas persistentes do GraphQL no AEM e recuperar o conteúdo de aventura.
A consulta persistente é invocada chamando aemHeadlessClient.runPersistedQuery(...) e transmitindo o nome da consulta persistente do GraphQL. Depois que o GraphQL retornar os dados, passe-os para a função simplificada doSomethingWithDataFromAEM(..), que imprime os resultados, mas normalmente enviaria os dados para outro sistema ou geraria alguma saída com base nos dados recuperados.
// index.js
async function run() {
...
try {
// Retrieve the data from AEM GraphQL APIs
data = await aemHeadlessClient.runPersistedQuery('wknd-shared/adventures-all')
// Do something with the data from AEM.
// A common use case is sending the data to another system.
await doSomethingWithDataFromAEM(data);
} catch (e) {
console.error(e.toJSON())
}
}