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.

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.

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

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.

Se usi PWA Kit versione 3.5.0 o successiva:

1. Per eseguire l'upgrade alla versione più recente di Commerce SDK React, eseguire:

   npm install @salesforce/commerce-sdk-react@latest

2. Per eseguire l'aggiornamento alla versione più recente di Retail React App, eseguire questo comando:

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

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

1. 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.

2. 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.

3. 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.

1. 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.

2. 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.

• Configurazione di uno storefront ibrido con plug-in SLAS
• Crea carrelli ed effettua ordini
• Guida introduttiva a B2C Commerce API (SCAPI)
• Configurazione di uno storefront ibrido con l'autenticazione ibrida
• Guida introduttiva a Composable Storefront