SAP Commerce Cloud sap-commerce-cloud

Après l’installation, vous pouvez configurer votre instance :

Configurer la recherche à facettes pour Geometrixx Outdoors configure-the-facetted-search-for-geometrixx-outdoors

NOTE
Cette étape n’est pas nécessaire pour Hybris 5.3.0.1 et les versions ultérieures.
  1. Dans votre navigateur, accédez à la console de gestion Hybris à l’emplacement :

    http://localhost:9001/hmc/hybris

  2. Dans la barre latérale, sélectionnez Système, puis Recherche à facettes, puis Configuration de la recherche à facettes.

  3. Ouvrez l’éditeur sur Configuration for clothescatalog Sample Solr.

  4. Sous Versions des catalogues, utilisez Ajouter une version de catalogue pour ajouter outdoors-Staged et outdoors-Online à la liste.

  5. Enregistrez la configuration.

  6. Ouvrez les Types d’éléments SOLR pour ajouter les Tris SOLR à ClothesVariantProduct :

    • relevance (« Pertinence », score)
    • name-asc (« Nom (ascendant) », name)
    • name-desc (« Nom (descendant) », name)
    • price-asc (« Prix (ascendant) », priceValue)
    • price-desc (« Prix (descendant) », priceValue)
    note note
    NOTE
    Dans le menu contextuel (généralement accessible par un clic droit), sélectionnez Create Solr sort.
    Sous Hybris 5.0.0, ouvrez l’onglet Indexed Types, double-cliquez sur ClothesVariantProduct, puis sur l’onglet SOLR Sort.

    chlimage_1-36

  7. Dans l’onglet Types indexés, définissez le Type composé sur :

    Product - Product

  8. Dans l’onglet Types indexés, définissez les Requêtes de l’indexeur pour full :

    code language-shell
    SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}})
    
  9. Dans l’onglet Types indexés, définissez les Requêtes de l’indexeur pour incremental :

    code language-shell
    SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}}) AND {modifiedtime} <= ?lastIndexTime
    
  10. Dans l’onglet Types indexés, définissez la facette category. Double-cliquez sur la dernière entrée de la liste de catégorie pour afficher l’onglet Propriété indexée  :

    note note
    NOTE
    Sous Hybris 5.2, assurez-vous que l’attribut Facet du tableau Propriétés est sélectionné en vous reportant à la capture d’écran ci-dessous :

    chlimage_1-37 chlimage_1-38

  11. Ouvrez l’onglet Paramètres de facettes et définissez les valeurs de champs suivantes :

    chlimage_1-39

  12. Enregistrez les modifications.

  13. Sous Types d’éléments SOLR, définissez la facette price en vous reportant aux captures d’écran suivantes. Comme pour category, double-cliquez sur price pour ouvrir l’onglet Propriété indexée  :

    chlimage_1-40

  14. Ouvrez l’onglet Paramètres de facettes et définissez les valeurs de champs suivantes :

    chlimage_1-41

  15. Enregistrez les modifications.

  16. Ouvrez Système, Recherche à facettes, puis Assistant d’opération de l’indexeur. Démarrez une tâche cron :

    • Opération de l’indexeur  : full
    • Configuration de Solr  : Sample Solr Config for Clothes

Configuration de la version du catalogue configure-the-catalog-version

La version du catalogue (hybris.catalog.version) importée peut être configurée pour le service OSGi :

Configuration Day CQ Commerce Hybris
( com.adobe.cq.commerce.hybris.common.DefaultHybrisConfigurationService)

La version du catalogue est généralement définie sur Online ou Staged (valeur par défaut).

NOTE
Dans AEM, il existe plusieurs méthodes pour gérer les paramètres de configuration pour ces services. Pour plus d’informations, voir Configuration d’OSGi. Pour obtenir une liste exhaustive des paramètres configurables et de leurs valeurs par défaut, reportez-vous également à la console.

La sortie du journal fournit des commentaires sur les pages et composants créés et signale les erreurs potentielles.

