SAP Commerce Cloud

Nach der Installation können Sie Ihre Instanz konfigurieren:

1. Konfigurieren der Facettensuche für Geometrixx Outdoors.
2. Konfigurieren der Katalogversion.
3. Konfigurieren der Importstruktur.
4. Konfigurieren der zu ladenden Produktattribute.
5. Importieren der Produktdaten.
6. Konfigurieren des Katalog-Import-Tools.
7. Verwenden Sie die Importer zum Importieren des Katalogs an einen bestimmten Ort in AEM.

Konfigurieren der Facettensuche für Geometrixx Outdoors

1. Navigieren Sie in Ihrem Browser zum Hybris-Verwaltungskonsole unter:

   http://localhost:9001/hmc/hybris

2. Wählen Sie in der Seitenleiste System, dann Facettensuche, dann Konfiguration der Facettensuche.

3. Öffnen Sie den Editor für die Solr-Beispielkonfiguration für „clothescatalog“.

4. Nutzen Sie unter Katalogversionen die Option Katalogversion hinzufügen, um outdoors-Staged und outdoors-Online zur Liste hinzuzufügen.

5. Speichern Sie die Konfiguration.

6. Öffnen Sie SOLR-Elementtypen, um SOLR-Sortierungen zu ClothesVariantProduct hinzuzufügen:

   • Relevanz ("Relevanz", Punktzahl)
   • name-asc ("Name (aufsteigend)", name)
   • name-desc ("Name (absteigend)", name)
   • price-asc ("Price (aufsteigend)", priceValue)
   • price-desc ("Preis (absteigend)", priceValue)
   HINWEIS

   Wählen Sie im Kontextmenü (in der Regel über Rechtsklick aufrufbar) Create Solr sort aus.

   Öffnen Sie für Hybris 5.0.0 die Registerkarte Indexed Types, doppelklicken Sie auf ClothesVariantProduct, dann auf die Registerkarte SOLR Sort.

   

7. Legen Sie auf der Registerkarte Indizierte Typen unter Zusammengestellter Typ den folgenden Wert fest:

   Product - Product

8. Passen Sie auf der Registerkarte Indizierte Typen die Indexerabfragen für full an:

   SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}})
   

9. Passen Sie auf der Registerkarte Indizierte Typen die Indexerabfragen für incremental an:

   SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}}) AND {modifiedtime} <= ?lastIndexTime
   

10. Passen Sie auf der Registerkarte Indizierte Typen die Facette category an. Doppelklicken Sie auf den letzten Eintrag in der „category“-Liste, um die Registerkarte Indizierte Eigenschaft zu öffnen:

    HINWEIS

    Stellen Sie bei Hybris 5.2 sicher, dass das Attribut Facet in der Tabelle „Eigenschaften“ entsprechend folgendem Screenshot ausgewählt ist:

    

11. Öffnen Sie die Registerkarte Facetteneinstellungen und passen Sie die Feldwerte an:

    

12. Speichern Sie die Änderungen.

13. Passen Sie über SOLR-Elementtypen die Facette price entsprechend den folgenden Screenshots an. Doppelklicken Sie wie bei category auf price, um die Registerkarte Indizierte Eigenschaft zu öffnen:

    

14. Öffnen Sie die Registerkarte Facetteneinstellungen und passen Sie die Feldwerte an:

    

15. Speichern Sie die Änderungen.

16. Öffnen System, Facettensuche, dann Indexer-Vorgangsassistent. Starten Sie einen Cronjob:

    • Indexervorgang: full
    • Solr-Konfiguration: Sample Solr Config for Clothes

Konfigurieren der Katalogversion

Sie können die importierte Katalogversion (hybris.catalog.version) für den OSGi-Service konfigurieren:

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

Katalogversion wird in der Regel entweder auf Online oder Staged (Standard) festgelegt.

Die Protokollausgabe liefert Feedback zu den erstellten Seiten und Komponenten und meldet mögliche Fehler.

