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

  1. 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
    
  2. Cambie al directorio headless-first e instale las dependencias.

    code language-none
    $ cd headless-first
    $ npm ci
    

Configuración de la aplicación React

  1. 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>
    
  2. 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 Developer Console

    1. Haga clic en la ficha Integraciones
    2. Haga clic en la ficha Token local y obtenga el token de desarrollo local
    3. Copie el token de acceso comenzando después de la comillas abiertas hasta antes de la comillas de cierre.
    4. Pegue el token copiado como el valor de REACT_APP_TOKEN en el archivo .env.
    5. Ahora vamos a crear la aplicación ejecutando npm ci en la línea de comandos.
    6. Ahora inicie la aplicación React y ejecute npm run start en la línea de comandos.
    7. 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

  1. 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

  1. Para conectar la aplicación React a AEM as a Cloud Service, vamos a agregar algunas cosas a App.js. En la importación React, agregue useContext.

    code language-javascript
    import React, {useContext} from 'react';
    

    Importar AppContext desde el archivo context.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;
    
  2. 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 encabezado

    Agregar 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ón React.

    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 variable context de AppContext.

    code language-javascript
    const Home = () => {
    const context = useContext(AppContext);
    ...
    }
    
  3. 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 variable context.

    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.
  4. AEM Cree el estado React que expone el contenido proveniente del SDK sin encabezado de.

    code language-javascript
    const Home = () => {
    const [content, setContent] = useState({});
    ...
    }
    
  5. 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 que useEffect dependa de la variable context 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]);
    
  6. 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

    Herramientas de desarrollo de Chrome

    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

  1. 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.

  2. 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

recommendation-more-help
e25b6834-e87f-4ff3-ba56-4cd16cdfdec4