DocumentazioneAEM 6.5Guida utente

SAP Commerce Cloud sap-commerce-cloud

Ultimo aggiornamento: 30 luglio 2026
  • Si applica a:
  • Experience Manager 6.5

Creato per:

  • Admin
  • Developer

Dopo l’installazione è possibile configurare l’istanza:

  1. Configura la ricerca con facet per Geometrixx Outdoors.
  2. Configura la versione del catalogo.
  3. Configura la struttura di importazione.
  4. Configurare gli attributi del prodotto da caricare.
  5. Importazione dei dati di prodotto.
  6. Configura Importazione catalogo.
  7. Utilizza l’importazione per importare il catalogo in una posizione specifica in AEM.

Configurare la ricerca con facet per Geometrixx Outdoors configure-the-facetted-search-for-geometrixx-outdoors

NOTE
Non è necessario per l'ibrido 5.3.0.1 e versioni successive.

  1. Nel browser, accedi alla console di gestione Hybris all’indirizzo:

    http://localhost:9001/hmc/hybris

  2. Dalla barra laterale, seleziona Sistema, quindi Ricerca facet, quindi Configurazione ricerca facet.

  3. Apri editor per la Configurazione Solr di esempio per clothescatalog.

  4. In Versioni catalogo utilizzare Aggiungi versione catalogo per aggiungere outdoors-Staged e outdoors-Online all’elenco.

  5. Salva la configurazione.

  6. Apri Tipi di elementi SOLR per aggiungere Ordini SOLR a ClothesVariantProduct:

    • rilevanza (“Rilevanza”, punteggio)
    • name-asc (“Name (ascending)”, name)
    • name-desc (“Name (descending)”, name)
    • price-asc (“Price (ascending)”, priceValue)
    • price-desc (“Prezzo (decrescente)”, priceValue)
    note
    NOTE
    Utilizzare il menu di scelta rapida, in genere facendo clic con il pulsante destro del mouse, per selezionare Create Solr sort.
    In Hybris 5.0.0 aprire la scheda Indexed Types, fare doppio clic su ClothesVariantProduct, quindi sulla scheda SOLR Sort.

    chlimage1-36

  7. Nella scheda Tipi indicizzati, impostare Tipo composto su:

    Product - Product

  8. Nella scheda Tipi indicizzati, regola le query indicizzatore per full:

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

  9. Nella scheda Tipi indicizzati, regola le query indicizzatore per incremental:

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

  10. Nella scheda Tipi indicizzati, regola il facet category. Fare doppio clic sull’ultima voce nell’elenco delle categorie per aprire la scheda Proprietà indicizzata:

    note
    NOTE
    Per hybris 5.2 assicurati che l'attributo Facet nella tabella Proprietà sia selezionato in base alla schermata seguente:

    chlimage1-37 chlimage1-38

  11. Apri la scheda Impostazioni facet e regola i valori dei campi:

    chlimage1-39

  12. Salva le modifiche.

  13. Di nuovo da Tipi di elementi SOLR, regola il facet price in base alle schermate seguenti. Come per category, fare doppio clic su price per aprire la scheda Proprietà indicizzata:

    chlimage1-40

  14. Apri la scheda Impostazioni facet e regola i valori dei campi:

    chlimage1-41

  15. Salva le modifiche.

  16. Aprire Sistema, Ricerca facet, quindi Procedura guidata operazione indicizzatore. Avvia un processo cronico:

    • Operazione indicizzatore: full
    • Configurazione Solr: Sample Solr Config for Clothes

Configurare la versione del catalogo configure-the-catalog-version

La versione del catalogo ( hybris.catalog.version) importata può essere configurata per il servizio OSGi:

Configurazione Hybris per Commerce CQ di giorni
( com.adobe.cq.commerce.hybris.common.DefaultHybrisConfigurationService)

Versione catalogo è impostata su Online o Staged (impostazione predefinita).

NOTE
Quando si lavora con AEM, sono disponibili diversi metodi di gestione delle impostazioni di configurazione per tali servizi. Per informazioni dettagliate, vedere Configurazione di OSGi. Consulta anche la console per un elenco completo dei parametri configurabili e dei relativi valori predefiniti.

L’output del registro fornisce feedback sulle pagine e sui componenti creati e segnala potenziali errori.

Configurare la struttura di importazione configure-the-import-structure

L’elenco seguente mostra una struttura di esempio (di risorse, pagine e componenti) creata per impostazione predefinita:

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

Tale struttura viene creata dal servizio OSGi DefaultImportHandler che implementa l’interfaccia ImportHandler. Un gestore di importazione viene chiamato dall’effettivo importatore per creare prodotti, varianti di prodotto, categorie, risorse e così via.

NOTE
Puoi personalizzare questo processo implementando un tuo gestore di importazione.