Konfigurieren der Importstruktur

Die folgende Liste zeigt eine Beispielstruktur (von Assets, Seiten und Komponenten), die standardmäßig erstellt wird:

+ /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"
              + ...

Solch eine Struktur wird vom OSGi-Service DefaultImportHandler erstellt, der die Schnittstelle ImportHandler implementiert. Der eigentliche Importeur ruft einen Import-Handler auf, um Produkte, Produktvarianten, Kategorien, Assets usw. zu erstellen.

Die beim Import zu erzeugende Struktur kann für Folgendes konfiguriert werden:

``Day CQ Commerce Hybris Default Import Handler
(com.adobe.cq.commerce.hybris.importer.DefaultImportHandler)

In AEM können Sie die Konfigurationseinstellungen für solche Services auf unterschiedliche Weise vornehmen. Umfassende Informationen finden Sie unter Konfigurieren von OSGi. Darüber hinaus enthält die Konsole eine vollständige Liste mit den konfigurierbaren Parametern und den dazugehörigen Standardwerten.

Konfigurieren der zu ladenden Produktattribute

Der Antwort-Parser kann so konfiguriert werden, dass er die Eigenschaften und Attribute definiert, die für (Varianten-)Produkte geladen werden sollen:

1. Konfigurieren Sie das OSGi-Bundle:

   Day CQ Commerce Hybris Default Response Parser
   (com.adobe.cq.commerce.hybris.impl.importer.DefaultResponseParser)

   Hier können Sie verschiedene Optionen und Attribute definieren, die für das Laden und Zuordnungen benötigt werden.

   HINWEIS

   In AEM können Sie die Konfigurationseinstellungen für solche Services auf unterschiedliche Weise vornehmen. Umfassende Informationen finden Sie unter Konfigurieren von OSGi. Darüber hinaus enthält die Konsole eine vollständige Liste mit den konfigurierbaren Parametern und den dazugehörigen Standardwerten.

Importieren der Produktdaten

Es gibt verschiedene Möglichkeiten, die Produktdaten zu importieren. Die Produktdaten können beim erstmaligen Einrichten der Umgebung oder nach Änderungen in den hybris-Daten importiert werden:

• Vollständiger Import
• Inkrementeller Import
• Express-Update

Die Produktdaten, die tatsächlich von Hybris importiert wurden, werden im Repository unter folgendem Pfad gespeichert:

/etc/commerce/products

Die folgenden Eigenschaften geben die Verknüpfung mit Hybris an:

• commerceProvider
• cq:hybrisCatalogId
• cq:hybrisProductID

Vollständiger Import

1. Falls erforderlich, löschen Sie alle vorhandenen Produktdaten mit CRXDE Lite.

   1. Navigieren Sie zur Unterstruktur mit den Produktdaten:

      /etc/commerce/products

      Beispiel:

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

   2. Löschen Sie den Knoten, in dem die Produktdaten gespeichert sind, z. B. outdoors.

   3. Klicken Sie auf Alle speichern, um die Änderung zu übernehmen.

2. Öffnen Sie das Hybris-Import-Tool in AEM:

   /etc/importers/hybris.html

   Beispiel:

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

3. Konfigurieren Sie die erforderlichen Parameter. Beispiel:

   

4. Klicken Sie auf Katalog importieren, um den Import zu starten.

   Nach dem Abschluss des Importvorgangs können Sie die Daten hier überprüfen:

       /etc/commerce/products/outdoors
   

   Sie können den Pfad in CRXDE Lite öffnen, z. B.:

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

Inkrementeller Import

1. Überprüfen Sie die in AEM gespeicherten Informationen auf das/die relevante(n) Produkt(e) im entsprechenden Unterbaum unter:

   /etc/commerce/products

   Sie können den Pfad in CRXDE Lite öffnen, z. B.:

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

2. Aktualisieren Sie in Hybris die gespeicherten Daten zu den relevanten Produkten.

