Accueil
Documentation
HCL Commerce est une plateforme de commerce électronique haute disponibilité, hautement évolutive et personnalisable. Capable de prendre en charge des centaines de milliers de transactions par jour, HCL Commerce vous permet de faire des affaires avec les consommateurs (B2C) ou directement avec les entreprises (B2B). HCL Commerce utilise une technologie conviviale pour faciliter et rendre le déploiement et le fonctionnement à la fois faciles et efficaces. Il fournit des outils faciles à utiliser permettant aux professionnels de créer et gérer des campagnes marketing de précision, des promotions, des catalogues et du marchandisage sur tous les canaux de vente, Les professionnels peuvent créer et gérer des campagnes de marketing de précision, des promotions, des catalogues et du merchandising à travers tous les canaux de distribution. Les professionnels peuvent également utiliser des fonctionnalités de gestion de contenu activées par intelligence artificielle (IA).
Personnalisation
Les rubriques de la section Personnalisation décrivent les tâches réalisées par un développeur d'applications pour personnaliser HCL Commerce.
Web services
Utilisation des services HCL Commerce SOI
Travailler avec des services HCL Commerce implique le développement de bibliothèques client, de nouvelles commandes et de la logique métier. JET (Java Emitter Template) est documenté pour vous aider dans ces tâches.
Schémas de conception
Pour comprendre l'architecture des services HCL Commerce, ainsi que la personnalisation, il existe deux patterns de conception importants : Le pattern de conception pour l'implémentation des services Get et le pattern de conception pour l'implémentation des services Process, Change et Sync.
Pattern de conception pour l'implémentation des services Process, Change et Sync (SOI)
HCL Commerce contient de nombreuses commandes de contrôleur qui peuvent être exposées en tant que services. La commande BOD Process et Change n'est qu'une commande qui convertit la requête BOD existante en un ensemble de paires valeur-nom et qui délègue à une commande de contrôleur HCL Commerce existante. Toutefois, la fonctionnalité de mappage de messages existante d'HCL Commerce fournit cette fonctionnalité et aborde déjà certains des aspects supplémentaires de personnalisation de l'extension du nom et l'ajout de plus d'informations. Vous devez personnaliser uniquement la commande de contrôleur là où les paires nom-valeur existent. Vous n'avez pas besoin d'écrire un nouveau code pour lire la requête BOD.

Documentation
HCL Commerce est une plateforme de commerce électronique haute disponibilité, hautement évolutive et personnalisable. Capable de prendre en charge des centaines de milliers de transactions par jour, HCL Commerce vous permet de faire des affaires avec les consommateurs (B2C) ou directement avec les entreprises (B2B). HCL Commerce utilise une technologie conviviale pour faciliter et rendre le déploiement et le fonctionnement à la fois faciles et efficaces. Il fournit des outils faciles à utiliser permettant aux professionnels de créer et gérer des campagnes marketing de précision, des promotions, des catalogues et du marchandisage sur tous les canaux de vente, Les professionnels peuvent créer et gérer des campagnes de marketing de précision, des promotions, des catalogues et du merchandising à travers tous les canaux de distribution. Les professionnels peuvent également utiliser des fonctionnalités de gestion de contenu activées par intelligence artificielle (IA).
- Mise en route
  HCL Commerce possède différents avantages pour les utilisateurs professionnels, les administrateurs et les développeurs. HCL Commerce cible chacun de ces rôles avec un ensemble personnalisé d'offres, afin que chaque utilisateur puisse en tirer le meilleur parti.
- Installation et déploiement
  Découvrez comment installer et déployer des environnements de production HCL Commerce development environment et HCL Commerce.
- Migration
  Avant d'effectuer une migration vers HCL Commerce Version 9.1, consultez les informations ci-après pour vous aider à planifier et exécuter votre migration.
- Exploitation
  Les sujets de la catégorie Exploitation mettent en évidence les tâches généralement effectuées par les utilisateurs professionnels et les représentants du support client pour effectuer leurs tâches quotidiennes dans le cadre de l'exploitation du site HCL Commerce.
- Intégration
  Les rubriques de la catégorie Intégration mettent en évidence les tâches couramment effectuées pour l'utilisation de HCL Commerce en association avec d'autres produits.
