AEM API sin encabezado y React
Le damos la bienvenida a este capítulo del tutorial, en el que exploraremos la configuración de una aplicación de React para conectarse con las API de Adobe Experience Manager AEM AEM () sin encabezado mediante el SDK sin encabezado de la aplicación de. AEM Cubriremos la recuperación de datos de fragmentos de contenido desde las API de GraphQL de la aplicación de y su visualización en la aplicación de React.
AEM AEM Las API sin encabezado de permiten acceder a contenido de la desde cualquier aplicación de cliente. AEM AEM Le guiaremos a través de la configuración de su aplicación React para conectarse a las API de sin encabezado de la red mediante el SDK sin encabezado de la interfaz de usuario de. AEM Esta configuración establece un canal de comunicación reutilizable entre la aplicación React y el usuario de la aplicación de la aplicación de.
AEM AEM A continuación, utilizaremos el SDK sin encabezado de la para recuperar datos de fragmentos de contenido de las API de GraphQL de la. AEM Los fragmentos de contenido en los que se proporciona la administración de contenido estructurada de los. AEM Al utilizar el SDK sin encabezado de, puede consultar y recuperar fácilmente datos de fragmentos de contenido mediante GraphQL.
Una vez que tengamos los datos del fragmento de contenido, los integraremos en su aplicación React. Aprenderá a dar formato y mostrar los datos de una manera atractiva. Cubriremos las prácticas recomendadas para administrar y procesar datos de fragmentos de contenido en los componentes de React, lo que garantiza una integración perfecta con la interfaz de usuario de la aplicación.
A lo largo del tutorial, proporcionaremos explicaciones, ejemplos de código y sugerencias prácticas. AEM AEM Al final, podrá configurar la aplicación React para conectarse a las API de sin encabezado, recuperar datos de fragmentos de contenido mediante el SDK sin encabezado de la aplicación React y mostrarlos sin problemas en la aplicación React. ¡Vamos a empezar!
Clonar la aplicación React
-
Clone la aplicación desde Github ejecutando el siguiente comando en la línea de comandos.
code language-none $ git clone git@github.com:lamontacrook/headless-first.git
-
Cambie al directorio
headless-first
e instale las dependencias.code language-none $ cd headless-first $ npm ci
Configuración de la aplicación React
-
Cree un archivo con el nombre
.env
en la raíz del proyecto. En.env
establezca los siguientes valores:code language-none REACT_APP_AEM=<URL of the AEM instance> REACT_APP_ENDPOINT=<the name of the endpoint> REACT_APP_PROJECT=<the name of the folder with Content Fragments> REACT_APP_TOKEN=<developer token>
-
Puede recuperar un token de desarrollador en Cloud Manager. Inicie sesión en Adobe Cloud Manager. Haga clic en Experience Manager > Cloud Manager. Elija el Programa adecuado y, a continuación, haga clic en los puntos suspensivos junto al Entorno.
AEM
- Haga clic en la ficha Integraciones
- Haga clic en la ficha Token local y obtenga el token de desarrollo local
- Copie el token de acceso comenzando después de la comillas abiertas hasta antes de la comillas de cierre.
- Pegue el token copiado como el valor de
REACT_APP_TOKEN
en el archivo.env
. - Ahora vamos a crear la aplicación ejecutando
npm ci
en la línea de comandos. - Ahora inicie la aplicación React y ejecute
npm run start
en la línea de comandos. - En ./src/utils un archivo de nombre
context.js
incluye el código para establecer los valores del archivo.env
en el contexto de la aplicación.
Ejecute la aplicación React
-
Inicie la aplicación React ejecutando
npm run start
en la línea de comandos.code language-none $ npm run start
La aplicación React se iniciará y abrirá una ventana del explorador a
http://localhost:3000
. Los cambios en la aplicación React se volverán a cargar automáticamente en el navegador.
AEM Conexión a las API sin encabezado de
-
Para conectar la aplicación React a AEM as a Cloud Service, vamos a agregar algunas cosas a
App.js
. En la importaciónReact
, agregueuseContext
.code language-javascript import React, {useContext} from 'react';
Importar
AppContext
desde el archivocontext.js
.code language-javascript import { AppContext } from './utils/context';
Ahora, en el código de la aplicación, defina una variable de contexto.
code language-javascript const context = useContext(AppContext);
Y finalmente ajuste el código de retorno en
<AppContext.Provider> ... </AppContext.Provider>
.code language-javascript ... return(<div className='App'> <AppContext.Provider value={context}> ... </AppContext.Provider> </div>);
Como referencia,
App.js
debería ser así.code language-javascript import React, {useContext} from 'react'; import './App.css'; import { BrowserRouter, Routes, Route } from 'react-router-dom'; import Home from './screens/home/home'; import { AppContext } from './utils/context'; const App = () => { const context = useContext(AppContext); return ( <div className='App'> <AppContext.Provider value={context}> <BrowserRouter> <Routes> <Route exact={true} path={'/'} element={<Home />} /> </Routes> </BrowserRouter> </AppContext.Provider> </div> ); }; export default App;
-
Importe el SDK
AEMHeadless
. AEM Este SDK es una biblioteca de ayuda que utiliza la aplicación para interactuar con las API sin encabezado de la interfaz de usuario de la aplicación para interactuar con la interfaz de usuario sin encabezadoAgregar esta instrucción de importación a
home.js
.code language-javascript import AEMHeadless from '@adobe/aem-headless-client-js';
Agregue el(la) siguiente
{ useContext, useEffect, useState }
a la instrucción de importaciónReact
.code language-javascript import React, { useContext, useEffect, useState } from 'react';
Importar
AppContext
.code language-javascript import { AppContext } from '../../utils/context';
Dentro del componente
Home
, obtenga la variablecontext
deAppContext
.code language-javascript const Home = () => { const context = useContext(AppContext); ... }
-
AEM AEM Inicialice el SDK sin encabezado de la dentro de
useEffect()
, ya que el SDK sin encabezado de la aplicación debe cambiar cuando cambia la variablecontext
.code language-javascript useEffect(() => { const sdk = new AEMHeadless({ serviceURL: context.url, endpoint: context.endpoint, auth: context.token }); }, [context]);
note note NOTE Hay un archivo context.js
en/utils
que está leyendo elementos del archivo.env
. Como referencia,context.url
es la dirección URL del entorno de AEM as a Cloud Service.context.endpoint
es la ruta de acceso completa al extremo creado en la lección anterior. Por último,context.token
es el token de desarrollador. -
AEM Cree el estado React que expone el contenido proveniente del SDK sin encabezado de.
code language-javascript const Home = () => { const [content, setContent] = useState({}); ... }
-
AEM Conecte la aplicación a la red de. Utilice la consulta persistente creada en la lección anterior. AEM Vamos a agregar el código siguiente dentro de
useEffect
después de inicializar el SDK sin encabezado de la. Haga queuseEffect
dependa de la variablecontext
tal como se ve a continuación.code language-javascript useEffect(() => { ... sdk.runPersistedQuery('<name of the endpoint>/<name of the persisted query>', { path: `/content/dam/${context.project}/<name of the teaser fragment>` }) .then(({ data }) => { if (data) { setContent(data); } }) .catch((error) => { console.log(`Error with pure-headless/teaser. ${error.message}`); }); }, [context]);
-
Abra la vista Red de las herramientas del desarrollador para revisar la solicitud de GraphQL.
<url to environment>/graphql/execute.json/pure-headless/teaser%3Bpath%3D%2Fcontent%2Fdam%2Fpure-headless%2Fhero
AEM El SDK sin encabezado de la codifica la solicitud de GraphQL y agrega los parámetros proporcionados. Puede abrir la solicitud en el explorador.
note note NOTE Dado que la solicitud va al entorno de creación, debe iniciar sesión en el entorno en otra pestaña del mismo explorador.
Procesar contenido de fragmentos de contenido
-
Muestre los fragmentos de contenido en la aplicación. Devuelve un(a)
<div>
con el título del teaser.code language-javascript return ( <div className='main-body'> <div>{content.component && (content.component.item.title)}</div> </div> );
Debería ver el campo de título del teaser en la pantalla.
-
El último paso es añadir el teaser a la página. Se incluye un componente de teaser de React en el paquete. En primer lugar, vamos a incluir la importación. En la parte superior del archivo
home.js
, agregue la línea:import Teaser from '../../components/teaser/teaser';
Actualice la instrucción return:
code language-javascript return ( <div className='main-body'> <div>{content.component && <Teaser content={content.component.item} />}</div> </div> );
Ahora debería ver el teaser con el contenido incluido en el fragmento.
Siguientes pasos
Enhorabuena. AEM AEM ¡Ha actualizado correctamente la aplicación React para integrarla con las API de sin encabezado de mediante el SDK sin encabezado
AEM A continuación, vamos a crear un componente de lista de imágenes más complejo que procese dinámicamente los fragmentos de contenido referenciados a partir de los fragmentos de contenido que se han.
Capítulo siguiente: Creación de un componente de lista de imágenes