Configuration du HCL Commerce Developer Tooling environment

HCL Commerce fournit un kit de développement logiciel (SDK) HCL Commerce Developer Tooling environment autonome.

Before you begin

Le HCL Commerce Developer Tooling environment nécessite les conditions préalables suivantes avant que vous ne puissiez l'utiliser pour développer vos personnalisations d'outils :
  • Avant d'installer HCL Commerce Developer, assurez-vous que HCL Commerce development environment répond aux configurations matérielles et logicielles requises.
  • Vous devez avoir accès à un HCL Commerce Version 9.1Transaction server en cours d'exécution.

    Il peut être issu d'un environnement de développement ou de production.

    La configuration par défaut du proxy du SDK Tooling s'attend à ce que ce serveur s'exécute sur localhost. Si votre Transaction server n'est pas en cours d'exécution sur votre ordinateur local, modifiez le fichier commerce-tooling/proxy.conf.json (pour HCL Commerce 9.1.0.0 et 9.1.1.0) ou le fichier de configuration du proxy HCL Commerce Version 9.1.2.0 or latercommerce-tooling/proxy.conf.js de manière à spécifier l'emplacement du Transaction server.

  • Vous avez accès à Management Center for HCL Commerce.

    L'ID utilisateur et le mot de passe par défaut pour la version de l'environnement de développement Management Center est wcsadmin:wcs1admin.

  • Vous devez avoir Node.js installé. Node.js inclut l'utilitaire Node Package Manager (npm).
    HCL Commerce Version 9.1.14.0 or laterLa version de nœud prise en charge est v18-lts (inclut npm9.6.X).
    Note: Avant HCL Commerce 9.1.14.0, le SDK Tooling nécessitait Node v14-lts.

    Pour installer Node.js, rendez-vous sur https://nodejs.org/en/download/.

Procedure

  1. Obtenez le kit de développement d'outils HCL Commerce Developer Tooling environment.
    1. Examinez Obtention du logiciel HCL Commerce Developer et consultez la liste des derniers packages de téléchargement disponibles pour vous assurer que vous obtenez la version la plus récente du logiciel HCL Commerce.
    2. Téléchargez et extrayez la dernière version du SDK d'outils pour obtenir le groupement Git HCL_Commerce_Tooling_9.1.x.x.bundle.
  2. Clonez le projet dans Git à partir du groupement Git téléchargé.
    Exécutez la commande suivante :
    git clone bundleNameprojectName
    Où :
    bundleName
    Nom de fichier du groupement que vous clonez.
    projectName
    Nom du projet git que vous créez.
    Par exemple :
    git clone HCL_Commerce_Tooling_9.1.0.0.bundleHCL_Commerce_Tooling
  3. Utilisez Node Package Manage (NPM) pour installer le serveur de nœuds du SDK d'outils.
    1. Accédez au répertoire HCL_Commerce_Tooling\commerce-tooling.
    2. Exécutez la commande d'installation npm.
      npm install
      LinuxNote: Si vous rencontrez une erreur de certificat, définissez la configuration strict-ssl NPM sur false. Par exemple, exécutez npm config set strict-ssl false.
  4. Démarrez le serveur de développement d'outils.
    Dans le même répertoire, exécutez la commande :
    npm start
  5. HCL Commerce Version 9.1.9.0 or later Si vous effectuez une mise à niveau à partir d'une version précédente du SDK Tooling, mettez à jour le fichier proxy.conf.json (pour HCL Commerce 9.1.0.0 et 9.1.1.0) ou le fichier de configuration du proxy HCL Commerce Version 9.1.2.0 or laterproxy.conf.js.
    • Pointez sur l'adresse IP ou le nom d'hôte de l'environnement de données de recherche pour les ressources de recherche.
      Par exemple :
      "/search/resources/api/v2/categories": { "target": "https://localhost:30921", "secure": false, "changeOrigin": true }
    • Mettez à jour les URL localhost du magasin vers HTTPS et spécifiez le port correct pour afficher correctement les images dans les résultats de recherche simulés dans Management Center for HCL Commerce.
      Par exemple :
       "/hclstore": { "target": "https://localhost:6443", "secure": false, "changeOrigin": true }
      Note: Le serveur du kit SDK du magasin React doit être en cours d'exécution pour afficher des résultats de recherche simulés dans l'outil de recherche Management Center.
  6. Utilisez l'hôte local. Pour utiliser localhost:7443, vous devez exécuter la commande suivante pour configurer d'abord le navigateur :
    https://localhost:7443/lobtools/cmc/Configure?featureName=localAdminConsole&featureEnabled=true
  7. Lancez Management Center for HCL Commerce pour vérifier que votre installation a réussi.

    Dans un navigateur, accédez à https://localhost:7443/lobtools/cmc/ManagementCenter pour lancer Management Center.

Results

Vous pouvez maintenant prévisualiser les outils fournis par cette application à page unique (SPA) à travers le menu Hamburger des outils Management Center. Par exemple, sélectionnez Gestion des utilisateurs pour ouvrir l'outil Gestion des utilisateurs. Le SPA est chargé dans un iFrame et acheminé vers l'outil sélectionné.

What to do next

Assurez-vous de vérifier le code dans votre système de gestion du contrôle source afin de permettre la collaboration sur votre travail et pour qu'il soit conservé en toute sécurité.