Configurer la structure d’importation configure-the-import-structure

La liste suivante présente un exemple de structure (de ressources, de pages et de composants) créée par défaut :

+ /content/dam/path/to/images
  + 12345.jpg (dam:Asset)
    + ...
  + ...
+ /content/site/en
  - cq:commerceProvider = "hybris"
  - cq:hybrisBaseStore = "basestore"
  - cq:hybrisCatalogId = "catalog"
  + category1 (cq:Page)
    + jcr:content (cq:PageContent)
      - jcr:title = "Category 1"
    + category11 (cq:Page)
      + jcr:content (cq:PageContent)
        - jcr:title = "Category 1.1"
      + 12345 (cq:Page)
        + jcr:content (cq:PageContent)
          + par
            + product (nt:unstructured)
              - cq:hybrisProductId = "12345"
              - sling:resourceType = "commerce/components/product"
              + image (nt:unstructured)
                - sling:resourceType = "commerce/components/product/image"
                - fileReference = "/content/dam/path/to/images/12345.jpg"
              + 12345.1-S (nt:unstructured)
                - cq:hybrisProductId = "12345.1-S"
                - sling:resourceType = "commerce/components/product"
                + image (nt:unstructured)
                  - sling:resourceType = "commerce/components/product/image"
                  - fileReference = "/content/dam/path/to/images/12345.1-S.jpg"
              + ...

Ce type de structure est créé par le service OSGi DefaultImportHandler, qui met en œuvre l’interface ImportHandler. L’importateur appelle un gestionnaire d’import pour créer des produits, des variations de produits, des catégories, des ressources, etc.

La structure à générer lors de l’importation peut être configurée pour :

``Gestionnaire d’importation par défaut Day CQ Commerce Hybris
(com.adobe.cq.commerce.hybris.importer.DefaultImportHandler)

Dans AEM, il existe plusieurs méthodes pour gérer les paramètres de configuration pour ces services. Pour plus d’informations, voir Configuration d’OSGi. Pour obtenir une liste exhaustive des paramètres configurables et de leurs valeurs par défaut, reportez-vous également à la console.

Configurer les attributs de produit à charger configure-the-product-attributes-to-load

L’analyseur de réponse peut être configuré pour définir les propriétés et les attributs à charger pour les produits (variantes) :

  1. Configurez le lot OSGi :

    Analyseur de réponse par défaut Day CQ Commerce Hybris
    (com.adobe.cq.commerce.hybris.impl.importer.DefaultResponseParser)

    Vous pouvez définir différents attributs et options nécessaires au chargement et au mappage.

    note note
    NOTE
    Dans AEM, il existe plusieurs méthodes pour gérer les paramètres de configuration pour ces services. Pour plus d’informations, voir Configuration d’OSGi. Pour obtenir une liste exhaustive des paramètres configurables et de leurs valeurs par défaut, reportez-vous également à la console.

Importer les données de produit importing-the-product-data

Il existe différentes manières d’importer les données de produit. Les données de produit peuvent être importées lors de la configuration initiale de l’environnement ou après la modification de données Hybris :

Les informations sur les produits importées d’Hybris se trouvent dans le référentiel sous :

/etc/commerce/products

Les propriétés ci-dessous indiquent le lien avec Hybris :

  • commerceProvider
  • cq:hybrisCatalogId
  • cq:hybrisProductID
NOTE
La mise en œuvre d’Hybris (c’est-à-dire geometrixx-outdoors/en_US) stocke uniquement les identifiants de produit et d’autres informations de base sous /etc/commerce.
Le serveur Hybris est référencé lors de chaque demande d’informations sur un produit.

