SAP Commerce Cloud sap-commerce-cloud

CAUTION
AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

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

Configuration de la recherche à facettes pour les Geometrixx Outdoors configure-the-facetted-search-for-geometrixx-outdoors

NOTE
Cela n’est pas nécessaire pour Hybris 5.3.0.1 et versions ultérieures.
  1. Dans votre navigateur, accédez au console de gestion Hybris at :

    http://localhost:9001/hmc/hybris

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

  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 :

    • pertinence ("pertinence", note)
    • name-asc ("Nom (croissant)", name)
    • name-desc ("Nom (descendant)", name)
    • price-asc ("Price (ascendant)", priceValue
    • price-desc ("Price (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 cliquez sur 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 sur full :

    code language-shell
    SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}})
    
  9. Dans l’onglet Indexed Types, définissez les Requêtes de l’indexeur sur 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. Ouvrir Système, Recherche de facettes, puis Assistant d’opération de l’indexeur. Démarrez une tâche cronjob :

    • 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 (en ligne) ou Staged (intermédiaire ; 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.

Configuration de 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. Un gestionnaire d’importation est appelé par l’importateur réel pour créer des produits, des variantes de produits, des catégories, des ressources, etc.

La structure à générer lors de l'import 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.

Configuration des 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.

Importation des données de produit importing-the-product-data

Vous pouvez importer les données d’un produit de différentes façons. Les données de produit peuvent être importées lors de la configuration initiale de l’environnement ou après que des modifications ont été apportées aux 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é chaque fois que des informations sur un produit sont demandées.

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 pertinents, 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 correspondants.

  3. Ouvrez l’importateur Hybris dans AEM :

    /etc/importers/hybris.html

    Par exemple :

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

  4. Sélectionner la case à cocher 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 pertinents, 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 correspondants.

  3. Dans Hybris, ajoutez les produits à la file d’attente rapide, 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électionner la case à cocher 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
    

    [](http://localhost:4502/crx/de/index.jsp#/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.

Importation catalogue catalog-import

Le package hybris est fourni avec un importateur de catalogue pour configurer la structure de page initiale.

Cette option est disponible à partir de :

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

ecommerceimportconsole

Les informations ci-dessous doivent être 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.

Suppression d’un produit du catalogue removing-a-product-from-the-catalog

Pour supprimer un ou plusieurs produits du catalogue :

  1. Configuration du service pour OSGi Importateur de catalogues Day CQ Commerce Hybris; voir aussi Configuration de l’importateur de catalogue.

    Activez les propriétés suivantes :

    • Activer la suppression de produit
    • Activation de 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 le jeu de 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 sera 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é. La page de produit et de produit a été supprimée 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. En AEM :

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

Ajout de la caractéristique Historique des commandes au contexte client 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 la variable Historique des commandes component au Voiture d'achat composant du contexte client.

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

    1. Ouvrez le contexte client.

    2. Ajoutez un élément au panier.

    3. Effectuez le passage en caisse.

    4. Vérifiez le contexte client.

    5. Ajoutez un autre élément 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
5ce3024a-cbea-458b-8b2f-f9b8dda516e8