Introducción a AEM Commerce as a Cloud Service

Última actualización: 2023-12-05

Para empezar a usar Adobe Experience Manager AEM () Commerce as a Cloud Service, el Experience Manager Cloud Service debe estar aprovisionado con el complemento Commerce integration framework CIF (). CIF El complemento de es un módulo adicional sobre AEM Sites as a Cloud Service.

Incorporación

La incorporación de AEM Commerce as a Cloud Service es un proceso de dos pasos:

  1. Obtenga AEM Commerce as a Cloud Service habilitado y el complemento CIF aprovisionado.
  2. AEM Conectar el comercio de la as a Cloud Service con su solución de comercio

El primer paso de incorporación se realiza por Adobe. Para obtener más información sobre precios y aprovisionamiento, debe ponerse en contacto con su representante de ventas.

CIF Una vez que se le haya proporcionado el complemento de, se aplicará a cualquier programa existente de Cloud Manager. Si no tiene un programa de Cloud Manager, debe crearlo. Para obtener más información, consulte Configurar el programa.

El segundo paso es el autoservicio para cada entorno de AEM as a Cloud Service. CIF Hay algunas configuraciones adicionales que debe realizar después del aprovisionamiento inicial del complemento de.

AEM Conectarse a los clientes con una solución de comercio

CIF Para conectar el complemento de y AEM Componentes principales de CIF con una solución de comercio, debe proporcionar la URL del extremo de GraphQL mediante una variable de entorno de Cloud Manager. El nombre de la variable es COMMERCE_ENDPOINT. Se debe configurar una conexión segura mediante HTTPS.

Esta variable de entorno se utiliza en dos lugares:

  • Llamadas de GraphQL AEM AEM CIF desde el servidor de comercio a través de un cliente de GraphQl que se puede compartir de forma habitual y que utilizan los componentes principales de los clientes y los componentes de proyecto del cliente de la.
  • Configure una URL de proxy de GraphQL AEM en cada entorno en el que se configure la variable y que esté disponible en /api/graphql. AEM CIF CIF Esta URL la utilizan las herramientas de creación de comercio de la (complemento de) y los componentes del lado del cliente de la.

Se puede utilizar una dirección URL de extremo de GraphQL AEM diferente para cada entorno as a Cloud Service de la. AEM AEM De este modo, los proyectos pueden conectar entornos de ensayo de la con sistemas de ensayo de comercio y entornos de producción de la segmentación con un sistema de producción de comercio. Ese extremo de GraphQL debe estar disponible para el público, no se admiten conexiones privadas VPN o locales. CIF Opcionalmente, se puede proporcionar un encabezado de autenticación para utilizar funciones de autenticación adicionales que requieran autenticación.

De forma opcional, y solo para Adobe Commerce CIF AEM Enterprise/Cloud, el complemento de admite el uso de datos de catálogo clasificados para autores de informes en la fase de creación de informes Estos datos requieren que configure un encabezado de autorización. AEM Este encabezado solo está disponible y se utiliza en instancias de Autor de por motivos de seguridad. AEM Las instancias de publicación no pueden mostrar datos clasificados.

Hay dos opciones para configurar el punto de conexión:

Mediante la interfaz de usuario de Cloud Manager (predeterminada)

Esta configuración se puede realizar mediante un cuadro de diálogo en la página Detalles del entorno. Al ver esta página para un programa habilitado para Commerce, se muestra un botón si el punto de conexión no está configurado actualmente:

Información del entorno de CM

Al hacer clic en este botón, se abre un cuadro de diálogo:

Punto final de CM Commerce

Una vez definido el punto de conexión y, opcionalmente, un encabezado de autorización para la compatibilidad con catálogos clasificados, el punto de conexión se muestra en la página de detalles. Haga clic en el icono Editar para abrir el mismo cuadro de diálogo en el que puede editar el punto de conexión, si es necesario.

Información del entorno de CM

Mediante CLI de Adobe I/O

