App Node.js server-to-server
- Si applica a:
- Experience Manager as a Cloud Service
- Argomenti:
- Frammenti di contenuto
Creato per:
- Principiante
- Sviluppatore
AEM Headless as a Cloud Service
Le applicazioni di esempio sono un ottimo modo per esplorare le funzionalità headless di Adobe Experience Manager (AEM). Questa applicazione server-to-server illustra come eseguire query sui contenuti che utilizzano le API GraphQL di AEM utilizzando query persistenti e stamparle sul terminale.
Visualizza il codice sorgente in GitHub
Prerequisiti
I seguenti strumenti devono essere installati localmente:
Requisiti di AEM
L’applicazione Node.js funziona con le seguenti opzioni di distribuzione di AEM. Tutte le distribuzioni richiedono l'installazione del sito WKND v3.0.0+.
- AEM as a Cloud Service
- Facoltativamente, credenziali del servizio se si autorizzano le richieste (ad esempio, la connessione al servizio AEM Author).
Questa applicazione Node.js può connettersi ad AEM Author o AEM Publish in base ai parametri della riga di comando.
Come usare
-
Clona l'archivio
adobe/aem-guides-wknd-graphql:$ git clone git@github.com:adobe/aem-guides-wknd-graphql.git -
Apri un terminale ed esegui i comandi:
$ cd aem-guides-wknd-graphql/server-to-server-app $ npm install -
L’app può essere eseguita utilizzando il comando:
$ node index.js <AEM_HOST> <OPTIONAL_SERVICE_CONFIG_FILE_PATH>Ad esempio, per eseguire l’app su AEM Publish senza autorizzazione:
$ node index.js https://publish-p123-e789.adobeaemcloud.comPer eseguire l’app su AEM Author con autorizzazione:
$ node index.js https://author-p123-e456.adobeaemcloud.com ./service-config.json -
Nel terminale deve essere stampato un elenco JSON di avventure provenienti dal sito di riferimento WKND.
Il codice
Di seguito è riportato un riepilogo della modalità di creazione dell’applicazione Node.js server-to-server, della connessione a AEM Headless per il recupero di contenuti tramite query persistenti GraphQL e della modalità di presentazione di tali dati. Il codice completo si trova su GitHub.
Il caso d’uso comune per le app AEM headless server-to-server prevede la sincronizzazione dei dati dei frammenti di contenuto da AEM ad altri sistemi. Tuttavia questa applicazione è intenzionalmente semplice e stampa i risultati JSON dalla query persistente.
Query persistenti
Seguendo le best practice di AEM Headless, l’applicazione utilizza query persistenti di AEM GraphQL per eseguire query sui dati delle esperienze. L’applicazione utilizza due query persistenti:
- Query persistente
wknd/adventures-all, che restituisce tutte le avventure in AEM con un set ridotto di proprietà. Questa query persistente guida l’elenco di avventure della visualizzazione iniziale.
# 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
}
}
}
}
}
Creare un client 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
})
...
}
Esegui query persistente GraphQL
Le query persistenti di AEM vengono eseguite su HTTP GET, pertanto il client AEM Headless per Node.js viene utilizzato per eseguire le query GraphQL persistenti su AEM e recuperare il contenuto delle avventure.
La query persistente viene richiamata chiamando aemHeadlessClient.runPersistedQuery(...) e passando il nome della query GraphQL persistente. Una volta che GraphQL restituisce i dati, passarli alla funzione doSomethingWithDataFromAEM(..) semplificata, che stampa i risultati, ma in genere invia i dati a un altro sistema o genera un output in base ai dati recuperati.
// 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())
}
}