Commerce Services Connector
Alcune funzionalità di Adobe Commerce e Magento Open Source sono basate su Commerce Services e distribuite come SaaS (software as a service). Per utilizzare questi servizi, è necessario connettere l'istanza Commerce utilizzando le chiavi API di produzione e sandbox e specificare lo spazio dati nella configurazione. È sufficiente configurare la connessione una sola volta per ogni istanza.
Servizi disponibili availableservices
Di seguito sono elencate le funzionalità di Commerce a cui è possibile accedere tramite Commerce Services Connector:
Architettura
A un livello avanzato, Commerce Services Connector è costituito dai seguenti elementi principali:
Le sezioni seguenti descrivono ciascuno di questi elementi in modo più dettagliato.
Credenziali apikey
Le chiavi API di produzione e sandbox sono generate dall'account Commerce del proprietario licenza. L'account Commerce è identificato da un ID Commerce univoco (MageID). Il proprietario della licenza per l’organizzazione del commerciante può generare chiavi API per servizi come Product Recommendations o Live Search, purché l’account sia in buono stato.
Le chiavi possono essere condivise in base alla necessità di sapere con l'integratore di sistemi o il team di sviluppo che gestisce progetti e ambienti per conto del titolare della licenza. Gli sviluppatori a cui il proprietario della licenza ha concesso Shared Access non possono generare le chiavi per loro conto anche se l'organizzazione del commerciante è presente nel menu a discesa Switch Accounts sul loro account.
Inoltre, gli integratori di soluzioni sono anche autorizzati a utilizzare Commerce Services. Se sei un integratore di soluzioni, il firmatario del contratto partner Commerce deve generare le chiavi API.
Generare le chiavi API di produzione e sandbox genapikey
-
Accedi al tuo account Commerce all'indirizzo https://account.magento.com.
-
Nella scheda Magento, seleziona Portale API nella barra laterale.
-
Dal menu Ambiente, seleziona Produzione o Sandbox.
-
Immetti un nome nella sezione Chiavi API e fai clic su Aggiungi nuovo per aprire la finestra di dialogo e scaricare la nuova chiave.
note warning WARNING Questa finestra di dialogo offre l’unica opportunità di copiare o scaricare le chiavi. -
Fai clic su Scarica, quindi su Annulla.
-
Ripeti i passaggi precedenti per ogni ambiente (produzione e sandbox).
Nella sezione Chiavi API sono ora visualizzate le chiavi API (pubbliche). Sono necessarie tutte e quattro le chiavi (sia quelle di produzione che quelle di sandbox, Public+Private) quando si seleziona o si crea un progetto SaaS in uno qualsiasi degli ambienti/installazioni associati alla licenza.
Configurazione SaaS saasenv
Commerce istanze devono essere configurate con un progetto SaaS e uno spazio dati SaaS in modo che Commerce Services possa inviare dati alla posizione giusta. Un progetto SaaS raggruppa tutti gli spazi di dati SaaS. Gli spazi di dati SaaS vengono utilizzati per raccogliere e archiviare dati che consentono il funzionamento di Commerce Services. Alcuni di questi dati possono essere esportati dall'istanza Commerce e altri possono essere raccolti dal comportamento dell'acquirente nella vetrina. Tali dati vengono quindi salvati in modo permanente nell’archiviazione cloud protetta.
Per Product Recommendations, lo spazio dati SaaS contiene dati di catalogo e comportamentali. È possibile indirizzare un'istanza Commerce a uno spazio dati SaaS selezionandola nella configurazione Commerce.
In questo caso, invia una richiesta di supporto per richiedere la pulizia dei dati.
Provisioning dello spazio dati SaaS
Tutti i commercianti di Adobe Commerce possono accedere a uno spazio di dati di produzione e due spazi di dati di test per ciascun progetto SaaS.
È possibile utilizzare gli spazi di dati di test in qualsiasi ambiente non di produzione, purché non si utilizzi lo stesso spazio di dati in più ambienti contemporaneamente. Per utilizzare lo spazio dati di test in un ambiente diverso, eseguire una pulizia dei dati prima di selezionare e configurare lo spazio dati in tale ambiente.
Per i progetti Adobe Commerce Cloud Pro con più ambienti di gestione temporanea, è possibile richiedere spazi dati di test aggiuntivi per ogni ambiente di gestione temporanea inviando una richiesta di supporto. Tuttavia, se disponi di un solo ambiente di staging e richiedi spazi di dati di test aggiuntivi, disponi delle seguenti opzioni:
- Contatta il team Customer Success o il Customer Success Manager designato per richiedere un ulteriore ambiente di staging. Ciò comporta un costo aggiuntivo.
- Inviare una richiesta di supporto per un ulteriore spazio dati di test e indicare la giustificazione aziendale per lo spazio dati aggiuntivo. Questa richiesta è soggetta ad approvazione.
Selezionare o creare un progetto SaaS createsaasenv
Per selezionare o creare un progetto SaaS, richiedere la chiave API Commerce al proprietario della licenza Commerce per l'archivio:
-
Nella barra laterale Admin, vai a Sistema > Servizi > Connettore servizi Commerce.
Se non vedi la sezione Commerce Services Connector nella configurazione Commerce, installa i moduli Commerce per il Commerce servizio desiderato. Verificare inoltre che il pacchetto
magento/module-services-id
sia installato. -
Nelle sezioni Sandbox API Keys e_Production API Keys_, incolla i valori chiave.
- Le chiavi private devono includere
----BEGIN PRIVATE KEY---
all'inizio della chiave e----END PRIVATE KEY----
alla fine. - Se non disponi di una copia delle chiavi effettive, chiedi al proprietario dell’account di inserirle, quindi collega i valori nella configurazione.
note warning WARNING Se si aggiungono valori chiave eseguendo una query su un backup o uno snapshot del database e si incollano i valori nella configurazione, viene applicato un ulteriore livello di crittografia e le chiavi non funzioneranno. - Le chiavi private devono includere
-
Fai clic su Salva.
Tutti i progetti SaaS associati alle chiavi vengono visualizzati nel campo Progetto della sezione Identificatore SaaS.
-
Se non esistono progetti SaaS, fare clic su Crea progetto. Quindi nel campo Progetto, inserisci un nome per il progetto SaaS.
-
Seleziona lo Spazio dati da utilizzare per la configurazione corrente dell'archivio Commerce.
Per modificare i nomi del progetto SaaS o dello spazio dati, fare clic su Rinomina accanto a uno dei due. La modifica del nome non influisce sul servizio, in quanto il nome è solo un’etichetta per identificare e distinguere tra progetti e spazi di dati.
Organizzazione IMS (opzionale) organizationid
Per collegare la tua istanza di Adobe Commerce a Adobe Experience Platform, accedi al tuo account di Adobe utilizzando il tuo Adobe ID. Dopo l’accesso, l’organizzazione IMS associata al tuo account Adobe viene visualizzata in questa sezione.
Esportazione dati SaaS
Quando l'istanza Commerce si connette a Commerce Services, il processo di esportazione dei dati SaaS esporta i dati Commerce dal server Commerce in Commerce SaaS Services in modo che possano essere sincronizzati con i servizi Commerce connessi. In Admin, puoi controllare lo stato di sincronizzazione utilizzando Data Management dashboard. Per informazioni dettagliate, vedere la Guida all'esportazione dei dati SaaS.