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.
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.
HCL Commerce Meilleures pratiques de programmation JSP
Cette section offre la sélection suivante des meilleures pratiques de programmation JSP, qui favorisent le développement de pages JSP réutilisables et facilement durables dans le cadre de développement du magasin HCL Commerce :
HCL Commerce Balise useBean
La balise useBean instancie un bean de données HCL Commerce et le remplit automatiquement pour vous. Une nouvelle direction de programmation a également été entreprise avec nos magasins type qui utilisent maintenant la JavaServer Pages Standard Tag Library (JSTL) pour effectuer la logique de vue, au lieu du code Java. Dans le même temps, la logique commerciale s'est déplacée dans des beans de données. La combinaison de ces étapes permet moins de code Java dans une page JSP.

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.
    - HCL Commerce structure Struts
      Struts est une structure bien documentée, ayant atteint son stade de maturité et populaire destinée à la construction d'applications frontales pour les applications Java. Pour répondre aux besoins des applications logicielles, elle utilise une architecture Modèle-Vue-Contrôleur (MVC) : Le modèle représente le code métier ou de base de données, la vue représente le code de conception de page et le contrôleur, la code de la navigation.
    - Spring framework
      Spring Framework est un modèle de programmation et de configuration léger et ouvert pour développer des applications d'entreprise basées sur Java. Cette structure est utilisée dans HCL Commerce pour la création et la configuration du Management Center, y compris la gestion des requêtes URL à partir du Management Center afin de récupérer et de traiter les données d'objet.
    - Management Center
      L'infrastructure Management Center pour HCL Commerce constitue la base des outils des professionnels HCL Commerce. Les objets métier gérés par le Management Center sont définis par des composants individuels du Management Center. La structure du Management Center utilise ces définitions pour vous fournir toutes les fonctions vous permettant de rechercher, créer, modifier et supprimer les objets métier définis. Si vous envisagez de personnaliser le Management Center, il est important de comprendre la structure et les composants qui constituent le Management Center.
    - Développement de ressources Commerce Composer
      Enrichissez les fonctionnalités de l'outil Commerce Composer en développant vos propres widgets et modèles, et en étendant d'autres fonctionnalités et fonctions selon vos besoins métier.
    - Personnalisation de promotions
      La personnalisation de promotions peut impliquer la personnalisation des outils métier et du moteur de promotion sous-jacent, avec une architecture nette prenant en charge des fonctionnalités riches, ainsi qu'un grand nombre de possibilités de personnalisation.
    - Utilisation du fichier de configuration de composant promotions
      Certains composants du Centre de gestion, comme le composant promotions, ont des fichiers de configuration personnalisables. Ces fichiers contiennent des propriétés qui contrôlent certaines caractéristiques du composant.
    - Personnalisation de fonctions et d'objets marketing
      Vous pouvez personnaliser des fonctions et des objets marketing afin de mieux répondre aux besoins métier de votre site. Par exemple, vous pouvez notamment personnaliser des emplacement e-Marketing, des segments de clientèle, des activités, des composants d'activité tels que les déclencheurs, les cibles et les actions. La personnalisation est prise en charge pour l'Marketing tool dans le Management Center et pour la boutique en ligne pour afficher des emplacements e-Marketing.
    - Personnalisation des règles de tarification
      Vous pouvez personnaliser des règles de tarification afin de répondre aux besoins métier de votre site. Par exemple, vous pouvez créer une condition ou une action que les professionnels ajoutent à leurs règles de tarification. La personnalisation est prise en charge à la fois pour l'interface utilisateur de l'outil générateur de règle de tarification dans l'outil Filtre de catalogue et tarification, et pour les services de tarification.
    - Personnalisation de l'aperçu du magasin
      L'aperçu de magasin peut être personnalisé et doté de fonctions qui augmentent l'efficacité du travail fourni par les utilisateurs professionnels. Ces fonctions sont l'édition en un clic et la prévisualisation en contexte.
    - Personnalisation de la gestion de versions de contenu
      La fonction de gestion des versions de contenu est activée pour certains objets dans l'outil Catalogues dans le Management Center. Vous pouvez ajouter ou supprimer un support de gestion de versions de contenu pour des objets existants et des objets personnalisés en personnalisant le Management Center et le serveur HCL Commerce.
    - Personnalisation du composant d'infrastructure
      La personnalisation du composant d'infrastructure vous permet de modifier les propriétés configurables pour les fonctionnalités Centre de gestion et Optimisation des moteurs de recherche (SEO).
    - Développement de pages JSP
      Pour créer des pages JSP pour HCL Commerce, vous devez avoir des compétences Rational Application Developer et des compétences JSP. Vous devez également être familiarisé avec JSTL.
    - HCL Commerce Meilleures pratiques de programmation JSP
      Cette section offre la sélection suivante des meilleures pratiques de programmation JSP, qui favorisent le développement de pages JSP réutilisables et facilement durables dans le cadre de développement du magasin HCL Commerce :
      - Utiliser JSTL à la place du code Java
        JavaServer Pages Standard Tag Library (JSTL) est une collection de balises JSP qui fournissent les fonctionnalités standard les plus fréquemment recherchées par les auteurs de pages JSP. JSTL prend en charge les conditions, l'itération, la mise en forme sensible aux paramètres régionaux, et ainsi de suite. Il dispose également d'un langage d'expression (EL) qui permet aux auteurs de pages de contrôler la façon dont les données sont récupérées et affichées.
      - Utilisez la balise spécifique à Commerce pour l'activation des beans
        Les beans de données HCL Commerce doivent être activés avant leur utilisation. HCL Commerce fournit une version spécifique à Commerce de la balise useBean, <wcbase:useBean>, qui effectue l'activation des beans de données sans utiliser Java et est la méthode recommandée d'activation des beans de données dans les pages JSP de magasin.
      - Utiliser des cartes spécifiques à Commerce pour accéder aux paramètres de requête
        HCL Commerce fournit les versions spécifiques à Commerce suivantes des objets JSP implicites param et paramValues pour faciliter l'accès aux paramètres de requête HTTP déchiffrés :
      - Utiliser le bean de données StoreErrorDataBean pour la gestion des erreurs
        Pour afficher des messages d'erreur spécifiques au magasin dans les pages JSP, utilisez le bean de données StoreErrorDataBean.
      - Utiliser un mécanisme d'inclusion approprié
        JSP prend en charge deux mécanismes d'inclusion : Inclusion statique et Inclusion dynamique.
      - Utiliser l'extension .jspf pour les segments JSP
        Une page JSP peut se composer d'un ou de plusieurs fichiers : par exemple, le fichier contenant une page JSP de niveau supérieur, plusieurs fichiers contenant des pages JSP incluses dynamiquement et plusieurs fichiers contenant des segments JSP inclus statiquement. Contrairement aux pages de niveau supérieur ou dynamiquement incluses, les segments JSP n'ont pas besoin d'être des pages JSP légales et peuvent donc ne pas se compiler correctement.
      - Utiliser l'attribut escapeXml pour préserver la mise en forme HTML
        Par défaut, la valeur de l'attribut escapeXml de la balise JSTL <c:out> est true. Ce comportement par défaut garantit que les caractères spéciaux HTML, tels que <, >&, ', ou ", contenus dans les chaînes de résultat sont convertis en leurs codes d'entité de caractères correspondants et affichés correctement dans la page HTML générée par la page JSP. Dans certains scénarios de magasins HCL Commerce classiques, cependant, ce comportement est contre-productif. L'un de ces scénarios est l'affichage des prix dans les magasins mondialisés :
      - Assurer la conformité à XHTML
        Les éléments JSTL et HTML de vos pages JSP doivent être conformes à la norme et aux recommandations W3C XHTML.
      - Utiliser la méthode de publication pour la soumission de formulaire
        Les données peuvent être envoyées du client vers le serveur par le biais d'un formulaire HTML à l'aide de la méthode get ou post. Les servlets peuvent gérer l'une ou l'autre méthode correctement en analysant et décodant de manière appropriée la requête entrante. En général, l'utilisation de la méthode post est recommandée pour les raisons suivantes :
      - Modification de l'apparence d'un magasin type
        L'apparence de la vitrine joue une part importante dans le pouvoir de séduction de votre magasin. Dans ce tutoriel, les feuilles de style en cascade (CSS) seront modifiées afin de changer la couleur et l'agencement des éléments de la vitrine. Le nouveau style sera ensuite rendu disponible sous forme d'option d'affichage dans le magasin type. Le nouveau style est sélectionné dans l'Assistant de modification du style dans HCL Commerce Accelerator ou dans l'outil Gestion de magasin Management Center.
      - Activation de la fonctionnalité de téléchargement de fichiers Struts 2
        Vous pouvez profiter pleinement de la fonctionnalité de téléchargement de fichiers Struts 2 HCL Commerce. Afin d'utiliser les téléchargements Struts 2, assurez-vous d'avoir activé la fonctionnalité.
      - Pages JSP et beans de données
        Un bean de données est un bean Java qui est utilisé dans une page JSP pour fournir du contenu dynamique. Un bean de données fournit normalement une représentation simple d'un bean d'entité HCL Commerce. Le bean de données encapsule les propriétés qui peuvent être récupérées ou définies dans le bean d'entité. En tant que tel, le bean de données simplifie la tâche d'incorporation de données dynamiques dans les pages JSP.
      - HCL Commerce Balise useBean
        La balise useBean instancie un bean de données HCL Commerce et le remplit automatiquement pour vous. Une nouvelle direction de programmation a également été entreprise avec nos magasins type qui utilisent maintenant la JavaServer Pages Standard Tag Library (JSTL) pour effectuer la logique de vue, au lieu du code Java. Dans le même temps, la logique commerciale s'est déplacée dans des beans de données. La combinaison de ces étapes permet moins de code Java dans une page JSP.
    - Gestion du double clic dans HCL Commerce
      L'objectif principal de la gestion du double-clic dans HCL Commerce consiste à éviter le traitement d'une même requête deux fois pour garantir l'intégrité des données dans le système. Lors du traitement de certaines requêtes URL, telles qu'OrderItemAdd, la fonction de double-clic de HCL Commerce identifiera si la requête du client en ligne est en cours de traitement et bloque la requête en cours si tel est le cas.
  - 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
  - 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.

