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.
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.
Extension de HCL Commerce avec des points d'extension xC
Pour certaines parties de HCL Commerce, vous pouvez écrire du code d'extension pour étendre les commandes de contrôleur ou les instructions de tâche HCL Commerce. Vous créez du code d'extension dans l'environnement de développement.
Points d'extension xC
Pour développer une logique d'intégration avec HCL Commerce, vous pouvez utiliser des points d'extension xC. Les points d'extension vous permettent d'étendre les classes de certaines commandes.
Points d'extension xC de taxes
Vous pouvez utiliser le point d'extension tax_integration_custom pour vous intégrer à un système fiscal externe pour calculer la taxe de vente et d'expédition.

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.
    - Choix d'un modèle de personnalisation
      Vous pouvez personnaliser HCL Commerce à l'aide du modèle de développement traditionnel ou de l'infrastructure de personnalisations externalisées (xC). L'approche que vous utilisez dépend de la complexité de vos besoins et de la mesure dans laquelle il est bénéfique pour vous d'isoler votre code de personnalisation.
    - Extension de HCL Commerce avec des points d'extension xC
      Pour certaines parties de HCL Commerce, vous pouvez écrire du code d'extension pour étendre les commandes de contrôleur ou les instructions de tâche HCL Commerce. Vous créez du code d'extension dans l'environnement de développement.
      - Affectation du code d'extension aux points d'extension
        Une fois que vous avez développé le code d'extension xC, vous devez enregistrer votre code d'extension dans la base de données HCL Commerce et affecter le code d'extension aux points d'extension.
      - Ajout d'un contrôle d'accès d'extension
        Vous pouvez associer un point d'extension avec une action de contrôle d'accès. Vous pouvez configurer HCL Commerce pour vérifier si l'utilisateur actuel peut effectuer l'action avant que le code d'extension soit invoqué et transmettre le résultat au code d'extension via le contexte de contrôle d'accès.
      - Points d'extension xC
        Pour développer une logique d'intégration avec HCL Commerce, vous pouvez utiliser des points d'extension xC. Les points d'extension vous permettent d'étendre les classes de certaines commandes.
        Inventory
        Vous pouvez personnaliser la façon dont HCL Commerce s'intègre aux systèmes externes de gestion des stocks, par exemple la façon dont HCL Commerce consomme les mises à jour de disponibilité des stocks à partir de systèmes externes de gestion des stocks.
        Ordre
        Vous pouvez personnaliser la façon dont HCL Commerce gère les opérations de capture de paniers et de commandes et les intégrations avec un système de gestion des commandes externe.
        Payment
        Vous pouvez personnaliser la façon dont HCL Commerce s'intègre avec les passerelles de paiement tierces. Utilisez ces points d'extension pour personnaliser la façon dont HCL Commerce interagit avec les passerelles de paiement pour traiter les paiements pendant la capture des commandes.
        Points d'extension xC de taxes
        Vous pouvez utiliser le point d'extension tax_integration_custom pour vous intégrer à un système fiscal externe pour calculer la taxe de vente et d'expédition.
        Enregistrement utilisateur
        Vous pouvez personnaliser la façon dont HCL Commerce gère l'inscription de l'utilisateur. Par exemple, utilisez ces points d'extension pour ajouter une logique personnalisée pour valider les informations utilisateur avant que le profil utilisateur ne soit mis à jour.
    - 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.
    - Prise en charge de la globalisation
      L'architecture HCL Commerce est conçue pour prendre en charge la mondialisation. La mondialisation est la conception et l'exécution appropriées des systèmes, des logiciels, des services et des procédures de telle sorte qu'une instance de logiciel, s'exécutant sur un serveur unique ou sur un poste d'utilisateur final, est en mesure de traiter des données multilingues et de présenter des données adaptées à la culture dans un environnement multiculturel comme Internet.
    - Ajout et modification des listes de prix et des stratégies de prix
      Vous pouvez ajouter des listes de prix supplémentaires, si vous avez besoin de plusieurs listes de prix pour prendre en charge les listes de prix et de coûts.
    - Ressources de relation commerciale
    - Sous-système Catalogue (Catalog)
      Le sous-système catalogue un composant de Transaction server qui permet le parcours du catalogue en ligne, le partitionnement, la classification et des associations. En outre, le sous-système catalogue inclut la prise en charge des listes de présélection personnalisées et des pages d'affichage de catalogue personnalisées. Le sous-système catalogue contient toutes les logiques et données pertinentes pour un catalogue en ligne, y compris les groupes (ou les catégories) de catalogues, les entrées de catalogue et toutes les associations ou relations entre eux.
    - sous-système Membres
      Le sous-système Membres est un composant du Transaction server qui inclut des données sur les participants du système HCL Commerce. Un membre peut être un utilisateur, un groupe d'utilisateurs (également appelé groupe membre) ou une entité organisationnelle (qui peut être une organisation, comme "IBM", ou une unité organisationnelle au sein d'une organisation, comme "Division commerce électronique"). La logique commerciale du sous-système Membres permet l'inscription des membres et offre des services de gestion des profils. D'autres services sont étroitement liés à ces ressources, notamment le contrôle d'accès, l'authentification et la gestion des sessions.
    - Devise
      Vous pouvez afficher les prix sur votre site dans une seule devise ou utiliser plusieurs devises en suivant les instructions fournies pour l'euro. Si votre site possède plusieurs magasins, vous pouvez définir une devise différente pour chaque magasin ou bien affecter des devises au groupe de magasins. En fonction du type de site créé, vous pouvez spécifier les devises que vous voulez utiliser et la façon de les afficher. Vous pouvez aussi permettre à vos clients de sélectionner leur devise d'achat.
    - Renvoie
    - Codes de taxe
      Un code de calcul de la taxe indique le calcul de la taxe des articles de commande. Un magasin perçoit généralement deux types de taxes : la taxe à l'achat ou à l'utilisation et la taxe afférente aux frais de port. Les codes de taxe sont uniques à chaque type de taxe pour un magasin. Un seul code de calcul de taxe de chaque type de taxe est appliqué à un article de commande particulier.
    - Structure de calcul
      Les systèmes de commerce doivent calculer les montants monétaires et les appliquer aux objets métier. Les règles commerciales et les exigences juridiques précisent comment et quand ces montants monétaires doivent être calculés. Lorsque ces règles et exigences changent, un bon système de commerce peut s'adapter aux changements avec peu ou pas de changements de programmation.
    - Sous-système de gestion des commandes
      Le sous-système gestion des commandes est un composant du Transaction server qui fournit les paniers, la capture des commandes, l'exécution des commandes, le stock et la prise en charge des fonctions de paiement.
    - Codes d'erreur de procédure mémorisée
      La table suivante décrit les codes d'erreur qui sont renvoyés par des procédures HCL Commercestockées spécifiques. Vous ne devez recevoir ces messages d'erreur que lorsqu'un problème avec les données nécessite une enquête plus approfondie par un spécialiste technique. Si vous recevez l'une de ces erreurs (autre que le code d'erreur 0) et que vous ne pouvez pas déterminer la cause de l'erreur, contactez le support HCL Commerce pour obtenir de l'aide.
    - Sous-système de transactions commerciales
  - 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.

Points d'extension xC de taxes

Vous pouvez utiliser le point d'extension tax_integration_custom pour vous intégrer à un système fiscal externe pour calculer la taxe de vente et d'expédition.

La table suivante identifie le point d'extension que vous pouvez utiliser pour l'intégration à un système fiscal externe.


Point d'extension	Lorsque le point d'extension est utilisé	Conseils d'implémentation du code d'extension	Formats de requêtes, de réponses	Exemple d'emplacement de code d'extension
tax_integration_custom	L'opération de calcul du panier (POST cart/calculate or POST cart/{cartId}/calculate) ou l'opération de prépaiement de panier (`POST cart/@self/precheckout`) appelle le point d'extension tax_integration_custom pour calculer la taxe. Tax_integration_custom est appelé une fois pour calculer la taxe de vente, avec les coûts et les remises des articles de commande comme entrées, et une fois pour calculer la taxe d'expédition, avec le transport des articles de commande comme entrée.	Lorsque les coûts et les remises sont fournis, le code d'extension tax_integration_custom doit appeler le système fiscal pour calculer la taxe de vente de chaque article de commande et le définir comme taxe totale de l'article de commande. Lorsque le transport est fourni, le code d'extension tax_integration_custom doit appeler le système fiscal pour calculer la taxe d'expédition de chaque article de commande et le définir comme taxe totale de l'article de commande.	TaxIntegrationCustomCmdUEInput, TaxIntegrationCustomCmdUEOutput	Méthode taxIntegrationOrderCus dans `workspace_dir`/commerceue-app/src/main/java/com/ibm/commerce/order/ue/rest/OrderResource.java

Pour un exemple d'enregistrement du code d'extension et d'attribution du code au point d'extension, voir Activation des extensions d'intégration fiscale.