Commerce Services Connector
Certaines fonctionnalités Adobe Commerce et Magento Open Source sont optimisées par Commerce Services et déployées en tant que SaaS (logiciel en tant que service). Pour utiliser ces services, vous devez connecter votre instance Commerce à l’aide des clés d’API de production et d’environnement de test, et spécifier l’espace de données dans la configuration. Il vous suffit de configurer la connexion une seule fois pour chaque instance.
Services disponibles availableservices
La liste suivante répertorie les fonctionnalités Commerce auxquelles vous pouvez accéder par l’intermédiaire de Commerce Services Connector :
Architecture
À un niveau élevé, le Commerce Services Connector est constitué des éléments principaux suivants :
Les sections suivantes abordent plus en détail chacun de ces éléments.
Informations d’identification apikey
Les clés d’API de production et d’environnement de test sont générées à partir du compte Commerce du propriétaire de licence. Le compte Commerce est identifié par un Commerce ID unique (MageID). Le propriétaire de la licence de l’organisation du commerçant peut générer des clés d’API pour des services tels que Recommendations de produit ou Live Search, à condition que le compte soit en règle.
Les clés peuvent être partagées "au besoin" avec l’intégrateur système ou l’équipe de développement qui gère les projets et environnements pour le compte du détenteur de la licence. Les développeurs qui ont reçu Shared Access par le propriétaire de la licence ne peuvent pas générer les clés en leur nom, même si l’organisation du commerçant est présente dans la liste déroulante Switch Accounts de leur compte.
De plus, les intégrateurs de solution sont également autorisés à utiliser Commerce Services. Si vous êtes un intégrateur de solution, le signataire du contrat de partenaire Commerce doit générer les clés d’API.
Génération des clés d’API de production et d’environnement de test genapikey
-
Connectez-vous à votre compte Commerce à l’adresse https://account.magento.com.
-
Sous l’onglet Magento, sélectionnez Portail API sur la barre latérale.
-
Dans le menu Environnement, sélectionnez Production ou Sandbox.
-
Saisissez un nom dans la section Clés API, puis cliquez sur Ajouter nouveau pour ouvrir la boîte de dialogue de téléchargement de la nouvelle clé.
note warning WARNING Cette boîte de dialogue vous offre la seule opportunité de copier ou télécharger vos clés. -
Cliquez sur Télécharger puis sur Annuler.
-
Répétez les étapes ci-dessus pour chaque environnement (production et environnement de test).
La section Clés API affiche désormais vos clés API (publiques). Vous avez besoin des quatre clés (à la fois les clés de production et d’environnement de test, Public+Privé) lorsque vous sélectionnez ou créez un projet SaaS dans l’un des environnements/installations associés à la licence.
Configuration SaaS saasenv
Les instances Commerce doivent être configurées avec un projet SaaS et un espace de données SaaS afin que Commerce Services puisse envoyer des données vers le bon emplacement. Un projet SaaS regroupe tous les espaces de données SaaS. Les espaces de données SaaS sont utilisés pour collecter et stocker des données qui permettent à Commerce Services de fonctionner. Certaines de ces données peuvent être exportées à partir de l’instance Commerce et d’autres peuvent être collectées à partir du comportement d’achat sur le storefront. Ces données sont ensuite conservées pour sécuriser l’espace de stockage dans le cloud.
Pour Product Recommendations, l’espace de données SaaS contient des données de catalogue et de comportement. Vous pouvez pointer une instance Commerce vers un espace de données SaaS en la sélectionnant dans la configuration Commerce.
Si cela se produit, envoyez une demande d’assistance pour demander le nettoyage des données.
Approvisionnement de l’espace de données SaaS
Tous les marchands Adobe Commerce peuvent accéder à un espace de données de production et à deux espaces de données de test par projet SaaS.
Vous pouvez utiliser les espaces de données de test dans n’importe quel environnement hors production tant que vous n’utilisez pas le même espace de données dans plusieurs environnements en même temps. Pour utiliser l’espace de données de test dans un autre environnement, effectuez un nettoyage des données avant de sélectionner et de configurer l’espace de données dans cet environnement.
Pour les projets Adobe Commerce Cloud Pro comportant plusieurs environnements d’évaluation, vous pouvez demander des espaces de données de test supplémentaires pour chaque environnement d’évaluation en envoyant une demande d’assistance. Toutefois, si vous ne disposez que d’un seul environnement d’évaluation et que vous avez besoin d’espaces de données de test supplémentaires, vous disposez des options suivantes :
- Contactez l’équipe de succès client ou votre responsable du succès client désigné pour demander un environnement d’évaluation supplémentaire. Il y a un coût supplémentaire en jeu.
- Envoyez une demande d’assistance pour un espace de données de test supplémentaire et indiquez la justification commerciale de l’espace de données supplémentaire. Cette demande est soumise à validation.
Sélection ou création d’un projet SaaS createsaasenv
Pour sélectionner ou créer un projet SaaS, demandez la clé d’API Commerce au propriétaire de licence Commerce pour votre magasin :
-
Dans la barre latérale Admin, accédez à Système > Services > Connecteur de services Commerce.
Si vous ne voyez pas la section Commerce Services Connector dans la configuration Commerce, installez les modules Commerce correspondant au Commerce service souhaité. Vérifiez également que le package
magento/module-services-idest installé. -
Dans les sections Sandbox API Keys et Production API Keys , collez vos valeurs clés.
- Les clés privées doivent inclure
----BEGIN PRIVATE KEY---au début de la clé et----END PRIVATE KEY----à la fin de la clé. - Si vous ne disposez pas d’une copie des clés réelles, demandez-leur au propriétaire du compte, puis branchez les valeurs dans la configuration.
note warning WARNING Si vous ajoutez des valeurs de clé en interrogeant une sauvegarde ou un instantané de la base de données et en collant les valeurs dans la configuration, une couche supplémentaire de cryptage est appliquée et les clés ne fonctionneront pas. - Les clés privées doivent inclure
-
Cliquez sur Enregistrer.
Tous les projets SaaS associés à vos clés apparaissent dans le champ Projet de la section Identifiant SaaS .
-
S’il n’existe aucun projet SaaS, cliquez sur Créer un projet. Ensuite, dans le champ Projet , saisissez un nom pour votre projet SaaS.
-
Sélectionnez l’ espace de données à utiliser pour la configuration actuelle de votre magasin Commerce.
Pour modifier les noms de votre projet SaaS ou de votre espace de données, cliquez sur Renommer en regard de l’un ou l’autre. La modification du nom n’affecte pas votre service, car il s’agit uniquement d’un libellé qui vous permet d’identifier et de différencier les projets et les espaces de données.
Organisation IMS (facultatif) organizationid
Pour connecter votre instance Adobe Commerce à Adobe Experience Platform, connectez-vous à votre compte Adobe à l’aide de votre Adobe ID. Une fois connecté, l’organisation IMS associée à votre compte d’Adobe s’affiche dans cette section.
Exportation des données SaaS
Lorsque votre instance Commerce se connecte correctement à Commerce Services, le processus d’exportation des données SaaS exporte les données Commerce de votre serveur Commerce vers Commerce SaaS Services afin qu’elles puissent être synchronisées avec les services Commerce connectés. Dans l’administrateur, vous pouvez vérifier l’état de synchronisation à l’aide du tableau de bord de Data Management. Pour plus d’informations, consultez le Guide d’exportation des données SaaS.