DocumentazioneCommerceGuida Catalog Service

Catalog Service per Adobe Commerce

Last update: Tue May 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:
  • Servizio catalogo

Creato per:

  • Amministratore
  • Sviluppatore

L'estensione Catalog Service per Adobe Commerce fornisce dati di catalogo avanzati per modelli di visualizzazione (sola lettura) per riprodurre in modo rapido e completo le esperienze della vetrina relative ai prodotti, tra cui:

  • Pagine dettagli prodotto
  • Pagine di elenco prodotti e categorie
  • Search pagine dei risultati
  • Caroselli di prodotti
  • Pagine di confronto prodotti
  • Qualsiasi altra pagina che esegue il rendering dei dati di prodotto, come le pagine del carrello, dell'ordine e della lista dei desideri

Catalog Service utilizza GraphQL per richiedere e ricevere i dati del catalogo, inclusi prodotti, attributi di prodotto, inventario e prezzi. GraphQL è un linguaggio di query che un client front-end utilizza per comunicare con l’API (Application Programming Interface) definita su un back-end come Adobe Commerce. GraphQL è un metodo di comunicazione diffuso perché è leggero e consente a un integratore di sistemi di specificare il contenuto e l’ordine di ciascuna risposta.

Adobe Commerce dispone di due sistemi GraphQL. Il sistema GraphQL di base fornisce un’ampia gamma di query (operazioni di lettura) e mutazioni (operazioni di scrittura) che consentono a un acquirente di interagire con molti tipi di pagine, tra cui prodotto, account cliente, carrello, pagamento e altro ancora. Tuttavia, le query che restituiscono le informazioni sul prodotto non sono ottimizzate per la velocità. Il sistema GraphQL dei servizi può eseguire query solo sui prodotti e sulle informazioni correlate. Queste query sono più performanti di query di base simili.

I dati disponibili per il servizio catalogo vengono forniti dall'estensione SaaS Data Export. Questa estensione sincronizza i dati tra Commerce applicazione e Commerce Services connessi per garantire che le query agli endpoint API GraphQL dei servizi restituiscano i dati di catalogo più aggiornati. Per informazioni sulla gestione e la risoluzione dei problemi relativi alle operazioni di esportazione dei dati SaaS, consulta la Guida🔗 all'esportazione dei dati SaaS.

I clienti Catalog Service possono utilizzare l'Indicizzatore prezzi SaaS, che fornisce aggiornamenti dei prezzi e tempi di sincronizzazione più rapidi.

Architettura

Il diagramma seguente mostra i due sistemi GraphQL:

Diagramma dellarchitettura del catalogo

Nel sistema GraphQL di base, PWA invia una richiesta all’applicazione Commerce, che riceve ogni richiesta, la elabora, eventualmente inviando una richiesta tramite più sottosistemi, quindi restituisce una risposta alla vetrina. Questo round trip può causare rallentamenti nei tempi di caricamento delle pagine, con possibili tassi di conversione più bassi.

Catalog Service è un gateway di servizi Storefront. Il servizio accede a un database separato contenente i dettagli del prodotto e le informazioni correlate, ad esempio attributi del prodotto, varianti, prezzi e categorie. Il servizio mantiene il database sincronizzato con Adobe Commerce tramite l’indicizzazione.
Poiché il servizio ignora la comunicazione diretta con l’applicazione, è in grado di ridurre la latenza del ciclo di richiesta e risposta.

I sistemi GraphQL di base e di servizio non comunicano direttamente tra loro. Puoi accedere a ogni sistema da un URL diverso e le chiamate richiedono informazioni di intestazione diverse. I due sistemi GraphQL sono progettati per essere utilizzati insieme. Il sistema GraphQL Catalog Service potenzia il sistema di base per rendere più veloci le esperienze di presentazione dei prodotti.

Facoltativamente, puoi implementare Mesh API per Adobe Developer App Builder per integrare i due sistemi Adobe Commerce GraphQL con API private e di terze parti e altre interfacce software tramite Adobe Developer. La mesh può essere configurata per garantire che le chiamate instradate a ciascun endpoint contengano le informazioni di autorizzazione corrette nelle intestazioni.

Dettagli architettonici

Le sezioni seguenti descrivono alcune delle differenze tra i due sistemi GraphQL.