La struttura da generare durante l’importazione può essere configurata per:

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

Quando si lavora con AEM, sono disponibili diversi metodi di gestione delle impostazioni di configurazione per tali servizi. Per informazioni dettagliate, vedere Configurazione di OSGi. Consulta anche la console per un elenco completo dei parametri configurabili e dei relativi valori predefiniti.

Configurare gli attributi del prodotto da caricare configure-the-product-attributes-to-load

Il parser di risposta può essere configurato per definire le proprietà e gli attributi da caricare per i prodotti (varianti):

  1. Configura il bundle OSGi:

    Parser di risposta predefinito Commerce Hybris per CQ Day
    (com.adobe.cq.commerce.hybris.impl.importer.DefaultResponseParser)

    Qui puoi definire varie opzioni e attributi necessari per il caricamento e la mappatura.

    note
    NOTE
    Quando si lavora con AEM, sono disponibili diversi metodi di gestione delle impostazioni di configurazione per tali servizi. Per informazioni dettagliate, vedere Configurazione di OSGi. Consulta anche la console per un elenco completo dei parametri configurabili e dei relativi valori predefiniti.

Importazione dei dati di prodotto importing-the-product-data

Esistono diversi modi per importare i dati del prodotto. I dati del prodotto possono essere importati durante la configurazione iniziale dell’ambiente o dopo aver apportato modifiche ai dati ibridi:

Le informazioni effettive sul prodotto importate da hybris sono conservate nell’archivio in:

/etc/commerce/products

Le seguenti proprietà indicano il collegamento con l’ibrido:

  • commerceProvider
  • cq:hybrisCatalogId
  • cq:hybrisProductID
NOTE
L'implementazione hybris (ovvero geometrixx-outdoors/en_US) memorizza solo gli ID prodotto e altre informazioni di base in /etc/commerce.
Ogni volta che vengono richieste informazioni su un prodotto, viene fatto riferimento al server ibrido.

Importazione completa full-import

  1. Se necessario, elimina tutti i dati di prodotto esistenti utilizzando CRXDE Lite.

    1. Passare alla sottostruttura contenente i dati del prodotto:

      /etc/commerce/products

      Ad esempio:

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

    2. Eliminare il nodo che contiene i dati del prodotto, ad esempio outdoors.

    3. Salva tutto per mantenere la modifica.

  2. Apri l’importazione ibridi in AEM:

    /etc/importers/hybris.html

    Ad esempio:

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

  3. Configura i parametri richiesti, ad esempio:

    chlimage1-42

  4. Fai clic su Importa catalogo per avviare l’importazione.

    Una volta completato, puoi verificare i dati importati in:

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

    Puoi aprirlo in CRXDE Lite; ad esempio:

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

Importazione incrementale incremental-import

  1. Controlla le informazioni contenute in AEM per i prodotti pertinenti, nel sottoalbero appropriato in:

    /etc/commerce/products

    Puoi aprirlo in CRXDE Lite; ad esempio:

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

  2. In hybris, aggiornare le informazioni contenute sui prodotti rilevanti.

  3. Apri l’importazione ibridi in AEM:

    /etc/importers/hybris.html

    Ad esempio:

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

  4. Selezionare la casella di controllo Importazione incrementale.

  5. Fai clic su Importa catalogo per avviare l’importazione.

    Una volta completato, puoi verificare i dati aggiornati in AEM in:

    code language-none 
        /etc/commerce/products

Aggiornamento rapido express-update

Il processo di importazione può richiedere molto tempo, pertanto come estensione della sincronizzazione di prodotto puoi selezionare aree specifiche del catalogo per un aggiornamento rapido che viene attivato manualmente. Questo utilizza il feed di esportazione insieme alla configurazione degli attributi standard.

  1. Controlla le informazioni contenute in AEM per i prodotti pertinenti, nel sottoalbero appropriato in:

    /etc/commerce/products

    Puoi aprirlo in CRXDE Lite; ad esempio:

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

  2. In hybris, aggiornare le informazioni contenute sui prodotti rilevanti.

  3. In modalità ibrida, aggiungi uno o più prodotti alla coda Express; ad esempio:

    chlimage1-43

  4. Apri l’importazione ibridi in AEM:

    /etc/importers/hybris.html

    Ad esempio:

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

  5. Selezionare la casella di controllo Aggiornamento rapido.

  6. Fai clic su Importa catalogo per avviare l’importazione.

    Una volta completato, puoi verificare i dati aggiornati in AEM in:

    code language-none 
        /etc/commerce/products

Configurare la funzione di importazione catalogo configure-the-catalog-importer

Il catalogo ibrido può essere importato in AEM utilizzando l’importazione batch per i cataloghi ibridi, le categorie e i prodotti.

