Salesforce Commerce Cloud — Installation

Ce guide s'appuie sur la dernière version du code SFRA et sur le site de référence RefArchGlobal. Si votre configuration SFCC diffère ou si vous utilisez une configuration alternative, certaines étapes peuvent varier, mais l'approche générale d'installation reste la même.

Installation étape par étape

1. Installer les dépendances côté client et générer les assets

Cette étape est requise uniquement si vous utilisez SFRA et prévoyez d'utiliser la cartouche int_dqe_sfra. Si vous n'utilisez pas SFRA ou la cartouche int_dqe_sfra, cette étape peut être ignorée.

Pour réaliser cette étape :

1. Installez les dépendances npm en exécutant la commande suivante :

   npm install

2. Ouvrez le fichier package.json et modifiez la propriété paths.base pour qu'elle pointe vers votre répertoire SFRA local.

3. Exécutez les commandes suivantes pour compiler le JavaScript et le SCSS. Cela créera les assets côté client :

   npm run compile:js && npm run compile:scss

2. Téléverser les cartouches

Une fois les dépendances installées et les assets côté client générés, téléversez les cartouches sur votre instance SFCC.

Pour téléverser les cartouches :

• Téléversez le dossier cartridges vers l'emplacement WebDAV de votre sandbox à l'aide de CyberDuck ou de tout autre client WebDAV.
• Vous pouvez également utiliser B2C Commerce UX Studio ou l'extension Prophet Debugger pour VS Code.

Pour plus d'informations sur le téléversement des cartouches vers SFCC, consultez la documentation officielle SFCC.

3. Enregistrer la cartouche pour chaque site SFCC

Pour activer l'intégration DQE sur votre storefront, enregistrez la cartouche dans SFCC Business Manager.

Pour enregistrer la cartouche :

1. Accédez à Administration > Sites > Manage Sites dans SFCC Business Manager.
2. Cliquez sur le nom du site (Site Name) du storefront pour lequel vous souhaitez ajouter la fonctionnalité DQE.
3. Sélectionnez l'onglet Settings.

4. Ajoutez ce qui suit au Effective Cartridge Path :

   • Si vous utilisez SFRA, ajoutez :

     int_dqe_sfra:int_dqe:

   • Si vous n'utilisez pas SFRA, ajoutez uniquement :

     :int_dqe:

   Pour un chemin de site basé sur SFRA, il devrait ressembler à ceci :

   int_dqe_sfra:int_dqe:app_storefront_base

   

5. Cliquez sur Apply.
6. Répétez les étapes 2 à 5 pour chaque site storefront où DQE Engagement doit être implémenté.

Enregistrer la cartouche BM globalement dans SFCC

Pour utiliser l'extension DQE Business Manager (BM), enregistrez la cartouche BM auprès du site Business Manager.

Pour enregistrer la cartouche BM globalement :

1. Accédez à Administration > Sites > Manage Sites dans Business Manager.
2. Cliquez sur le lien Manage the Business Manager site du site où vous souhaitez enregistrer la cartouche BM.
3. Dans la section Effective Cartridge Path, ajoutez bm_dqe: à la liste des cartouches.
4. Cliquez sur Apply pour enregistrer les modifications et enregistrer la cartouche BM globalement.

Importer les métadonnées et les services dans SFCC

Pour intégrer les métadonnées DQE et les services dans votre instance Salesforce Commerce Cloud (SFCC), importez les configurations nécessaires comme décrit ci-dessous.

1. Accéder à Site Development

   Accédez à Administration > Site Development > Site Import & Export dans SFCC Business Manager.

2. Préparer les fichiers de métadonnées

   Toutes les métadonnées sont stockées dans le dossier data/site_template.

   • Le dossier data/site_template contient des exemples de mapping de codes DQE et de configurations de validation pour les sites SFRA, y compris RefArch et RefArchGlobal.
   • Si vous souhaitez changer de site, accédez à data/site_template/sites et renommez le dossier pour qu'il corresponde à l'ID de votre site.
   • Pour supprimer les configurations d'exemple, ouvrez data/site_template/sites et supprimez tous les dossiers ainsi que leur contenu.

3. Archiver le dossier de métadonnées

   Archivez le dossier data/site_template depuis le référentiel et préparez-le pour le téléversement.

4. Téléverser l'archive

   Dans la section Upload Archive de la page Site Import & Export, sélectionnez le dossier archivé data/site_template et cliquez sur Select Upload.

5. Recharger la page et sélectionner le modèle de site

   Une fois la page rechargée, sélectionnez le bouton radio site_template pour confirmer que vous importez les bonnes métadonnées.

6. Importer

   Cliquez sur Import pour importer les métadonnées et services DQE dans votre instance SFCC.

Importer les métadonnées, les services et les objets personnalisés dans SFCC

Selon votre environnement Salesforce Commerce Cloud (SFCC), vous pouvez importer séparément les métadonnées, les services et les objets personnalisés.

1. Importer les métadonnées

Les fichiers de métadonnées sont stockés dans le dossier data/site_template/meta et doivent être téléversés via Business Manager.

Étapes :

1. Accédez à BM > Administration > Site Development > Import & Export.
2. Téléversez les fichiers XML de métadonnées depuis le dossier data/site_template/meta.
3. Une fois le téléversement effectué, cliquez sur Import Meta Data pour importer les fichiers de métadonnées.

2. Importer les services

Le fichier data/site_template/services.xml contient des services pouvant être importés séparément.

Étapes :

1. Accédez à BM > Administration > Operations > Import & Export.
2. Téléversez le fichier services.xml situé dans data/site_template.
3. Une fois le téléversement effectué, cliquez sur Import Services pour importer les services.

3. Importer les objets personnalisés

Les définitions d'objets personnalisés pour chaque site se trouvent dans data/site_template/sites/[site_id]/custom-objects/[custom_object_type].xml.

Étapes :

1. Accédez à Merchant Tools > Custom Objects > Import & Export dans Business Manager.
2. Téléversez les fichiers XML des objets personnalisés situés dans data/site_template/sites/[site_id]/custom-objects/.
3. Une fois le téléversement effectué, cliquez sur Import Custom Objects pour importer les objets personnalisés.

Métadonnées de la cartouche après import

Après l'import des métadonnées, des services et des objets personnalisés, les attributs, définitions et services suivants doivent apparaître dans le système.

Définitions des objets système

• Site Preferences : groupe DQE avec ses attributs. Les attributs spécifiques sont listés dans la section de documentation correspondante.

Définitions des objets personnalisés et exemple de mapping pour les sites

• dqeAddressValidationConfigs
• dqeEmailValidationConfigs
• dqePhoneValidationConfigs

Services

• dqe.http.address.suggestions.complete
• dqe.http.address.suggestions.search
• dqe.http.address.validate
• dqe.http.email.validate
• dqe.http.phone.validate

Accorder l'accès à l'extension BM

Par défaut, l'accès aux modules DQE de Business Manager n'est accordé à aucun utilisateur BM. Pour accorder cet accès, suivez les étapes ci-dessous :

1. Accédez à Administration > Organization > Roles dans SFCC Business Manager.
2. Sélectionnez le rôle utilisateur auquel vous souhaitez accorder l'accès.
3. Accédez à l'onglet Business Manager Modules.
4. Sélectionnez le Sites Context et sélectionnez tous les sites ou uniquement les sites souhaités.
5. Cochez les modules de la section DQE.
6. Cliquez sur Update pour enregistrer les modifications.