- Administration
  Les rubriques de la catégorie Administration traitent des tâches généralement effectuées par l'administrateur de site pour prendre en charge les opérations quotidiennes du site HCL Commerce.
- Personnalisation
  Les rubriques de la section Personnalisation décrivent les tâches réalisées par un développeur d'applications pour personnaliser HCL Commerce.
  - Personnalisation Management Center for HCL Commerce
    HCL Commerce vous permet d'extraire le groupement GIT de code source Management Center et de démarrer l'application localement pour personnaliser le Management Center.
  - Déploiement de ressources gérées
    Les ressources gérées sont des fichiers qui sont téléchargés par les utilisateurs professionnels pour être utilisés pour le marketing de magasin ou pour compléter les produits. Ils sont ajoutés à HCL Commerce via l'outil Ressources ou l'outil Marketing dans Management Center. Par défaut, les ressources gérées sont extraites et déployées via l'EAR HCL Commerce. Pour maintenir les performances dans un environnement de production à grande échelle, les administrateurs de site doivent passer à d'autres méthodes d'extraction et de déploiement pour les ressources gérées.
  - HCL Commerce environnement de développement
    HCL Commerce Developer est la boîte à outils de développement permettant de personnaliser une application HCL Commerce.
  - Architecture fonctionnelle
    L'architecture fonctionnelle fournit à la fois l'ensemble des modèles utilisés pour implémenter la fonction métier et les structures dans lesquelles ces fonctions métier s'exécutent.
  - Modèle d'objet persistant
    HCL Commerce traite une grande quantité de données persistantes. Il existe de nombreuses tables définies dans le schéma de base de données actuel. Toutefois, même avec ce schéma étendu, vous devrez peut-être étendre ou personnaliser le schéma de base de données pour vos besoins commerciaux particuliers.
  - Création d'un magasin personnalisé
    Après avoir installé et configuré votre environnement de programmation, vous pouvez créer votre magasin personnalisé et personnaliser votre vitrine. Vous devez vous assurer que le serveur du magasin est correctement configuré et que les ressources de magasin sont déplacées vers le Store server.
  - Couche de présentation
    HCL Commerce Utilise Java Server Pages (JSP) pour implémenter la couche de vue du patron de conception MVC (Modèle-vue-contrôleur). La couche de vue est chargée de récupérer les données de la base de données grâce à l'utilisation de beans de données et de les formater pour répondre aux exigences d'affichage. Les couches de vue déterminent si la requête est envoyée à un navigateur ou diffusée en tant que XML. Les fichiers JSP présentent une séparation nette entre le contenu et la présentation des données.
  - Couche de contrôleur
    La couche de contrôleur est le pour une requête. Il contrôle l'étendue de la transaction et gère les informations relatives à la session pour la requête. Le contrôleur envoie d'abord à une commande, puis appelle la logique de traitement de la vue appropriée pour donner la réponse.
  - Couche de logique métier
    La couche de logique métier correspond aux composants métier qui fournissent des services OAGIS pour renvoyer des données ou démarrer des processus métier. La couche de présentation utilise ces services OAGIS pour afficher des données ou appeler un processus métier. La logique métier fournit les données requises par la couche de présentation. La couche de logique métier n'a pas pour unique fonction d'extraire et de mettre à jour les données requises par une application ; il existe une logique métier indépendante de la couche de présentation.
  - Couche de persistance
    L'interaction entre les objets métier et la couche de persistance est isolée dans un objet dénommé BOM (Business Object Mediator), c'est à dire médiateur d'objet métier. Les commandes BOD interagissent avec le médiateur d'objet métier pour gérer l'interaction avec les objets métier et la manière dont leur persistance est assurée.
  - Modèle d'information de modèle commercial
    Un modèle commercial est une représentation des processus de gestion utilisés sur l'ensemble du site. Il fournit un exemple de solution commerciale comprenant une structure d'organisation, des rôles utilisateur par défaut et des stratégies de contrôle d'accès, un ou plusieurs magasins type, des outils d'administration et des processus de gestion qui ont fait leurs preuves. Un modèle commercial peut être personnalisé pour prendre en charge les besoins et les scénarios de l'entreprise. HCL Commerce fournit des exemples de modèles commerciaux qui présentent des solutions commerciales communes. Ces modèles commerciaux sont créés en configurant une structure hiérarchique de l'organisation, des stratégies de contrôle d'accès, des magasins et des contrats pour répondre au mieux aux besoins de l'entreprise.
  - Modèles commerciaux
    Avant de commencer à développer votre site avec HCL Commerce, vous devez déterminer le modèle commercial pris en charge par HCL Commerce représentant le mieux l'objet de votre site. Généralement, les sites créés avec HCL Commerce seront implémentés selon un de ces modèles commerciaux.
  - Modèle d'information de données de magasin
    Les données de magasin représentent les informations chargées dans la base de données Transaction server, qui permettent à votre magasin de fonctionner. Les entrées des modules du registre d'URL et du registre de vues sont incluses dans le diagramme bien qu'elles ne constituent pas des ressources de base de données. Ces entrées sont une configuration de présentation (à savoir, actions et réacheminements struts) devant être déployée. Les entrées du registre d'URL vues sont affichées dans le diagramme afin d'illustrer le modèle d'information complet de données de magasin. Pour fonctionner correctement, les données du magasin permettant de prendre en charge toutes les activités des clients doivent être mises en place. Par exemple, pour qu'un client puisse effectuer un achat, votre magasin doit comporter un catalogue des marchandises en vente(données de catalogue), les données associées au traitement des commandes (données de taxes et d'expédition), et le stock d'où exécuter la commande (données de stock et de distribution).
  - Personnalisation HCL Commerce
    Vous pouvez étendre le produit HCL Commerce pour répondre aux besoins de votre entreprise. Cette rubrique décrit les compétences préalables et les connaissances requises dont vous avez besoin pour personnaliser la logique commerciale. Une fois que vous avez les connaissances requises, utilisez HCL Commerce Developer pour prendre part à des tutoriels qui vous guident étape par étape à travers divers scénarios de personnalisation.
  - Structure de commande Run Engine
    La structure de commande Run Engine fournit des commandes prédéfinies que vous pouvez utiliser pour modifier les paramètres de l'environnement ou les configurations de conteneurs. Cette structure est intégrée dans les images Docker fournies par HCL.
  - GraphQL pour HCL Commerce
    Le langage de marquage GraphQL est disponible pour n'importe quelle API. Il s'agit d'un interpréteur côté serveur pour le traitement des requêtes à l'aide d'un système de type de données que vous concevez. Avec GraphQL, vos données et votre code sont indépendants de toute base de données ou de tout système de stockage.
  - Services REST
    HCL Commerce utilise les services REST (Representational State Transfer) pour fournir une structure qui permet de développer des applications RESTful sur plusieurs plateformes. Ces plateformes peuvent inclure des applications Web, mobiles, de bornes d'information et sociales.
  - Web services
    - Utilisation des services HCL Commerce SOI
      Travailler avec des services HCL Commerce implique le développement de bibliothèques client, de nouvelles commandes et de la logique métier. JET (Java Emitter Template) est documenté pour vous aider dans ces tâches.
      - Utilisation d'une bibliothèque client
        Une bibliothèque client est utilisée pour créer une requête de service Web pour HCL Commerce. Vous pouvez utiliser une bibliothèque de client de services HCL Commerce (par exemple, MemberFacadeClient) dans une application Java standard.
      - Déploiement de la bibliothèque client
        La bibliothèque client d'un service HCL Commerce peut être déployée dans l'un des quatre environnements possibles :
      - HCL Commerce commandes de service
        La commande de service est le point d'entrée de la façade de composant où le document BOD (Business Object Document) commence à être traité par la logique métier.
      - Schémas de conception
        Pour comprendre l'architecture des services HCL Commerce, ainsi que la personnalisation, il existe deux patterns de conception importants : Le pattern de conception pour l'implémentation des services Get et le pattern de conception pour l'implémentation des services Process, Change et Sync.
        Pattern de conception pour l'implémentation de services Get (SOI)
        Le pattern de conception des services Get constitue le pattern de base à utiliser pour l'extraction et l'affichage d'informations depuis les services Web.
        Pattern de conception pour l'implémentation des services Process, Change et Sync (SOI)
        HCL Commerce contient de nombreuses commandes de contrôleur qui peuvent être exposées en tant que services. La commande BOD Process et Change n'est qu'une commande qui convertit la requête BOD existante en un ensemble de paires valeur-nom et qui délègue à une commande de contrôleur HCL Commerce existante. Toutefois, la fonctionnalité de mappage de messages existante d'HCL Commerce fournit cette fonctionnalité et aborde déjà certains des aspects supplémentaires de personnalisation de l'extension du nom et l'ajout de plus d'informations. Vous devez personnaliser uniquement la commande de contrôleur là où les paires nom-valeur existent. Vous n'avez pas besoin d'écrire un nouveau code pour lire la requête BOD.
      - Bibliothèque client pour services HCL Commerce
        La bibliothèque client simplifie et élimine le code sur le client. La bibliothèque client est une couche Java destinée qui aide les applications Java à s'intégrer dans votre architecture de services, sans besoin de générer du code supplémentaire. Elle prend déjà en charge les sessions et l'authentification et fournit aux clients basés Java un mécanisme normalisé pour création d'objets SDO OAGIS représentant des requêtes de service.
      - HCL Commerce Information d'erreur de services
        Lorsqu'une exception se produit pendant le traitement d'un message, la convention OAGIS doit renvoyer un message de réponse bien formulé, avec les données d'erreur incorporées. L'élément ChangeStatus est utilisé pour stocker des données sur l'exception ; si la demande s'est terminée correctement, cette zone n'est pas renseignée. Étant donné qu'une seule action par message est prise en charge, il ne peut y avoir qu'une seule erreur par message. Pour cette raison, la limitation d'une zone ChangeStatus par message est raisonnable.
      - Exceptions de bibliothèque client
        Les exceptions de bibliothèque client se composent d'une ou de plusieurs instances de l'objet ClientError.
    - Création de services HCL Commerce
      La création de services HCL Commerce implique la mise en place de l'environnement de développement, la création et l'extension des bibliothèques clients et la définition d'un genmodel EMF. Le JET (Java Emitter Template) est fourni et documenté pour vous aider dans ces tâches.
    - HCL Commerce infrastructure de commandes BOD
      La structure de commande Business Object Document (BOD) encapsule la couche de logique commerciale de HCL Commerce. Dans la version 9, elle est largement remplacée par l'API Java Persistance (JPA).
    - Développement de la couche de logique métier à l'aide de l'infrastructure de commandes BOD
      La couche métier peut être conçue et programmée à l'aide du modèle de programmation BOD introduit dans HCL Commerce Version 6 Feature Pack 3.0.1. Cette infrastructure de commandes repose sur l'utilisation de documents BOD (Business Object Documents) et des objets SDO (service data objects) logiques qui en sont la représentation Java .
    - HCL Commerce infrastructure de commandes BOD
      La structure de commande Business Object Document (BOD) encapsule la couche de logique commerciale de HCL Commerce. Dans la version 9, elle est largement remplacée par l'API Java Persistance (JPA).
    - Couche service de données
      La couche service de données (DSL) fournit une couche d'abstraction pour l'accès aux données, indépendante du schéma physique.
    - HCL Commerce services Web avec pages JSP
      Un service Web est une interface décrivant une collection d'opérations accessibles à travers le réseau à l'aide de messages XML normalisés. Le service Web est décrit au moyen d'une notation XML standard et formelle dénommée description de service. Cette description du service contient toutes les informations requises pour l'interaction avec le service, y-compris les formats de message (détaillant les opérations), les protocoles de transport et l'emplacement. L'interface masque les rouages du service, permettant ainsi de l'utiliser indépendamment de la plateforme matérielle ou logicielle sur lequel il est implémenté et du langage de programmation dans lequel il est rédigé. Les bases des services Web sont des normes telles que SOAP (Simple Object Access Protocol), WDSL (Web Services Description Language) et le registre UDDI (Universal Description, Discovery, and Integration).
    - Prise en charge des espaces de travail pour les modules de service BOD
      Il y a deux interfaces utilisateur qui utilisent des espaces de travail dans HCL CommerceHCL Commerce Accelerator et Management Center. Le Management Center utilise les services GET à partir de modules de service BOD pour récupérer un grand nombre de ses objets métier et, avec les objets métier, les métadonnées de contrôle des modifications sont également incluses dans la réponse. L'action Modifier les métadonnées de contrôle est renvoyée au Management Center, où elle est utilisée pour déterminer si l'objet peut être modifié par l'utilisateur actuel.
    - Services basés sur l'emplacement
      HCL Commerce utilise les services géodépendants pour cibler des clients qui utilisent des périphériques équipés d'un système de localisation GPS.
  - Rechercher
    HCL Commerce est livré avec une fonction de recherche puissante et entièrement intégrée. Les fonctions de recherche de HCL Commerce offrent une expérience client enrichie, avec des fonctionnalités telles que les suggestions automatiques de termes de recherche et la correction orthographique. Etabli à partir de normes du secteur, HCL Commerce Search est très flexible et extensible. Les magasins type peuvent utiliser les fonctions les plus sophistiquées du moteur de recherche sans nécessiter de personnalisation supplémentaire. A partir de la version 9.1, les microservices HCL Commerce Search with Elasticsearch gèrent l'indexation et d'autres tâches cruciales, sans qu'il n'y ait d'impact sur les performances de la vitrine ou du serveur de transactions.
- Tutoriels
  HCL Commerce fournit de nombreux tutoriels pour vous aider à personnaliser et à comprendre votre instance et vos magasins HCL Commerce.
- Exemples
  Les sujets de la catégorie Exemples illustrent différents exemples fournis avec HCL Commerce.
- Conformité
  La section suivante décrit comment vous pouvez tirer parti des fonctions et fonctionnalités d'HCL Commerce pour que votre site soit conforme aux différentes normes de sécurité et de protection de la vie privée.
- Sécurisation
  Ces rubriques décrivent les fonctions de sécurité de HCL Commerce et leur mode de configuration.
- Performances
  Les rubriques de la section Performances décrivent les moyens par lesquels vous pouvez planifier, implémenter, tester et revoir l'optimisation des performances du site HCL Commerce.
- Identification des incidents
  Les rubriques de la section Résolution des problèmes mettent en évidence les problèmes courants rencontrés HCL Commerce et comment ils peuvent être traités ou atténués.
- Référence
  Les rubriques de la section Référence contiennent toute la documentation de référence HCL Commerce.

Pattern de conception pour l'implémentation des services Process, Change et Sync (SOI)

HCL Commerce contient de nombreuses commandes de contrôleur qui peuvent être exposées en tant que services. La commande BOD Process et Change n'est qu'une commande qui convertit la requête BOD existante en un ensemble de paires valeur-nom et qui délègue à une commande de contrôleur HCL Commerce existante. Toutefois, la fonctionnalité de mappage de messages existante d'HCL Commerce fournit cette fonctionnalité et aborde déjà certains des aspects supplémentaires de personnalisation de l'extension du nom et l'ajout de plus d'informations. Vous devez personnaliser uniquement la commande de contrôleur là où les paires nom-valeur existent. Vous n'avez pas besoin d'écrire un nouveau code pour lire la requête BOD.

Pour ce faire, la demande de service est mappée à une commande de service générique message-mapping appelée com.ibm.commerce.foundation.server.command.soi.MessageMappingCmdImpl. Cette commande générique utilise la configuration message-mapping définie sous le nom "component-services" pour convertir le SDO en un ensemble de paires nom-valeur et en une implémentation de commande HCL Commerce. Ensuite, elle implémente la commande et répond à la requête.

Le diagramme suivant illustre le flux de traitement dans le pattern de conception :

Pattern de conception pour l'implémentation des services Process, Change et Sync

Dans la configuration de mappage de message, cette commande générique recherche deux attributs de contrôle pour déterminer le code à appeler pour générer la réponse. Les attributs sont responseCommand et errorCommand. La commande générique utilise l'implémentation spécifiée pour générer la réponse à la requête. Cette implémentation est le crochet de code pour générer la réponse de réussite ou d'erreur. Ces générateurs de réponse doivent suivre l'interface MessageMappingResponseCmd.