I parametri utilizzati dall’importazione possono essere configurati per:

Importazione catalogo ibrido Commerce CQ giorno
( com.adobe.cq.commerce.hybris.impl.importer.DefaultHybrisImporter)

Quando si lavora con AEM, sono disponibili diversi metodi di gestione delle impostazioni di configurazione per tali servizi. Per informazioni dettagliate, vedere Configurazione di OSGi. Consulta anche la console per un elenco completo dei parametri configurabili e dei relativi valori predefiniti.

Importazione catalogo catalog-import

Il pacchetto hybris viene fornito con un’importazione di cataloghi per la configurazione della struttura della pagina iniziale.

È disponibile all’indirizzo:

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

ecommerce importconsole

Devono essere fornite le seguenti informazioni:

  • Archivio di base
    Identificatore dell’archivio base configurato in hybris.

  • Catalogo
    Identificatore del catalogo da importare.

  • Percorso principale
    Percorso in cui importare il catalogo.

Rimozione di un prodotto dal catalogo removing-a-product-from-the-catalog

Per rimuovere uno o più prodotti dal catalogo:

  1. Configurare per il servizio OSGi Day CQ Commerce Hybris Catalog Importer; vedere anche Configurare Catalog Importer.

    Attiva le seguenti proprietà:

    • Abilita rimozione prodotto
    • Abilita rimozione risorse prodotto
    note
    NOTE
    Quando si lavora con AEM, sono disponibili diversi metodi di gestione delle impostazioni di configurazione per tali servizi. Per informazioni dettagliate, vedere Configurazione di OSGi. Consulta anche la console per un elenco completo dei parametri configurabili e dei relativi valori predefiniti.

  2. Inizializza l’importazione eseguendo due aggiornamenti incrementali (vedi Importazione catalogo):

    • La prima esecuzione si traduce in un set di prodotti modificati, indicato nell’elenco dei registri.
    • Per la seconda volta, non è necessario aggiornare alcun prodotto.
    note
    NOTE
    La prima importazione consiste nell’inizializzare le informazioni sul prodotto. La seconda importazione verifica che tutto abbia funzionato e che il set di prodotti sia pronto.

  3. Controllare la pagina della categoria contenente il prodotto che si desidera rimuovere. I dettagli del prodotto devono essere visibili.

    Ad esempio, la seguente categoria mostra i dettagli del prodotto Cajamara:

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

  4. Rimuovi il prodotto nella console Hybris. Utilizzare l’opzione Modifica stato approvazione per impostare lo stato su unapproved. Il prodotto viene rimosso dal feed vivo.

    Ad esempio:

    • Apri la pagina http://localhost:9001/productcockpit
    • Seleziona il catalogo Outdoors Staged
    • Cerca Cajamara
    • Selezionare il prodotto e modificare lo stato di approvazione in unapproved

  5. Esegui un altro aggiornamento incrementale (vedi Importazione catalogo). Il registro elenca il prodotto eliminato.

  6. Rollout del catalogo appropriato. La pagina di prodotto e quella di prodotto sono state rimosse da AEM.

    Ad esempio:

  7. Per ripristinare il prodotto:

    1. In modalità ibrida, impostare di nuovo lo stato di approvazione su approvato

    2. In AEM:

      1. esegui un aggiornamento incrementale
      2. esegui nuovamente il rollout del catalogo appropriato
      3. aggiorna la pagina categoria appropriata

Aggiungi caratteristica cronologia ordini a ClientContext add-order-history-trait-to-the-client-context

Per aggiungere la cronologia degli ordini al contesto client:

  1. Aprire la pagina di progettazione del contesto client:

    • Apri una pagina per la modifica, quindi apri il contesto client utilizzando Ctrl-Alt-c (Windows) o Control-Option-c (Mac). Utilizza l’icona della matita nell’angolo in alto a sinistra del contesto client per aprire la pagina di progettazione di ClientContext.
    • Passa direttamente a http://localhost:4502/etc/clientcontext/default/content.html

  2. Aggiungere il componente Cronologia ordini al componente Auto acquisti t del contesto client.

  3. Puoi confermare che nel contesto del cliente sono visualizzati i dettagli della cronologia degli ordini. Ad esempio:

    1. Apri il contesto client.

    2. Aggiungi un articolo al carrello.

    3. Completa il pagamento.

    4. Controlla il contesto del client.

    5. Aggiungi un altro elemento al carrello.

    6. Passare alla pagina di pagamento:

      • Il contesto client mostra un riepilogo della cronologia degli ordini.
      • Viene visualizzato il messaggio “You’re a return customer” (Sei un cliente di ritorno).
    note
    NOTE
    Il messaggio viene realizzato da:
    La campagna è costituita da un’esperienza.
recommendation-more-help
experience-manager-65-help-main-toc