DokumentationAEM 6.5Benutzerhandbuch

SAP Commerce Cloud sap-commerce-cloud

Last update: Sun Mar 31 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

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 das Importtool zum Importieren des Katalogs an einen bestimmten Speicherort in AEM.

Konfigurieren der Facettensuche für Geometrixx Outdoors configure-the-facetted-search-for-geometrixx-outdoors

NOTE
Dies ist für Hybris 5.3.0.1 und spätere Versionen nicht erforderlich.

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

    http://localhost:9001/hmc/hybris

  2. Wählen Sie in der Seitenleiste System > Facettensuche > Konfiguration der Facettensuche aus.

  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:

    • relevance („Relevanz“, score)
    • name-asc („Name (aufsteigend)“, name)
    • name-desc („Name (absteigend)“, name)
    • price-asc („Preis (aufsteigend)“, priceValue)
    • price-desc („Preis (absteigend)“, priceValue)
    note note
    NOTE
    Wählen Sie im Kontextmenü (in der Regel über Rechtsklick aufrufbar) Create Solr sort aus.
    Für Hybris 5.0.0 öffnen Sie die Registerkarte Indexed Types, doppelklicken Sie auf ClothesVariantProduct, dann auf die Registerkarte SOLR Sort.

    chlimage_1-36

  7. Setzen Sie auf der Registerkarte Indizierte Typen den zusammengestellten Typ auf:

    Product - Product

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

    code language-shell 
    SELECT {pk} FROM {Product} WHERE {pk} NOT IN ({{SELECT {baseProductpk} FROM {variantproduct}}})

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

    code language-shell 
    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 Kategorieliste, um die Registerkarte Indizierte Eigenschaft zu öffnen:

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

    chlimage_1-37 chlimage_1-38

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

    chlimage_1-39

  12. Speichern Sie die Änderungen.

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

    chlimage_1-40

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

    chlimage_1-41

  15. Speichern Sie die Änderungen.

  16. Öffnen Sie System > Facettensuche > Indexervorgangsassistent. Starten Sie einen Cronjob:

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

Konfigurieren der Katalogversion configure-the-catalog-version

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)

Die Katalogversion ist entweder auf Online oder Staged (Standard) eingestellt.

NOTE
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.

Die Protokollausgabe bietet Feedback zu den erstellten Seiten und Komponenten und zeigt potenzielle Fehler auf.

Konfigurieren der Importstruktur configure-the-import-structure

Die folgende Auflistung 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. Ein Import-Handler wird vom eigentlichen Import-Tool aufgerufen, um Produkte, Produktvarianten, Kategorien, Assets usw. zu erstellen.

NOTE
Sie können diesen Prozess anpassen, indem Sie Ihren eigenen Import-Handler implementieren.

Die beim Importieren 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 configure-the-product-attributes-to-load

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.

    note note
    NOTE
    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 importing-the-product-data

Es gibt verschiedene Möglichkeiten, die Produktdaten zu importieren. Sie können die Produktdaten importieren, wenn Sie die Umgebung erstmalig einrichten oder nachdem Änderungen an den Hybris-Daten vorgenommen wurden:

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
NOTE
Die Hybris-Implementierung (d. h. geometrixx-outdoors/en_US) speichert nur Produkt-IDs und andere grundlegende Informationen unter /etc/commerce.
Der Hybris-Server wird immer dann referenziert, wenn Informationen zu einem Produkt angefordert werden.

Vollständiger Import full-import

  1. Löschen Sie ggf. 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, zum Beispiel:

    chlimage_1-42

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

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

    code language-none 
        /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 incremental-import

  1. Überprüfen Sie die Informationen für die relevanten Produkte in AEM in der entsprechenden Verzeichnisstruktur 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 Informationen zu den betreffenden Produkten.

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

    /etc/importers/hybris.html

    Beispiel:

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

  4. Aktivieren Sie das Kontrollkästchen 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:

    code language-none 
        /etc/commerce/products

Express-Update 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. Dafür wird der Export-Feed zusammen mit der Standard-Attributkonfiguration verwendet.

  1. Überprüfen Sie die Informationen für die relevanten Produkte in AEM in der entsprechenden Verzeichnisstruktur 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 Informationen zu den betreffenden Produkten.

  3. Fügen Sie in hybris ein oder mehrere Produkte zur Express-Warteschlange hinzu, zum Beispiel:

    chlimage_1-43

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

    /etc/importers/hybris.html

    Beispiel:

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

  5. Aktivieren Sie das Kontrollkästchen 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:

    code language-none 
        /etc/commerce/products

Konfigurieren des Katalog-Import-Tools configure-the-catalog-importer

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 catalog-import

Das Hybris-Paket umfasst ein Katalog-Importtool zum Einrichten der anfänglichen Seitenstruktur.

Verfügbar ist es unter:

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

ecommerceimportconsole

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 removing-a-product-from-the-catalog

So entfernen Sie ein oder mehrere Produkte aus dem Katalog:

  1. Konfigurieren Sie den OSGi-Dienst Day CQ Commerce Hybris Catalog Importer. Informationen hierzu finden Sie auch unter Konfigurieren des Katalog-Importtools.

    Aktivieren Sie die folgenden Eigenschaften:

    • Entfernen von Produkten aktivieren
    • Entfernen von Produkt-Assets aktivieren
    note note
    NOTE
    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):

    • Der erste Lauf führt zu einer Reihe von geänderten Produkten, die in der Protokollliste angezeigt werden.
    • Bei der zweiten Ausführung sollten keine Produkte aktualisiert werden.
    note note
    NOTE
    Der erste Importvorgang dient zur Initialisierung der Produktdaten. Der zweite Importvorgang überprüft, ob alles funktioniert hat und der Produktsatz bereit ist.

  3. Aktivieren Sie die Kategorieseite, die das Produkt enthält, das Sie entfernen möchten. Die Produktdetails sollten angezeigt werden.

    Beispielsweise zeigt die folgende Kategorie Details zum Produkt „Cajamara“:

    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. Führen Sie den Rollout für den entsprechenden Katalog durch. Das Produkt und die Produktseite wurden aus AEM entfernt.

    Beispiel:

  7. So aktivieren Sie das Produkt erneut:

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

    2. In AEM gilt:

      1. Führen Sie eine inkrementelle Aktualisierung durch.
      2. Führen Sie erneut den Rollout des entsprechenden Katalogs durch.
      3. Aktualisieren Sie die entsprechende Kategorieseite.

Fügen Sie eine Auftragsverlaufs-Eigenschaft zum Client-Kontext hinzu. add-order-history-trait-to-the-client-context

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). Verwenden Sie das Bleistiftsymbol in der oberen linken Ecke des Client-Kontextes, um die ClientContext-Design-Seite zu öffnen.
    • Navigieren Sie direkt zu http://localhost:4502/etc/clientcontext/default/content.html.

  2. Fügen Sie die Komponente Auftragsverlaufzur Komponente Warenkorb des Client-Kontexts hinzu.

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

    1. Öffnen Sie den 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 einen weiteren Artikel hinzu.

    6. Navigieren Sie zur Kasse:

      • Der Client Context zeigt eine Zusammenfassung des Auftragsverlaufs an.
      • Die Nachricht „Sie sind ein wiederkehrender Kunde“ wird angezeigt.
    note note
    NOTE
    So wird die Nachricht realisiert:
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2