AEM Para conectarse con una solución de comercio mediante CLI de Adobe I/O, siga estos pasos:

  1. Obtenga la CLI de Adobe I/O con el complemento Cloud Manager

    Compruebe la Documentación de Adobe Cloud Manager sobre cómo descargar, configurar y utilizar CLI DE ADOBE I/O con el Complemento CLI de Cloud Manager.

  2. Autentique la CLI de Adobe I/O AEM con el programa as a Cloud Service de la

  3. Configure la COMMERCE_ENDPOINT variable en Cloud Manager

    aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"
    

    Consulte los documentos sobre CLI para obtener más detalles.

    La dirección URL del extremo de GraphQL de comercio debe señalar al servicio GraphQl de comercio y utilizar una conexión HTTPS segura. Por ejemplo: https://<yourcommercesystem>/graphql.

  4. Habilitar las funciones de catálogo preconfigurado que requieren autenticación (opcional)

    NOTA

    Esta función solo está disponible con Adobe Commerce Enterprise o Cloud Edition. Consulte Autenticación basada en tokens para obtener más información.

    Configure las variables COMMERCE_AUTH_HEADER variable secreta en Cloud Manager:

    aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>"
    
SUGERENCIA

Puede realizar la lista de todas las variables de Cloud Manager usando el siguiente comando para comprobarlas: aio cloudmanager:list-environment-variables ENVIRONMENT_ID

AEM Está listo para usar as a Cloud Service de Commerce y puede implementar su proyecto mediante Cloud Manager.

Configuración de tiendas y catálogos

CIF El complemento y el complemento de la Componentes principales del CIF AEM se puede utilizar en varias estructuras de sitio de la conectadas a diferentes tiendas comerciales (o vistas de tiendas, etc.). CIF De forma predeterminada, el complemento de se implementa con una configuración predeterminada que se conecta a la tienda y al catálogo predeterminados de Adobe Commerce.

CIF Esta configuración se puede ajustar para el proyecto mediante la configuración del Cloud Service de la aplicación de la manera siguiente:

  1. AEM En la página de inicio, vaya a Herramientas > Cloud Service CIF > Configuración de la.

  2. Seleccione la configuración de comercio que desee cambiar.

  3. Abra las propiedades de configuración mediante la barra de acciones.

CIF Configuración de Cloud Service de

Se pueden configurar las siguientes propiedades:

  • Cliente de GraphQL: seleccione el cliente de GraphQL configurado para la comunicación back-end comercial. Este cliente debería permanecer en modo predeterminado.
  • Vista de tienda: el identificador de la vista de tienda. Si está vacía, se utiliza la vista de tienda predeterminada.
  • Ruta del proxy de GraphQL: la ruta URL del proxy de GraphQL AEM que se utiliza para las solicitudes de proxy al extremo de GraphQL backend de comercio.
    NOTA

    En la mayoría de las configuraciones, el valor predeterminado /api/graphql no se debe cambiar. Solo la configuración avanzada que no utiliza el proxy de GraphQL proporcionado debe cambiar esta configuración.

    - Habilitar compatibilidad con UID de catálogo: habilite la compatibilidad con UID en lugar de con ID en las llamadas comerciales de GraphQL back-end.
    NOTA

    La compatibilidad con UID se ha introducido en Adobe Commerce 2.4.2. Habilite los UID únicamente si el backend de Commerce admite un esquema GraphQL de la versión 2.4.2 o posterior.

    - Identificador de categoría raíz del catálogo: el identificador (UID o ID) de la raíz del catálogo de la tienda
    PRECAUCIÓN

    CIF A partir de la versión 2.0.0 de los componentes principales de, la compatibilidad con id se ha eliminado y reemplazado por uid. CIF Si el proyecto utiliza componentes principales de la versión 2.0.0 de la, debe habilitar la compatibilidad con UID de catálogo y utilizar un UID de categoría válido como "Identificador de categoría raíz de catálogo".

La configuración que se muestra arriba es como referencia. Los proyectos deben proporcionar sus propias configuraciones.

AEM Para configuraciones más complejas, el uso de varias estructuras de sitio de la combinadas con diferentes catálogos de comercio, consulte la Configuración de varias tiendas de Commerce tutorial.

Recursos adicionales

En esta página