Gestione schema

Poiché Catalog Service funziona come un servizio, gli integratori non devono preoccuparsi della versione sottostante di Commerce. La sintassi delle query è la stessa per tutte le versioni. Inoltre, lo schema è coerente per tutti i commercianti. Questa coerenza semplifica la definizione delle best practice e aumenta in modo significativo il riutilizzo dei widget della vetrina.

Semplificazione dei tipi di prodotto

Lo schema riduce la diversità dei tipi di prodotto a due casi d'uso:

  • I prodotti semplici sono prodotti definiti con un unico prezzo e quantità. Il servizio Catalogo mappa i tipi di prodotto semplici, virtuali, scaricabili e di scheda omaggio a simpleProductViews.

  • I prodotti complessi sono costituiti da più prodotti semplici. I prodotti semplici componenti possono avere prezzi diversi. Un prodotto complesso può anche essere definito in modo che l'acquirente possa specificare la quantità di componenti semplici prodotti. Catalog Service mappa i tipi di prodotto configurabili, raggruppati e raggruppati su complexProductViews.

Le opzioni di prodotto complesse sono unificate e si distinguono per il loro comportamento, non per il tipo. Ogni valore di opzione rappresenta un prodotto semplice. Questo valore di opzione ha accesso agli attributi di prodotto semplici, incluso il prezzo. Quando l’acquirente seleziona tutte le opzioni per un prodotto complesso, la combinazione di opzioni selezionate punta a un prodotto semplice specifico. Il prodotto semplice rimane ambiguo finché l’acquirente non seleziona un valore per tutte le opzioni disponibili.

Attributi di visualizzazione del prodotto

Sia i prodotti semplici che quelli complessi dispongono di attributi definiti dal cliente che possono essere visualizzati nella vetrina. Questi attributi vengono restituiti come ProductViewAttributes. In Adobe Systems Commerce, gli attributi disponibili vengono definiti al momento della creazione del prodotto. È possibile aggiungere attributi aggiuntivi dal back-end di Adobe Systems Commerce o a livello di programmazione. Consulta Estendere e personalizzare l'esportazione dei dati SaaS feed dati.

TIP
Invece di aggiungere tipi di dati al back-end di Commerce, è possibile utilizzare API Mesh con il servizio di catalogo per estendere lo schema GraphQL del servizio di catalogo per aggiungere dati o configurare i dati del catalogo esistenti per abilitare nuove funzionalità.

Prezzi

I prodotti semplici rappresentano l'unità di vendita di base che ha un prezzo. Catalog Service calcola il prezzo regolare prima degli sconti e il prezzo finale dopo gli sconti. I calcoli dei prezzi possono includere imposte sui prodotti fisse. Escludono le promozioni personalizzate.

Un prodotto complesso non ha un prezzo stabilito. Catalog Service restituisce invece i prezzi dei semplici collegati. Ad esempio, un commerciante può inizialmente assegnare gli stessi prezzi a tutte le varianti di un prodotto configurabile. Se determinate dimensioni o colori sono impopolari, il commerciante può ridurre i prezzi di tali varianti. Pertanto, il prezzo del prodotto complesso (configurabile) mostra inizialmente una fascia di prezzo, che riflette il prezzo di entrambe le varianti standard e impopolari. Dopo che l'acquirente ha selezionato un valore per tutte le opzioni disponibili, la vetrina visualizza un unico prezzo.

Catalog Service assicura aggiornamenti e calcoli accurati dei prezzi grazie al supporto di prezzi con valori elevati (fino a 16 cifre) e alta precisione decimale (fino a 4 cifre decimali).

NOTE
I clienti Commerce con Catalog Service possono sfruttare gli aggiornamenti più rapidi delle modifiche dei prezzi e i tempi di sincronizzazione sui loro siti Web con l'indicizzatore dei prezzi SaaS.

Implementazione

Solo PaaS

Il processo di installazione richiede la configurazione di Commerce Services Connector. Al termine, il passaggio successivo consiste nell'aggiornamento del codice della vetrina da parte di un integratore di sistemi per incorporare le query Catalog Service. Tutte le query Catalog Service vengono instradate al gateway GraphQL. L’URL viene fornito durante il processo di onboarding.

recommendation-more-help
caa758b0-fff2-4350-a281-16253ff7b81f