DokumentationAEM 6.4Administratorenanleitung

SAP Commerce Cloud sap-commerce-cloud

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Admin
CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

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 configure-the-facetted-search-for-geometrixx-outdoors

NOTE
Dies ist für hybris 5.3.0.1 und höher nicht erforderlich.

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

    chlimage_1-36

  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:

    code language-shell 
    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:

    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 „category“-Liste, 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. Doppelklicken Sie wie bei category 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 System, Facettensuche, dann Indexer-Vorgangsassistent. 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)

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

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 liefert Feedback zu den erstellten Seiten und Komponenten und meldet mögliche Fehler.

Konfigurieren der Importstruktur configure-the-import-structure

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.

NOTE
Sie können Anpassen dieses Prozesses durch Implementierung eines eigenen Import-Handlers.

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 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. Die Produktdaten können beim erstmaligen Einrichten der Umgebung oder nach Änderungen in den hybris-Daten importiert werden:

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 weitere grundlegende Daten unter /etc/commerce.
Der hybris-Server wird jedes Mal referenziert, wenn Informationen zu einem Produkt angefordert werden.

Vollständiger Import full-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:

    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 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:

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

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

    code language-none 
        /etc/commerce/products

    [](http://localhost:4502/crx/de/index.jsp#/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 enthält ein Katalog-Importer zum Einrichten der anfänglichen Seitenstruktur.

Dies ist verfügbar 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 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
    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):

    • Die erste Ausführung resultiert in einigen geänderten Produkten – aufgeführt in der Protokollliste.
    • Zum zweiten Mal sollten keine Produkte aktualisiert werden.
    note note
    NOTE
    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:

  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 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). 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.
    note note
    NOTE
    So wird die Nachricht realisiert:
recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8