3. Öffnen Sie das Hybris-Import-Tool in AEM:

   /etc/importers/hybris.html

   Beispiel:

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

4. Wählen Sie das Kontrollkästchen aus Inkrementeller Import.

5. Klicken Sie auf Katalog importieren, um den Import zu starten.

   Nach Abschluss des Importvorgangs können Sie die aktualisierten Daten in AEM unter folgendem Pfad überprüfen:

       /etc/commerce/products
   

Express-Update

Der Importvorgang kann lange dauern. Als Erweiterung der Produktsynchronisierung können Sie daher bestimmte Bereiche des Katalogs für ein Express-Update auswählen, das manuell ausgelöst wird. Dabei wird der Export-Feed zusammen mit der Konfiguration der Standardattribute verwendet.

1. Überprüfen Sie die in AEM gespeicherten Informationen auf das/die relevante(n) Produkt(e) im entsprechenden Unterbaum unter:

   /etc/commerce/products

   Sie können den Pfad in CRXDE Lite öffnen, z. B.:

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

2. Aktualisieren Sie in Hybris die gespeicherten Daten zu den relevanten Produkten.

3. Fügen Sie in Hybris die Produkte zur Express-Warteschlange hinzu, z. B.:

   

4. Öffnen Sie das Hybris-Import-Tool in AEM:

   /etc/importers/hybris.html

   Beispiel:

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

5. Wählen Sie das Kontrollkästchen aus Express Update.

6. Klicken Sie auf Katalog importieren, um den Import zu starten.

   Nach Abschluss des Importvorgangs können Sie die aktualisierten Daten in AEM unter folgendem Pfad überprüfen:

       /etc/commerce/products
   

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

Konfigurieren des Katalog-Import-Tools

Sie können den Hybris-Katalog in AEM importieren. Nutzen Sie dazu das Batch-Import-Tool für Hybris-Kataloge, -Kategorien und -Produkte.

Die vom Import-Tool verwendeten Parameter können für Folgendes konfiguriert werden:

Day CQ Commerce Hybris Catalog Importer
( com.adobe.cq.commerce.hybris.impl.importer.DefaultHybrisImporter)

In AEM können Sie die Konfigurationseinstellungen für solche Services auf unterschiedliche Weise vornehmen. Umfassende Informationen finden Sie unter Konfigurieren von OSGi. Darüber hinaus enthält die Konsole eine vollständige Liste mit den konfigurierbaren Parametern und den dazugehörigen Standardwerten.

Katalogimport

Das hybris-Paket enthält ein Katalog-Importer zum Einrichten der anfänglichen Seitenstruktur.

Dies ist verfügbar unter:

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

Sie müssen die folgenden Informationen angeben:

• Basisspeicher
  Die ID des in Hybris konfigurierten Basisspeichers.

• Katalog
  Die ID des zu importierenden Katalogs.

• Stammverzeichnis
  Der Pfad, in den der Katalog importiert werden soll.

Entfernen eines Produkts aus dem Katalog

So entfernen Sie ein oder mehrere Produkte aus dem Katalog:

1. Konfigurieren des für den OSGi-Dienst Day CQ Commerce Hybris Catalog Importer; Siehe auch Konfigurieren des Katalog-Importers.

   Aktivieren Sie die folgenden Eigenschaften:

   • Produktaktivierung aktivieren
   • Entfernen von Produkt-Assets aktivieren
   HINWEIS

   In AEM können Sie die Konfigurationseinstellungen für solche Services auf unterschiedliche Weise vornehmen. Umfassende Informationen finden Sie unter Konfigurieren von OSGi. Darüber hinaus enthält die Konsole eine vollständige Liste mit den konfigurierbaren Parametern und den dazugehörigen Standardwerten.

