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 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.
Comprendre le contrôle d'accès
Le contrôle d'accès d'une application HCL Commerce est composé des éléments suivants : les utilisateurs, les actions, les ressources et les relations.
Interface groupable
L'application d'une stratégie de contrôle d'accès est spécifique à un groupe de ressources. Les regroupements de ressources peuvent être effectués en fonction d'attributs tels que le nom de la classe, l'état d'une commande ou la valeur storeId.

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.
    - API Java Persistence
      Les Enterprise Java Beans (EJB) étaient couramment utilisés dans les versions précédentes de HCL Commerce. A partir de la version 9, l'API Java Persistence (JPA) sera la norme.
    - Ressources de données
      Les rubriques ci-dessous fournissent des explications plus détaillées sur chacune des ressources Magasin. Les ressources de données de magasin de la présente section sont organisées en fonction de la structure de l'architecture de données de magasin HCL Commerce :
    - Création de clés primaires pour une entité JPA
      Avant d'utiliser le gestionnaire d'entités pour rendre une entité JPA persistante, vous devez créer une clé primaire pour l'entité.
    - Recherche de données à l'aide d'un bean d'accès
      Vous utiliserez les beans d'accès dans votre logique métier lorsque vous souhaitez trouver des données dans la base de données HCL Commerce. Dans un bean d'accès, vous devez sélectionner l'enregistrement de base de données approprié à l'aide de la clé primaire ou d'une méthode de recherche.
    - Recherche de données à l'aide d'une entité JPA
      Vous pouvez utiliser les beans d'accès pour rechercher des données. Toutefois, si vous avez une entité JPA personnalisée, il n'est pas nécessaire de l'encapsuler dans un bean d'accès. Au lieu de cela, définissez une implémentation JPA DAO qui étend AbstractJPAEntityDaoImpl, qui fournit certaines méthodes utiles que vous pouvez utiliser directement.
    - Mise à jour de données à l'aide d'un bean d'accès
      Vous pouvez mettre à jour les données de votre logique métier à l'aide d'un bean d'accès pour récupérer et modifier des données, même si la méthode d'accès sous-jacente est JPA.
    - Mise à jour des données à l'aide d'une entité JPA
      Vous pouvez mettre à jour les entités JPA par défaut dans votre logique métier à l'aide d'un bean d'accès. Si vous avez des entités JPA personnalisées, vous n'avez pas besoin de les encapsuler dans un bean d'accès. Au lieu de cela, définissez une implémentation JPA DAO qui étend AbstractJPAEntityDaoImpl.
    - Insertion de données à l'aide de beans d'accès
      Vous pouvez utiliser les beans d'accès pour créer de nouvelles données, même si la logique sous-jacente utilise le standard JPA.
    - Insertion de données à l'aide d'une entité JPA
      Vous pouvez utiliser des beans d'accès pour insérer de nouvelles données, dans le cadre de votre logique commerciale, pour les entités JPA par défaut.
    - Suppression de données à l'aide d'un bean d'accès
      Vous pouvez supprimer des données de la base de données HCL Commerce à l'aide de beans d'accès, même si la logique sous-jacente utilise JPA.
    - Suppression de données à l'aide d'une entité JPA
      Pour les entités JPA par défaut, vous pouvez supprimer des données de la base de données HCL Commerce à l'aide de la méthode remove() de l'interface du bean d'accès. Si vous souhaitez supprimer votre entité JPA personnalisée, définissez une implémentation JPA DAO qui agrandit AbstractJPAEntityDaoImpl.
    - Extension du modèle d'objet HCL Commerce avec des beans de session
      HCL Commerce a mis en œuvre des objets métier de base à l'aide d'entités JPA.
    - Création de nouveaux beans session
      Lors de la création de nouveaux beans de session, créez-les dans le projet WebSphereCommerceServerExtensionsData.
    - Création d'un bean de données simple
      Un bean de données est un bean Java qui est utilisé dans les pages JSP pour récupérer des informations à partir du bean métier. Un bean de données simple étend son bean d'accès correspondant et implémente l'interface SmartDataBean. En étendant un bean d'accès, le bean de données fournit une représentation indirecte simple d'un bean d'entité : il encapsule les propriétés qui peuvent être récupérées ou définies dans le bean d'entité. La plupart des codes pour le bean de données sont générés automatiquement par Rational Application Developer. Vous devez stocker les nouveaux beans de données dans le projet WebSphereCommerceServerExtensionsLogic.
    - Comprendre le contrôle d'accès
      Le contrôle d'accès d'une application HCL Commerce est composé des éléments suivants : les utilisateurs, les actions, les ressources et les relations.
      - Interface Protectable
        Le fait que la ressource doit implémenter l'interface com.ibm.commerce.security.Protectable représente un facteur clé permettant qu'une ressource soit protégée par les stratégies de contrôle d'accès de HCL Commerce. Cette interface est le plus couramment utilisée avec les beans d'entreprise et les beans de données, mais seuls les beans particuliers qui nécessitent une protection doivent implémenter l'interface.
      - Protection des ressources dans WebSphere Application Server
        Les ressources HCL Commercesuivantes sont protégées via contrôle d'accès par WebSphere Application Server :
      - Droit de l'administrateur d'agir au nom d'un client enregistré
        Un administrateur peut agir au nom d'un client enregistré pour plusieurs requêtes dans une session en exécutant l'URL RunAsUserSetInSession. Si un administrateur a l'autorité nécessaire pour agir au nom d'un client enregistré, l'administrateur peut adopter l'identité de ce client pour toutes les requêtes ultérieures. Par défaut, l'administrateur qui agit pour le compte d'un client enregistré peut effectuer toutes les actions que le client enregistré peut effectuer. Lorsqu'il agit au nom d'un client enregistré, l'administrateur ne peut exécuter aucune commande administrative.
      - Interactions de contrôle d'accès
        La structure de la stratégie de contrôle d'accès contrôle le fonctionnement du contrôle d'accès dans HCL Commerce.
      - Interface groupable
        L'application d'une stratégie de contrôle d'accès est spécifique à un groupe de ressources. Les regroupements de ressources peuvent être effectués en fonction d'attributs tels que le nom de la classe, l'état d'une commande ou la valeur storeId.
      - HCL Commerce stratégies de contrôle d'accès
        Cette section présente brièvement les principales composantes de la structure de contrôle d'accès de HCL Commerce. Elle est fournie de manière à ce que certaines des tâches de programmation liées au contrôle d'accès soient considérées dans le contexte adéquat.
      - Implémentation du contrôle d'accès
        Cette rubrique décrit comment implémenter le contrôle d'accès dans le code personnalisé. En général, les beans métier et les beans de données sont des ressources que vous voudrez peut-être protéger. Toutefois, tous les beans métiers et les beans de données ne devraient pas être protégés. Dans l'application HCL Commerce existante, les ressources nécessitant une protection implémentent déjà l'interface Protectable. Généralement, la question des ressources à protéger est soulevée lors de la création de nouveaux beans métier et de données. Le choix des ressources à protéger dépend de votre application.
      - Modification du contrôle d'accès à des ressources HCL Commerce existantes
        Cette section vous guide lors de la modification du contrôle d'accès aux ressources HCL Commerce existantes. En particulier, les scénarios suivants sont examinés :
      - Contrôle des accès pour HCL Commerce Accelerator
        Vous pouvez mettre à jour les stratégies de contrôle d'accès pour que HCL Commerce Accelerator contrôle l'accès à l'outil et accorde aux utilisateurs l'accès à l'outil pour un type de magasin.
  - 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.

Interface groupable

L'application d'une stratégie de contrôle d'accès est spécifique à un groupe de ressources. Les regroupements de ressources peuvent être effectués en fonction d'attributs tels que le nom de la classe, l'état d'une commande ou la valeur storeId.

Si une ressource doit être regroupée par un attribut autre que son nom de classe dans le but d'appliquer des stratégies de contrôle d'accès, elle doit implémenter l'interface com.ibm.commerce.grouping.Groupable.

Le snippet de code suivant représente l'interface Groupable :


Groupable interface {
        Object getGroupingAttributeValue (String attributeName, GroupContext context)
}

Par exemple, pour implémenter une stratégie qui ne s'applique qu'aux commandes qui se trouvent à l'état en attente (status = P (pending)), l'interface distante du bean de l'entité Order implémente l'interface Groupable et la valeur d'attributeName est définie sur "status".

L'utilisation de l'interface Groupable est rare.