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 de 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
-
Clonar 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 a la
headless-first
e instale las dependencias.code language-none $ cd headless-first $ npm ci
Configuración de la aplicación React
-
Cree un archivo llamado
.env
en la raíz del proyecto. Entrada.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. Iniciar sesión en Adobe Cloud Manager. Clic Experience Manager > Cloud Manager. Elija el Programa adecuado y, a continuación, haga clic en los puntos suspensivos junto al Entorno.
- Haga clic en en Integraciones pestaña
- Clic Pestaña Token local y obtenga el token de desarrollo local botón
- Copie el token de acceso comenzando después de la comillas abiertas hasta antes de la comillas de cierre.
- Pegue el token copiado como valor para
REACT_APP_TOKEN
en el.env
archivo. - Ahora vamos a crear la aplicación ejecutando
npm ci
en la línea de comandos. - Ahora inicie la aplicación React y ejecutando
npm run start
en la línea de comandos. - Entrada ./src/utils un archivo denominado
context.js
incluye el código para establecer los valores en.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 inicia y abre una ventana del explorador para que
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
-
AEM Para conectar la aplicación de React a la as a Cloud Service, vamos a añadir algunas cosas a la lista de aplicaciones de React para que se puedan usar en su lugar.
App.js
. En elReact
importar, añadiruseContext
.code language-javascript import React, {useContext} from 'react';
Importar
AppContext
desde elcontext.js
archivo.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, la variable
App.js
Ahora 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
AEMHeadless
SDK. AEM Este SDK es una biblioteca de ayuda que utiliza la aplicación para interactuar con las API sin encabezado de la aplicación de la interfaz de usuario de.Añada esta instrucción de importación a
home.js
.code language-javascript import AEMHeadless from '@adobe/aem-headless-client-js';
Añada lo siguiente
{ useContext, useEffect, useState }
a laReact
import.code language-javascript import React, { useContext, useEffect, useState } from 'react';
Importe el
AppContext
.code language-javascript import { AppContext } from '../../utils/context';
Dentro de
Home
componente, obtenga elcontext
de la variableAppContext
.code language-javascript const Home = () => { const context = useContext(AppContext); ... }
-
AEM Inicialice el SDK sin encabezado de la dentro de un
useEffect()
AEM , ya que el SDK sin encabezado de la debe cambiar cuando la variablecontext
cambios de la variable.code language-javascript useEffect(() => { const sdk = new AEMHeadless({ serviceURL: context.url, endpoint: context.endpoint, auth: context.token }); }, [context]);
note note NOTE Hay un context.js
archivo en/utils
que lee elementos de la.env
archivo. Como referencia, la variablecontext.url
AEM es la dirección URL del entorno as a Cloud Service de la. Elcontext.endpoint
es la ruta completa al punto final creado en la lección anterior. Por último, elcontext.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. Vamos a añadir el siguiente código dentro de la variable
useEffect
AEM después de inicializar el SDK sin encabezado de la. Realice lauseEffect
depende delcontext
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. Devolver un
<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
home.js
, añada 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.
Pasos siguientes
Felicitaciones. 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