DocumentazioneCommerce“Guida Catalog Service”

Onboarding e installazione

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore

Installa Catalog Service per richiedere e ricevere i dati di prodotto da un'istanza di Commerce utilizzando l'API GraphQL di Catalog Service. Catalog Service viene fornito come metapacchetto del compositore dall’archivio repo.magento.com.

NOTE
Se la tua istanza di Commerce utilizza Live Search o Product Recommendations, il Servizio catalogo viene installato o aggiornato automaticamente quando effettui l’onboarding o l’aggiornamento di tali servizi. Per informazioni dettagliate, vedere le istruzioni di installazione per Live Search e Product Recommendations.

Requisiti di sistema

Requisiti software

  • Adobe Commerce 2.4.4+
  • PHP 8.1, 8.2, 8.3
  • Compositore: 2.x

Piattaforme supportate

  • Adobe Commerce sull’infrastruttura cloud: 2.4.4+
  • Adobe Commerce on-premise: 2.4.4+

Endpoint

Catalog Service ha due endpoint disponibili per l'onboarding:

  • Sandbox (https://catalog-service-sandbox.adobe.io/graphql): utilizzata per il test e la convalida prima della pubblicazione
  • Produzione (https://catalog-service.adobe.io/graphql): utilizzato per il traffico in tempo reale per i commercianti e i siti Web Commerce

Tutte le istanze di test di Commerce utilizzano l’endpoint Sandbox.

Esegui tutti i test di carico sull’endpoint Sandbox. Prima di iniziare il test di caricamento, invia un ticket di supporto in modo che il team dei servizi possa prevedere il traffico server aggiuntivo.

Installazione e configurazione

Per iniziare a utilizzare Catalog Service per Adobe Commerce, sono necessari i seguenti passaggi:

  • Installa l'estensione del servizio catalogo (magento/catalog-service)
  • Configurare il servizio e l’esportazione dei dati
  • Accedere al servizio

Installare l’estensione Catalog Service

recommendation-more-help

Prerequisito

style
shade-box

Installare la versione più recente dell'estensione Catalog Services (magento/catalog-service) in un'istanza di Adobe Commerce che esegue Adobe Commerce versione 2.4.4 o successiva. Catalog Service viene distribuito come metapacchetto del compositore dall'archivio repo.magento.com.

Infrastruttura cloud

Utilizzare questo metodo per installare Catalog Service 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. Aggiungi il modulo Catalog Service.

    code language-bash 
    composer require magento/catalog-service --no-update

  4. Aggiornare le dipendenze del pacchetto.

    code language-bash 
    composer update "magento/catalog-service"

  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 service 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 Service per un'istanza locale.

  1. Utilizza Composer per aggiungere il modulo Catalog Service al progetto:

    code language-bash 
    composer require magento/catalog-service --no-update

  2. Aggiorna le dipendenze e installa l’estensione:

    code language-bash 
    composer update  "magento/catalog-service"

  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.

Configurare il servizio e l’esportazione dei dati

Dopo aver installato Catalog Service, completa le seguenti attività per integrare il servizio Catalog con l'istanza Adobe Commerce. Questa integrazione consente la sincronizzazione dei dati e la comunicazione tra l’istanza di Commerce, Catalog Service e altri servizi di supporto. La sincronizzazione dei dati è gestita dall'estensione SaaS Data Export.

  1. Configurare Commerce Services Connector specificando le chiavi API e selezionando uno spazio dati SaaS.

    La configurazione del Connettore servizi Commerce è un processo una tantum necessario per utilizzare i servizi Adobe Commerce come Catalog Service, Live Search e Product Recommendations. Se hai già configurato il connettore per un altro servizio, salta questo passaggio.

  2. Eseguire una sincronizzazione dati iniziale dal dashboard di gestione dati.

    La sincronizzazione iniziale può richiedere da alcuni minuti ad ore, a seconda della dimensione del catalogo. Puoi monitorare lo stato della sincronizzazione dal dashboard Gestione dati. Dopo la sincronizzazione iniziale, il catalogo esporta i dati dei prodotti su base continuativa per mantenere aggiornati i servizi.

    note note
    NOTE
    È inoltre possibile avviare la sincronizzazione iniziale dalla riga di comando utilizzando Commerce CLI. Vedere Sincronizzazione iniziale nella Guida all'esportazione dei dati SaaS.

Per garantire il corretto funzionamento dell’esportazione del catalogo:

  • Verificare che i processi cron siano in esecuzione.
  • Verificare che gli indicizzatori siano in esecuzione da Admin o utilizzando il comando CLI di Commerce bin/magento indexer:info.
  • Verificare che gli indici Catalog Attributes Feed, Product Feed, Product Overrides Feed e Product Variant Feed siano impostati su Update by Schedule.

Monitoraggio e risoluzione dei problemi di sincronizzazione dei dati

L'amministratore di Commerce può monitorare il processo di sincronizzazione utilizzando Data Management Dashboard. Utilizza Commerce CLI e i registri per gestire il processo e risolverlo.

Accedere al servizio

L'API GraphQL Catalog Service è accessibile dall'endpoint https://catalog-service.adobe.io/graphql utilizzando i comandi POST tramite HTTPS.

Nelle query GraphQL, devi specificare più intestazioni HTTP, inclusa la chiave API pubblica aggiunta alla configurazione del connettore di servizi Adobe Commerce nell’amministratore. Per informazioni dettagliate, vedere la documentazione di Servizi Storefront GraphQL.

Configurazione del firewall

Per consentire a Catalog Service di attraversare un firewall, aggiungere commerce.adobe.io al inserisco nell'elenco Consentiti di.

Catalog Service e Mesh API

La rete API per Adobe Developer App Builder consente agli sviluppatori di integrare API private o di terze parti e altre interfacce con i prodotti Adobe utilizzando Adobe IO.

Per informazioni dettagliate sull'installazione e la configurazione, vedere l'argomento Catalog Service and API Mesh.

Dashboard di gestione dati

Per ulteriori informazioni sulla sincronizzazione dei dati di Catalog Service, vedere Dashboard di gestione dei dati.

7c786b3e-f793-4e26-b38a-3fe76d8eca72