Importation complète full-import

  1. Si nécessaire, supprimez toutes les données de produit existantes à l’aide de CRXDE Lite.

    1. Accédez à la sous-arborescence contenant les données de produit :

      /etc/commerce/products

      Par exemple :

      http://localhost:4502/crx/de/index.jsp#/etc/commerce/products

    2. Supprimez le nœud qui contient les données d’un produit, par exemple, outdoors.

    3. Enregistrez tout pour conserver la modification.

  2. Ouvrez l’importateur Hybris dans AEM :

    /etc/importers/hybris.html

    Par exemple :

    http://localhost:4502/etc/importers/hybris.html

  3. Configurez les paramètres requis, par exemple :

    chlimage_1-42

  4. Cliquez sur Importer le catalogue pour commencer l’importation.

    Vous pouvez ensuite vérifier les données importées à l’adresse :

    code language-none
        /etc/commerce/products/outdoors
    

    Vous pouvez l’ouvrir dans CRXDE Lite, par exemple :

    [http://localhost:4502/crx/de/index.jsp#/etc/commerce/products](http://localhost:4502/crx/de/index.jsp#/etc/commerce/products)

Importation incrémentielle incremental-import

  1. Vérifiez les informations contenues dans AEM pour le ou les produits concernés, dans la sous-arborescence appropriée sous :

    /etc/commerce/products

    Vous pouvez l’ouvrir dans CRXDE Lite, par exemple :

    http://localhost:4502/crx/de/index.jsp#/etc/commerce/products

  2. Dans Hybris, mettez à jour les informations conservées sur les produits concernés.

  3. Ouvrez l’importateur Hybris dans AEM :

    /etc/importers/hybris.html

    Par exemple :

    http://localhost:4502/etc/importers/hybris.html

  4. Sélectionnez la case Importation incrémentielle.

  5. Cliquez sur Importer le catalogue pour commencer l’importation.

    Une fois l’opération terminée, vous pouvez vérifier les données mises à jour dans AEM sous :

    code language-none
        /etc/commerce/products
    

Mise à jour express express-update

Le processus d’importation peut être long. Ainsi, en prolongement de la synchronisation des produits, vous pouvez sélectionner des sections spécifiques du catalogue pour les mettre rapidement à jour (déclenchement manuel). Cette méthode utilise le flux d’exportation avec la configuration des attributs standard.

  1. Vérifiez les informations contenues dans AEM pour le ou les produits concernés, dans la sous-arborescence appropriée sous :

    /etc/commerce/products

    Vous pouvez l’ouvrir dans CRXDE Lite, par exemple :

    http://localhost:4502/crx/de/index.jsp#/etc/commerce/products

  2. Dans Hybris, mettez à jour les informations conservées sur les produits concernés.

  3. Dans Hybris, ajoutez un ou plusieurs produits à la file d’attente express, par exemple :

    chlimage_1-43

  4. Ouvrez l’importateur Hybris dans AEM :

    /etc/importers/hybris.html

    Par exemple :

    http://localhost:4502/etc/importers/hybris.html

  5. Sélectionnez la case Mise à jour express.

  6. Cliquez sur Importer le catalogue pour commencer l’importation.

    Une fois l’opération terminée, vous pouvez vérifier les données mises à jour dans AEM sous :

    code language-none
        /etc/commerce/products
    

Configuration de l’importateur de catalogues configure-the-catalog-importer

Il est possible d’importer le catalogue Hybris dans AEM à l’aide de l’importateur par lots pour des catalogues, des catégories et des produits Hybris.

Les paramètres utilisés par l’importateur peuvent être configurés pour :

Importateur de catalogue Day CQ Commerce Hybris
(com.adobe.cq.commerce.hybris.impl.importer.DefaultHybrisImporter)

Dans AEM, il existe plusieurs méthodes pour gérer les paramètres de configuration pour ces services. Pour plus d’informations, voir Configuration d’OSGi. Pour obtenir une liste exhaustive des paramètres configurables et de leurs valeurs par défaut, reportez-vous également à la console.

Importer des catalogues catalog-import

Le package Hybris est fourni avec un importateur de catalogues pour configurer la structure de page initiale.

Cette option est disponible à partir de :

http://localhost:4502/etc/importers/hybris.html

ecommerceimportconsole

Les informations suivantes sont fournies :

  • Boutique de base
    Identificateur de la boutique de base configurée dans Hybris.

  • Catalogue
    Identificateur du catalogue à importer.

  • Chemin racine
    Chemin d’accès racine où doit être importé le catalogue.

Supprimer un produit du catalogue removing-a-product-from-the-catalog

Pour supprimer un ou plusieurs produits du catalogue :

  1. Configurez les paramètres du service OSGi Importateur de catalogues Hybris Day CQ Commerce. Voir aussi Configuration de l’importateur de catalogues.

    Activez les propriétés suivantes :

    • Activer la suppression de produit
    • Activer la suppression de ressources de produit
    note note
    NOTE
    Dans AEM, il existe plusieurs méthodes pour gérer les paramètres de configuration pour ces services. Pour plus d’informations, voir Configuration d’OSGi. Pour obtenir une liste exhaustive des paramètres configurables et de leurs valeurs par défaut, reportez-vous également à la console.
  2. Initialisez l’importateur en exécutant deux mises à jour incrémentielle (voir Importation d’un catalogue) :

    • Le premier cycle de mise à jour génère un ensemble de produits modifiés, mentionnés dans la liste de journaux.
    • Pour la deuxième fois, aucun produit ne doit être mis à jour.
    note note
    NOTE
    La première importation permet d’initialiser les informations du produit. La deuxième importation vérifie que tout a fonctionné et que l’ensemble des produits est prêt.
  3. Consultez la page de catégories qui contient le produit à supprimer. Les détails du produit doivent être visibles.

    Par exemple, la catégorie suivante affiche les détails du produit Cajamara :

    http://localhost:4502/editor.html/content/geometrixx-outdoors/en_US/equipment/biking.html

  4. Supprimez le produit dans la console Hybris. À l’aide de l’option Modifier le statut d’approbation, définissez le statut sur unapproved. Le produit est supprimé du flux en direct.

    Par exemple :

    • Ouvrez la page http://localhost:9001/productcockpit.
    • Sélectionnez le catalogue Outdoors Staged.
    • Recherchez Cajamara.
    • Sélectionnez ce produit et définissez le statut d’approbation sur unapproved.
  5. Procédez à une autre mise à jour incrémentielle (voir Importation d’un catalogue). Le journal répertorie le produit supprimé.

  6. Déployez le catalogue approprié. Le produit et la page produit ont été supprimés d’AEM.

    Par exemple :

  7. Pour rétablir le produit, procédez comme suit :

    1. Dans Hybris, redéfinissez le statut d’approbation sur approuvé.

    2. Dans AEM :

      1. Effectuez une mise à jour incrémentielle.
      2. Redéployez le catalogue approprié.
      3. Actualisez la page de catégorie appropriée.

Ajouter un historique de commandes à ClientContext add-order-history-trait-to-the-client-context

Pour ajouter un historique de commandes à ClientContext, procédez comme suit :

  1. Ouvrez la page de conception de ClientContext selon l’une des méthodes suivantes :

    • Ouvrez une page à modifier, puis ouvrez ClientContext à l’aide des raccourcis clavier Ctrl+Alt+C (Windows) ou Ctrl+Option+C (Mac). À l’aide de l’icône de crayon dans le coin supérieur gauche de ClientContext, ouvrez la page de conception de ClientContext.
    • Accédez directement à http://localhost:4502/etc/clientcontext/default/content.html.
  2. Ajoutez le composant Historique de commandes au composant Panier de ClientContext.

  3. Vous pouvez confirmer que ClientContext affiche les détails de votre historique de commandes. Par exemple :

    1. Ouvrez ClientContext.

    2. Ajoutez un article au panier.

    3. Effectuez le passage en caisse.

    4. Vérifiez ClientContext.

    5. Ajoutez un autre article au panier.

    6. Accédez à la page de passage en caisse :

      • ClientContext affiche un récapitulatif de l’historique des commandes.
      • Un message stipulant que vous êtes un client régulier s’affiche.
    note note
    NOTE
    Le message est obtenu de la façon suivante :
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2