Aggiornamento della stabilità ibrida per PWA Kit versione 3.8.0

Questa guida spiega come apportare e verificare le modifiche al codice in uno storefront ibrido per:

Aggiornare un progetto Progressive Web App (PWA) Kit dalla versione 3.5.0 o successiva alla versione 3.8.0.
Eseguire l’upgrade da Plugin Shopper Login and API Access Service (Plugin SLAS) versione 7.3.0 o successiva alla versione 7.4.0.

È consigliabile testare i passaggi in un ambiente non di produzione prima di distribuire le modifiche nell’ambiente Production.

Solo i clienti esistenti possono accedere ad alcuni dei link di questa pagina. Per informazioni su come accedere ai repository di Commerce Cloud, vedere Salesforce Commerce Cloud GitHub: repository e accesso.

Tip

I passaggi descritti in questa guida si applicano a uno storefront ibrido che utilizza il plug-in SLAS. Con B2C Commerce versione 25.3, l’autenticazione ibrida (autentica) sostituisce il plug-in SLAS. Per ulteriori informazioni, consulta Configurazione di uno storefront ibrido con l’autenticazione ibrida.
Questa guida si applica agli storefront ibridi creati in parte con PWA Kit versione 3.5.0 o successiva. Per i passaggi che si applicano a PWA Kit versione 2.x, vedere Aggiornamento della stabilità ibrida per PWA Kit versione 2.x.

Note

Novità

Per migliorare la stabilità e le prestazioni degli storefront ibridi:

Sono state rimosse le chiamate a OCAPI /sessions da PWA Kit per eliminare la varianza della sessione (modifiche frequenti a dwsid). Per ulteriori informazioni su , vedere Informazioni sulla gestione delle sessioni tra SFRA e PWA Kit. dwsid
È stata aggiunta un’intestazione alle chiamate SCAPI (Salesforce Commerce API) da inviare dwsid a SCAPI per garantire che le richieste provenienti da una determinata sessione acquirente vengano instradate allo stesso server applicazioni.
È stato rimosso il proxy Open Commerce API (OCAPI) dalla configurazione di PWA Kit, che rende PWA Kit completamente basato su SCAPI.

Prerequisiti

Se non l’hai già fatto, completa questi passaggi.

Impostazione di SLAS per PWA Kit
Impostazione del bridging di sessione
Configurazione del Routing. Vedere anche CDN API per implementazioni headless in fasi.
Esecuzione di altre modifiche ai progetti PWA Kit

Invia una richiesta di supporto

Aprire una richiesta di assistenza che chiede all’assistenza clienti Salesforce di abilitare l’override della sessione per dwsid. Nel caso di supporto:

Richiesta di abilitare gli interruttori padre e figlio.
Indicare l’ID realm e l’ID tenant corretti. Se non conosci il tuo ID realm, rivolgiti al tuo Account Executive o Customer Success Manager.

Apportare modifiche al codice del PWA Kit

Se usi PWA Kit versione 3.5.0 o successiva:

Per eseguire l’upgrade alla versione più recente di Commerce SDK React, eseguire:

npm install @salesforce/commerce-sdk-react@latest
Per eseguire l’aggiornamento alla versione più recente di Retail React App, eseguire questo comando:

npm install @salesforce/retail-react-app@latest

Apportare modifiche al codice SLAS del plug-in

Se utilizzi Plugin SLAS versione 7.3.0 o successiva, segui questi passaggi.

In cartridges/plugin_slas/cartridge/controllers/Login.js:
- Rimuovere il cookie dopo il access_token /Login-Logout logout nel controller
- Aggiungere config.ACCESS_TOKEN_COOKIE_NAME all’array cookiesToRemove nel /Login-Logout controller.
In cartridges/plugin_slas/cartridge/scripts/helpers/slasAuthHelper.js, aggiorna la removeCookie funzione per rimuovere eventuali blocchi di cookie esistenti:
- Modificare la condizione da corrispondenza esatta (==) a .startsWith.
In cartridges/plugin_slas/cartridge/scripts/hooks/request/onSession.js, aggiorna l’implementazione dell’hook onSession per il nuovo flusso di acquirenti ospiti:
- Estrarre il dwsid da x-is-session_id header in una variabile.
- Utilizzare la variabile nella chiamata a getSLASAccessTokenForGuestSessionBridge.
- Impostare il dwsid cookie come risposta per i nuovi acquirenti ospiti.

Vedere i file modificati in questa richiesta pull.

Verificare le modifiche al codice

Verificare che PWA Kit non effettui chiamate a OCAPI /sessions.
- Accedere allo storefront e cancellare tutti i dati del sito.
  
  Se utilizzi Chrome DevTools, vedi Eliminare tutti i dati della cache.
- Aggiorna lo storefront o vai a qualsiasi pagina basata su PWA Kit e controlla la scheda Rete in Chrome DevTools. Verificare che non vengano visualizzate richieste inviate a ‘dw/shop//sessions’. Guarda questo esempio di Chrome DevTools.

Nessuna sessione

Confermare che dwsid viene inviato con tutte le richieste SCAPI.
- Vai al tuo storefront. Visita qualsiasi pagina basata su SFRA/SG, quindi vai a una pagina basata su PWA Kit.
- Se utilizzi Chrome DevTools:
  - Apri Archiviazione cookie e cerca dwsid il valore nei cookie. Vedere Aprire il riquadro Cookie.
  - Aprire la scheda Rete ed esaminare qualsiasi richiesta SCAPI (ad esempio, /baskets). In Intestazioni richiesta, verificare che venga visualizzata l’intestazione sfdc_dwsid con lo stesso valore trovato dwsid nel passaggio precedente. Guarda questo esempio di Chrome DevTools.