Activation de l'intégration de Sterling Omni-Configurator avec HCL Commerce

Activez l'intégration de Sterling Omni-Configurator avec HCL Commerce en configurant Visual Modeler, Omni-Configurator et HCL Commerce.

Avant de commencer

  1. Vérifiez que les conditions requises suivantes du système sont remplies :
    • Votre serveur Sterling Configurator exécute JDK 1.8.
    • Votre serveur Sterling CPQ 9.5 utilise le groupe de correctifs 7 (ou ultérieur).
  2. Si vous utilisez un modèle de magasin B2B, vous devez installer HCL Commerce 9.0.0.7 (ou une version supérieure).
  3. Téléchargez et installez Sterling Visual Modeler.
  4. Déployez Sterling Omni-Configurator.

    Pour vérifier que votre Omni-Configurator est correctement déployé, accédez à n'importe quelle URL de service REST de base Omni-Configurator. Par exemple, https://configuratorServer:port/configurator/api/organization/matrix/models?language=en&country=US.

Procédure

Configurez Sterling Visual Modeler.
  1. Créez une vitrine à l'aide de l'outil Sterling Configurator Visual Modeler.
    Notes :
    • Assurez-vous que les informations correctes sur le produit sont utilisées pour définir les modèles dans Sterling Configurator Visual Modeler en créant une vitrine avec le même ID d'habillage que le Code d'organisation de l'organisation de catalogue.
    • Lorsque vous créez une vitrine, vous devez définir l'ID de partenaire externe.
  2. Configurez Sterling Visual Modeler pour se connecter à Omni-Configurator.

    Pour afficher et tester vos modèles compilés, vous devez connecter le backend Omni-Configurator (API REST) et l'interface utilisateur de Configurator à Sterling Configurator Visual Modeler.

    1. Ouvrez la console d'administration du système Sterling Configurator Visual Modeler en accédant à l'URL suivante : 
      http://hostname:port/Sterling/en/US/enterpriseMgr/admin
    2. Connectez-vous en tant qu'utilisateur disposant des droits d'administrateur.
    3. Depuis la page Fulfillment, cliquez sur Services système > Sterling Fulfillment, puis renseignez les zones suivantes :
      Zone Description
      URL du système IBM Configurator http://hostname:port/configurator
      URL de l'interface utilisateur d'IBM Configurator Ce chemin d'accès à l'URL dépend de la façon dont le module complémentaire d'interface utilisateur de Configurator est déployé.
      • S'il est déployé en tant qu'application Web indépendante, l'URL est la suivante : http://hostname:port/context_root/index.html#
      • S'il est déployé dans une application Web existante, l'URL est la suivante : http://hostname:port/context_root/path_to_the_Configurator_UI_folder/index.html#
      Remarque : Si l'API REST Omni-Configurator (configurator.war) et le module complémentaire d'interface utilisateur de Configurator sont déployés sur différentes machines, alors dans ce scénario, vous devez configurer l'URL du système de Configurator dans le fichier index.html présent dans le répertoire d'interface utilisateur de Configurator. Si vous n'effectuez pas cette configuration, l'exemple d'interface utilisateur de Configurator n'est pas lancé à partir de l'application Sterling Configurator Visual Modeler.
    4. Cliquez sur Enregistrer tout.
Configurez Omni-Configurator.
  1. Configurez les propriétés de l'adaptateur Omni-Configurator spécifiques au locataire.

    Vous pouvez définir les communications entre Omni-Configurator et HCL Commerce en configurant les propriétés de l'adaptateur Omni-Configurator.

    1. Créez un fichier tenant_id.properties dans le répertoire tenant_repository/tenant_id.

      Où

      tenant_id
      Fait référence à l'ID de partenaire externe défini dans Sterling Configurator Visual Modeler lorsque vous avez créé votre vitrine.
    2. Configurez les propriétés de l'adaptateur Omni-Configurator spécifiques au locataire.
      Pour vous connecter à HCL Commerce, par exemple, si le tenant_id est matrice, vous devez définir toutes les propriétés du catalogue et de l'adaptateur de tarification dans le fichier tenant_repository/matrix/matrix.properties. L'exemple de code suivant affiche le fichier de propriétés pour le locataire matrix :
      //For catalog adapter
cnfg.matrix.catalog.adapter.impl=com.ibm.commerce.omniconfigurator.catalog.adapter.impl.WCCatalogAdapter
cnfg.matrix.catalog.provider.url=https://[wc-transaction-server-cmc:port]/lobtools/cmc/VisualModeler
1cnfg.matrix.catalog.provider.username=[adminuser]
cnfg.matrix.catalog.provider.password=[adminpassword]
cnfg.matrix.catalog.provider.orgcode=matrix
cnfg.matrix.catalog.entitlement.provider.url=https://[wcssearch-server:port]
      
//For Pricing adapter
cnfg.matrix.pricing.adapter.impl=com.ibm.commerce.omniconfigurator.pricing.adapter.impl.WCPricingAdapter
cnfg.matrix.pricing.provider.resturl=https://[wc-transaction-server:port]
      //Misc Properties