HCL Commerce Balise useBean

La balise useBean instancie un bean de données HCL Commerce et le remplit automatiquement pour vous. Une nouvelle direction de programmation a également été entreprise avec nos magasins type qui utilisent maintenant la JavaServer Pages Standard Tag Library (JSTL) pour effectuer la logique de vue, au lieu du code Java. Dans le même temps, la logique commerciale s'est déplacée dans des beans de données. La combinaison de ces étapes permet moins de code Java dans une page JSP.

La balise useBean est associée aux attributs suivants :

id: Obligatoire : L'ID que le nouveau bean aura. Cet ID doit être un identificateur Java valide et doit être unique car il est également utilisé pour créer une nouvelle variable de script pour la page JSP. L'ID doit également être unique à une page.
classname: Obligatoire : Classe du bean de données qui sera instancié.
portée: Etendue dans laquelle le bean doit être stocké telle que page, requête, session et application. L'étendue par défaut est page.

Pour pouvoir utiliser la nouvelle bibliothèque de balises useBean, une page JSP doit d'abord être informée du moyen de localiser la balise. Pour localiser et utiliser la nouvelle balise, la ligne suivante doit être située en haut du fichier JSP :


<%@ taglib uri="http://commerce.ibm.com/base" prefix="wcbase"
%>

Cette ligne mettra la balise useBean à disposition de la page JSP avec le préfixe de wcbase.

Voici des exemples d'utilisation de la balise useBean :

Un nouvel OrderDataBean est créé et est accessible sur la page JSP sous forme d'orderBean.


    <wcbase:useBean
id="orderBean"classname="com.ibm.commerce.order.beans.OrderDataBean"scope="page"/>

Un nouvel OrderDataBean est créé et est accessible sur la page JSP sous forme d'orderBean. Dans ce cas, la balise useBean a un corps. A l'intérieur de la balise de corps du bean, le <c:set> est utilisé pour définir des propriétés sur l'OrderDataBean.
```
<wcbase:useBean id="orderBean" 
  classname="com.ibm.commerce.order.beans.OrderDataBean"
scope="page">    
  <c:set value="${orderId[0]}" target="${orderBean}"
property="orderId"/>
</wcbase:useBean> 
```