2. Initialisieren Sie das Import-Tool, indem Sie zwei inkrementelle Aktualisierungen durchführen (siehe Katalogimport):

   • Die erste Ausführung resultiert in einigen geänderten Produkten – aufgeführt in der Protokollliste.
   • Zum zweiten Mal sollten keine Produkte aktualisiert werden.
   HINWEIS

   Der erste Import besteht darin, die Produktinformationen zu initialisieren. Der zweite Import überprüft, ob alles funktioniert hat und das Produkt fertig ist.

3. Überprüfen Sie die Kategorieseite mit dem Produkt, das Sie entfernen möchten. Die Produktdetails sollten sichtbar sein.

   Beispielsweise zeigt die folgende Kategorie Details zum Cajamara-Produkt:

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

4. Entfernen Sie das Produkt in der hybris-Konsole. Ändern Sie mit der Option Genehmigungsstatus ändern den Status in unapproved. Das Produkt wird aus dem Live-Feed entfernt.

   Beispiel:

   • Öffnen Sie die Seite http://localhost:9001/productcockpit.
   • Wählen Sie den Katalog Outdoors Staged aus.
   • Suchen Sie nach Cajamara.
   • Wählen Sie dieses Produkt aus und ändern Sie den Genehmigungsstatus in unapproved.

5. Führen Sie eine weitere inkrementelle Aktualisierung durch (siehe Katalogimport). Das Protokoll listet das gelöschte Produkt auf.

6. Rollout den entsprechenden Katalog. Die Produkt- und Produktseite wurde aus AEM entfernt.

   Beispiel:

   • Öffnen Sie:

     http://localhost:4502/aem/catalogs.html/content/catalogs/geometrixx-outdoors-hybris

   • Führen Sie den Rollout des Katalogs Hybris Base durch.

   • Öffnen Sie:

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

   • Das Produkt Cajamara wurde aus der Kategorie Bike entfernt.

7. So aktivieren Sie das Produkt erneut:

   1. Ändern Sie in Hybris den Genehmigungsstatus zurück in Genehmigt.

   2. AEM:

      1. inkrementelle Aktualisierung durchführen
      2. Führen Sie erneut den Rollout des entsprechenden Katalogs durch.
      3. Aktualisieren der entsprechenden Kategorieseite

Hinzufügen der Auftragsverlaufseigenschaft zum ClientContext

So fügen Sie einen Auftragsverlauf zum Client Context hinzu:

1. Öffnen Sie die Client Context-Designseite auf eine der folgenden Arten:

   • Öffnen Sie eine Seite für die Bearbeitung und anschließend Client Context mit Strg+Alt+C (Windows) oder Ctrl+Wahltaste+C (Mac). Klicken Sie in der linken oberen Ecke von Client Context auf das Stiftsymbol, um die ClientContext-Design-Seite zu öffnen.
   • Direktes Navigieren zu http://localhost:4502/etc/clientcontext/default/content.html

2. Fügen Sie die Auftragsverlauf component der Warenkorb t -Komponente des ClientContext.

3. Sie können bestätigen, dass im Client-Kontext Details zum Auftragsverlauf angezeigt werden. Beispiel:

   1. Öffnen Sie die Client-Kontext.

   2. Fügen Sie dem Warenkorb einen Artikel hinzu.

   3. Beenden Sie den Checkout.

   4. Überprüfen Sie den Client-Kontext.

   5. Fügen Sie dem Warenkorb ein weiteres Element hinzu.

   6. Navigieren Sie zur Checkout-Seite:

      • Der Client Context zeigt eine Zusammenfassung des Auftragsverlaufs an.
      • Die Nachricht „Sie sind ein wiederkehrender Kunde“ wird angezeigt.
   HINWEIS

   So wird die Nachricht realisiert:

   • Navigieren Sie zu http://localhost:4502/content/campaigns/geometrixx-outdoors/hybris-returning-customer.html.

     Die Kampagne besteht aus einem Erlebnis.

   • Klicken Sie auf das Segment (http://localhost:4502/etc/segmentation/geometrixx-outdoors/returning-customer.html).

   • Das Segment basiert auf der Eigenschaft Order History Property.