cnfg.matrix..wcs.storeid = [the catalog storeId mapped to this tenant]
cnfg.matrix..validation.customer.enabled=true
cnfg.matrix..validation.allowguestcustomer.enabled=true
cnfg.matrix..validation.currency.enabled=true
cnfg.matrix..priceandentitlement.cache.additional.param.name=WC_USERACTIVITY,storeId,
  contractId,currency,identityId,identitySignature
      • 1 Créez un utilisateur administrateur dans HCL Commerce; par exemple, sterlingAdmin. Pour plus d'informations sur la création d'utilisateurs HCL Commerce, voir Création d'un utilisateur. Lorsque vous sélectionnez un rôle pour l'utilisateur, ajoutez l'autorité Administrateur de site pour l'organisation racine.
  2. Déployez le fichier JAR d'adaptateur et le fichier JAR de dépendance.
    1. Accédez au répertoire suivant dans votre environnement de développeur HCL Commerce.
      WCDE_installdir\samples\integration\OmniConfigurator
    2. Copiez OmniConfigurator-WCAdapter.jar et jersey-client-1.19.1.jar dans le répertoire suivant sur votre serveur Omni-Configurator.
      tenant_repository/tenant_id
  3. Importez le certificat depuis HCL Commerce.
    1. Connectez-vous à WebSphere Application Server Administrative Console. 
       https://hostname:port/ibm/console
    2. Accédez à gestion des clés et certificats SSL > Certificats et magasins de clés > NodeDefaultTrustStore > Certificats signataires > Récupérer depuis le port.
    3. Renseignez les zones ci-dessous.
      Zone Description
      Hôte Nom d'hôte de votre serveur de transactions HCL Commerce.
      Port Numéro de port de votre serveur de transactions HCL Commerce.
      Configuration SSL de connexion sortante Sélectionnez NodeDefaultSSLSettings
      Alias Alias de votre serveur de transactions HCL Commerce.
    4. Cliquez sur Récupérer les informations du signataire, puis sur Appliquer.
    5. Redémarrez votre serveur Omni-Configurator.
Configurez HCL Commerce.
  1. Activez le transport Sterling à partir de HCL Commerce Administration Console.
    1. Ouvrez le Administration Console.
    2. Sélectionnez Configurer > Transport.
    3. Configurez le transport Sterling en complétant les zones suivantes.
      Zone Description
      Code d'organisation Sterling ID de locataire trouvé dans Omni-Configurator.
      URL de l'API IBM Configurator https://configuratorServer:port/configurator/api
      Nom d'utilisateur Visual Modeler Votre nom d'utilisateur Visual Modeler.
      Mot de passe Visual Modeler Votre mot de passe d'utilisateur Visual Modeler.
      URL Visual Modeler URL d'habillage de vitrine Visual Modeler.
  2. Configurez l'URL du serveur Omni-Configurator dans votre table de base de données STORECONF en exécutant l'instruction SQL suivante.
    insert into storeconf values ($storeId,'wc.configurator.url'$configuratorServerURL,1);
    Où
    storeId
    Votre ID de magasin. Si votre magasin se trouve au niveau du site, utilisez une valeur 0.
    configuratorServerURL
    URL du serveur Omni-Configurator ; par exemple :

    https://configuratorServer:port/configurator

  3. Activez la fonction de magasin Sterling Configurator dans le Centre de gestion HCL Commerce.
    1. Connectez-vous à Management Center for HCL Commerce et ouvrez l'outil Gestion de magasin.
    2. Sélectionnez votre magasin ; par exemple, AuroraESite. Cliquez ensuite sur l'onglet Catalogue.
    3. Cochez la caseSterling Configurator.
  4. Importez le certificat Omni-Configurator vers HCL Commerce.
    • Pour les environnements de développement :
      1. Connectez-vous au WebSphere Application Server Administrative Console sur votre environnement de développement.
      2. Accédez à gestion des clés et certificats SSL > Certificats et magasins de clés > NodeDefaultTrustStore > Certificats signataires > Récupérer depuis le port.
      3. Renseignez les zones ci-dessous.
        Zone Description
        Hôte Nom d'hôte de votre serveur Configurator.
        Port Numéro de port de votre serveur Configurator.
        Configuration SSL de connexion sortante Sélectionnez NodeDefaultSSLSettings
        Alias Alias de votre serveur Configurator.
      4. Cliquez sur Récupérer les informations du signataire, puis sur Appliquer.
    • Pour les environnements de production :
      1. Exportez le certificat Omni-Configurator.
        1. Connectez-vous à la console d'administration de Sterling Configurator sur votre environnement d'exécution.
        2. Accédez à Certificat SSL et gestion des clés > Fichiers de clés et certificats > NodeDefaultKeyStore > Certificats personnels > Extraction de certificat.
        3. Renseignez les zones ci-dessous.
          Zone Description
          Alias de certificat à extraire Alias du certificat.
          Nom de fichier du certificat Nom de fichier du certificat.
          Type de données Votre type de données, par exemple, données ASCII codées par Base64.
        4. Cliquez sur Appliquer.
      2. Importer la certification extraite sur le serveur de transactions HCL Commerce de l'une des deux façons suivantes :
        • Gestion manuelle des certificats.
          Notes :
          • Lorsque vous copiez les certificats dans le fichier JSON, vous devez remplacer le retour à la ligne avec \n pour vous assurer que la chaîne de certificat entière se trouve sur une seule ligne.
          • Cette intégration avec Omni-Configuration utilise la validation de certificat SSL à sens unique. Pour la validation de certificat SSL unidirectionnel, lorsqu'une application a besoin d'un certificat pour communiquer avec une autre application activée par SSL, vous n'avez qu'à définir issuing_ca dans le fichier JSON.
          • Chargez les fichiers JSON dans le répertoire /SETUP/certs/custom/ de votre conteneur Docker.
        • Gérer les certificats avec Vault.

Que faire ensuite