Commerce Services Connector
Algunas características de Adobe Commerce y Magento Open Source utilizan Commerce Services y se implementan como SaaS (software como servicio). Para utilizar estos servicios, debe conectar su instancia de Commerce mediante las claves de API de producción y de zona protegida, y especificar el espacio de datos en la configuración. Solo es necesario configurar la conexión una vez para cada instancia.
Servicios disponibles availableservices
A continuación se enumeran las características de Commerce a las que puede tener acceso a través de Commerce Services Connector:
Arquitectura
En un nivel superior, Commerce Services Connector se compone de los siguientes elementos principales:
En las secciones siguientes se analiza cada uno de estos elementos con más detalle.
Credenciales apikey
Las claves API de producción y de zona protegida se generan a partir de la cuenta Commerce del propietario de la licencia. La cuenta de Commerce está identificada por un ID único de Commerce (MageID). El propietario de la licencia de la organización del comerciante puede generar claves de API para servicios como Product Recommendations o Live Search, siempre y cuando la cuenta esté al día.
Las claves se pueden compartir según sea necesario con el integrador de sistemas o el equipo de desarrollo que gestiona los proyectos y entornos en nombre del titular de la licencia. Los desarrolladores a los que el propietario de la licencia ha concedido Shared Access no pueden generar las claves en su nombre aunque la organización del comerciante esté presente en el menú desplegable Switch Accounts de su cuenta.
Además, los integradores de soluciones también tienen derecho a utilizar Commerce Services. Si usted es un integrador de soluciones, el firmante del contrato del socio Commerce debe generar las claves de API.
Generar las claves API de producción y de zona protegida genapikey
-
Inicie sesión en su cuenta de Commerce en https://account.magento.com.
-
En la ficha Magento, seleccione Portal de API en la barra lateral.
-
En el menú Entorno, seleccione Producción o Espacio aislado.
note note NOTE Production y Sandbox hacen referencia a los entornos de espacio de datos donde los datos se almacenan en sistemas back-end SaaS de Adobe. No se refiere a entornos comerciales en los que vaya a utilizar las claves. -
Escriba un nombre en la sección Claves de API y haga clic en Agregar nueva para abrir el cuadro de diálogo y descargar la clave nueva.
note warning WARNING Este cuadro de diálogo proporciona la única oportunidad que tiene para copiar o descargar las claves. -
Haz clic en Descargar y luego en Cancelar.
-
Repita los pasos anteriores para cada entorno (producción y zona protegida).
La sección Claves de API ahora muestra sus claves de API (públicas). Necesita las cuatro claves (tanto la de producción como la de zona protegida, Pública+Privada) al seleccionar o crear un proyecto SaaS en cualquiera de los entornos o instalaciones asociados con la licencia.
Configuración de SaaS saasenv
Las instancias de Commerce deben configurarse con un proyecto SaaS y un espacio de datos SaaS para que Commerce Services pueda enviar datos a la ubicación correcta. Un proyecto SaaS agrupa todos los espacios de datos SaaS. Los espacios de datos SaaS se utilizan para recopilar y almacenar datos que permiten que Commerce Services funcione. Algunos de estos datos pueden exportarse desde la instancia Commerce y otros pueden recopilarse a partir del comportamiento del comprador en la tienda. Estos datos se conservan para proteger el almacenamiento en la nube.
Para Product Recommendations, el espacio de datos de SaaS contiene datos de catálogo y de comportamiento. Puede apuntar una instancia de Commerce a un espacio de datos SaaS seleccionándola en la configuración de Commerce.
Si esto sucede, envíe una solicitud de soporte técnico para solicitar la limpieza de datos.
Aprovisionamiento de espacio de datos SaaS
Todos los comerciantes de Adobe Commerce pueden acceder a un espacio de datos de producción y a dos espacios de datos de prueba por proyecto de SaaS.
Puede utilizar los espacios de datos de prueba en cualquier entorno que no sea de producción, siempre que no utilice el mismo espacio de datos en varios entornos al mismo tiempo. Para utilizar el espacio de datos de prueba en un entorno diferente, realice una limpieza de datos antes de seleccionar y configurar el espacio de datos en ese entorno.
Para los proyectos de Adobe Commerce Cloud Pro con varios entornos de ensayo, puede solicitar espacios de datos de prueba adicionales para cada entorno de ensayo enviando una solicitud de asistencia. Sin embargo, si solo tiene un entorno de ensayo y necesita espacios de datos de prueba adicionales, tiene las siguientes opciones:
- Póngase en contacto con el equipo de éxito del cliente o con el administrador de éxito del cliente designado para solicitar un entorno de ensayo adicional.
- Envíe una solicitud de soporte técnico para solicitar el espacio de datos de prueba adicional e indicar la justificación comercial del espacio de datos adicional. Esta solicitud está sujeta a aprobación.
Los clientes de Magento Open Source que utilicen Adobe Payment Services también pueden solicitar un espacio de datos adicional. Póngase en contacto con el equipo de pagos para obtener la aprobación previa de los espacios de datos adicionales antes de enviar una solicitud de soporte para solicitar el espacio de datos de prueba.
Los clientes que sean propietarios de varios proyectos en la nube o instalaciones locales (activas/de producción) también pueden solicitar espacios de datos de producción y prueba adicionales para cada proyecto o instancia enviando una solicitud de soporte.
Seleccionar o crear un proyecto SaaS createsaasenv
Para seleccionar o crear un proyecto SaaS, solicite la clave de API Commerce al propietario de la licencia Commerce de su tienda:
-
En la barra lateral Admin, vaya a Sistema > Servicios > Conector de servicios de Commerce.
Si no ve la sección Commerce Services Connector en la configuración de Commerce, instale los módulos de Commerce para el Commerce servicio que desee. Además, asegúrese de que el paquete
magento/module-services-idestá instalado. -
En las secciones Sandbox API Keys y_Production API Keys_, pegue los valores de clave.
- Las claves privadas deben incluir
----BEGIN PRIVATE KEY---al principio de la clave y----END PRIVATE KEY----al final de la clave. - Si no dispone de una copia de las claves reales, solicítelas al propietario de la cuenta y, a continuación, introduzca los valores en la configuración.
note warning WARNING Si agrega valores de clave consultando una copia de seguridad o instantánea de base de datos y pegando los valores en la configuración, se aplica una capa adicional de cifrado y las claves no funcionan. - Las claves privadas deben incluir
-
Haga clic en Guardar.
Cualquier proyecto SaaS asociado con sus claves aparecerá en el campo Proyecto de la sección Identificador SaaS.
- Si no existen proyectos SaaS, haga clic en Crear proyecto. A continuación, en el campo Proyecto, escriba un nombre para su proyecto SaaS.
- Seleccione el espacio de datos que se usará para la configuración actual de su almacén de Commerce.
Para cambiar los nombres de tu proyecto SaaS o espacio de datos, haz clic en Cambiar nombre junto a uno de ellos. Cambiar el nombre no afecta al servicio porque el nombre es sólo una etiqueta para ayudarle a identificar y diferenciar entre proyectos y espacios de datos.
Organización de IMS (opcional) organizationid
Para conectar la instancia de Adobe Commerce a Adobe Experience Platform, inicie sesión en la cuenta de Adobe con el Adobe ID. Después de iniciar sesión, la organización de IMS asociada a su cuenta de Adobe se muestra en esta sección.
Exportación de datos SaaS
Cuando la instancia de Commerce se conecta correctamente a Commerce Services, el proceso de exportación de datos de SaaS exporta los datos de Commerce del servidor Commerce a Commerce SaaS Services para que se puedan sincronizar con los servicios de Commerce conectados. En el Administrador, puede comprobar el estado de sincronización mediante el panel de administración de datos. Para obtener más información, consulte la Guía de exportación de datos SaaS.