Adattatore catalogo

L'estensione Catalog Adapter disabilita l'indicizzatore prezzi prodotto predefinito incluso nell'applicazione Commerce e utilizza invece i prezzi forniti da Catalog Service.

La scheda è progettata per funzionare con l'esportazione dati SaaS e il servizio Adobe Commerce. L'esportazione dei dati SaaS è responsabile dell'invio dei prezzi e Catalog Adapter recupera tutti i prezzi dal servizio Adobe Commerce.

Quando si abilita Catalog Adapter, l'indicizzazione dei prezzi e le operazioni vengono influenzate nei seguenti modi:

  • L’indicizzatore prezzi incluso nell’applicazione Adobe Commerce è disabilitato.
  • I prezzi vengono gestiti tramite l'esportazione di dati SaaS e l'indicizzatore di prezzi SaaS.
  • Quando un cliente apre un prodotto, una categoria o un’altra pagina che mostra i prezzi dei prodotti, questi vengono recuperati dal servizio Adobe Commerce.
  • I prezzi vengono inviati al servizio Adobe Commerce sincronizzando i dati dall'esportazione di dati SaaS.
  • Il Checkout ricalcola i prezzi in modo dinamico.

È possibile riabilitare l'indicizzazione dei prezzi nell'applicazione Commerce rimuovendo o disabilitando l'estensione Catalog Adapter.

Requisiti

Installazione

L'estensione Catalog Adapter è un metapacchetto Compositore che installa i seguenti moduli:

  • Indicizzatore prezzi Disabler-Questo modulo disattiva l'indice dei prezzi nell'applicazione Commerce in modo che i prezzi vengano consegnati tramite l'indicizzazione dei prezzi SaaS. Impossibile attivare l'indicizzatore prezzi prodotto nell'applicazione Commerce quando è installata l'estensione per l'indicizzazione prezzi SaaS.
  • Provider prezzi-Questo modulo fornisce i prezzi per i prodotti del servizio Adobe Commerce. Crea la query di ricerca e ottiene i prezzi per i prodotti sul front-end.
  • Scheda di ricerca del servizio catalogo-Questo modulo trasferisce i prezzi dall'applicazione Adobe Commerce a un servizio Adobe Commerce in risposta a una richiesta di ricerca del prodotto.

Passaggi per l’installazione

Infrastruttura cloud

Utilizzare questo metodo per installare Catalog Adapter per un'istanza Commerce Cloud.

  1. Sulla workstation locale, passa alla directory del progetto per il progetto Adobe Commerce su infrastruttura cloud.

    note note
    NOTE
    Per informazioni sulla gestione locale degli ambienti di progetto Commerce, vedere Gestione dei rami con CLI nella Guida utente di Adobe Commerce on Cloud Infrastructure.
  2. Consulta il ramo dell’ambiente da aggiornare utilizzando Adobe Commerce Cloud CLI.

    code language-shell
    magento-cloud environment:checkout <environment-id>
    
  3. Aggiungere il modulo adattatore catalogo.

    code language-bash
    composer require magento/catalog-adapter --no-update
    
  4. Aggiornare le dipendenze del pacchetto.

    code language-bash
    composer update "magento/catalog-adapter"
    
  5. Modifiche al codice di commit e push per i file composer.json e composer.lock.

  6. Aggiungere, eseguire il commit e inviare le modifiche al codice per i file composer.json e composer.lock all'ambiente cloud.

    code language-shell
    git add -A
    git commit -m "Add catalog adapter module"
    git push origin <branch-name>
    

    Il push degli aggiornamenti all'ambiente cloud avvia il processo di distribuzione cloud di Commerce per applicare le modifiche. Controllare lo stato della distribuzione dal registro distribuzione.

Locale

Utilizzare questo metodo per installare Catalog Adapter per un'istanza locale.

  1. Aggiungi l'adattatore catalogo al progetto utilizzando il Compositore:

    code language-bash
    composer require magento/catalog-adapter --no-update
    
  2. Aggiorna le dipendenze e installa l’estensione:

    code language-bash
    composer update  "magento/catalog-adapter"
    
  3. Aggiorna Adobe Commerce:

    code language-bash
    bin/magento setup:upgrade
    
  4. Cancella la cache:

    code language-bash
    bin/magento cache:clean
    
    note tip
    TIP
    In alcuni casi, in particolare durante la distribuzione in produzione, potrebbe essere opportuno evitare di cancellare il codice compilato perché potrebbe richiedere del tempo. Prima di apportare qualsiasi modifica, assicurati di eseguire il backup del sistema.

Riattiva l’indicizzatore dei prezzi del prodotto Adobe Commerce

Se esistono applicazioni di terze parti che si basano sull’indicizzatore prezzi del prodotto Adobe Commerce predefinito, puoi abilitarlo nuovamente con i seguenti comandi:

# re-enable Product Price indexer
bin/magento module:disable Magento_PriceIndexerDisabler
# re-index Product Price indexer
bin/magento index:reindex catalog_product_price

Disattiva l'indicizzatore del prezzo del prodotto per lo scenario Headless Storefront

Se disponi di un’istanza Commerce headless, potresti dover disabilitare l’indicizzatore dei prezzi del prodotto Adobe Commerce per ridurre il carico sull’istanza Adobe Commerce. È possibile completare questa attività installando il modulo magento/module-price-indexer-disabler:

composer require magento/module-price-indexer-disabler

Scenari di utilizzo

Di seguito sono riportati alcuni scenari Catalog Adapter comuni.

Nessuna dipendenza dall’indicizzatore dei prezzi dei prodotti Adobe Commerce

  • Sei un commerciante Luma o Adobe Commerce Core GraphQL con installato un servizio richiesto (Live Search, Product Recommendations, Catalog Service)
  • Nessuna integrazione con estensioni di terze parti basate sull’indicizzatore dei prezzi del prodotto di Adobe Commerce
  1. Installa Catalog Adapter.

Con dipendenze dall’indicizzatore dei prezzi dei prodotti Adobe Commerce

  • Sei un commerciante Luma o Adobe Commerce Core GraphQL con installato un servizio supportato (Live Search, Product Recommendations, Catalog Service)
  • Puoi utilizzare un’estensione di terze parti basata sull’indicizzatore dei prezzi del prodotto Adobe Commerce
  1. Installa Catalog Adapter.
  2. Abilita nuovamente l’indicizzatore prezzi prodotto Adobe Commerce predefinito.

Istanze Commerce headless

  • Un commerciante con un’istanza Commerce headless con i servizi richiesti installati (Live Search, Product Recommendations, Catalog Service)
  • Nessuna dipendenza dall'indicizzatore prezzi prodotto Adobe Commerce predefinito
  1. Installa il modulo magento/module-price-indexer-disabler dal pacchetto Catalog Adapter.
recommendation-more-help
d84c01c7-401e-4340-8dad-f91bb65421cb