Mise à niveau de la stabilité hybride pour PWA Kit version 2.x

Ce guide explique comment apporter et vérifier des modifications de code dans une boutique hybride pour :

• Mettez à jour un projet de kit Progressive Web App (PWA) sur la version 2.8.4 ou antérieure pour implémenter la stabilité hybride. Cela permet potentiellement d’améliorer les performances des paniers.
• Effectuez une mise à niveau à partir de la version 7.3.0 ou ultérieure de Plugin Shopper Login and API Access Service (Plugin SLAS) vers la version 7.4.0.

Nous vous recommandons de tester les étapes dans un environnement hors production avant de déployer vos modifications en production.

Afin d’améliorer la stabilité et les performances des boutiques hybrides, nous :

• Suppression des appels à OCAPI /sessions partir de PWA Kit pour éliminer l’attrition de session (modifications fréquentes de ). dwsid Pour plus d’informations sur , reportez-vous à dwsid la section Comprendre la gestion des sessions entre SFRA et PWA Kit.
• Ajout d’un en-tête (sfdc_dwsid) aux appels de l’API Salesforce Commerce (SCAPI) pour envoyer les appels SCAPI afin de garantir que les dwsid demandes d’une session d’achat donnée sont acheminées vers le même serveur d’applications.
• Suppression du proxy Open Commerce API (OCAPI) de la configuration PWA Kit, ce qui rend PWA Kit entièrement basé sur SCAPI.

Si vous ne l’avez pas déjà fait, procédez comme suit.

• Configurer SLAS pour PWA Kit
• Configurer le relais de session
• Configurer le routage. Voir aussi API CDN pour les déploiements headless échelonnés.
• Apporter d’autres modifications aux projets PWA Kit

Ouvrez une demande de support demandant au Support client de Salesforce d’activer le remplacement de session pour dwsid. Dans le cas d’assistance :

• Demande d’activation des bascules parent et enfant.
• Mentionnez votre ID de realm et votre ID de locataire corrects. Si vous ne connaissez pas l’identifiant de votre realm, demandez à votre chargé de compte ou à votre Customer Success Manager.

Si vous utilisez la version 2.8.4 ou antérieure de PWA Kit, suivez ces étapes dans votre projet.

1. Vérifiez la différence entre ces fichiers dans votre projet et les fichiers modifiés dans cette demande de tirage.

   • template-retail-react-app/app/commerce-api/auth.js
   • template-retail-react-app/app/commerce-api/index.js
   • template-retail-react-app/app/commerce-api/utils.js

2. Mettez à jour votre projet avec le code nouveau et modifié dans la demande de tirage.

Si vous utilisez Plugin SLAS version 7.3.0 ou ultérieure, procédez comme suit.

1. Dans cartridges/plugin_slas/cartridge/controllers/Login.js:

   • Supprimez le access_token cookie après vous être déconnecté dans le /Login-Logout contrôleur
   • Ajoutez-le config.ACCESS_TOKEN_COOKIE_NAME cookiesToRemove au tableau dans le /Login-Logout contrôleur.

2. Dans cartridges/plugin_slas/cartridge/scripts/helpers/slasAuthHelper.js, mettez à jour la removeCookie fonction pour supprimer tous les morceaux de cookies existants :

   • Remplacez la condition Correspondance exacte (==) par .startsWith.

3. Dans cartridges/plugin_slas/cartridge/scripts/hooks/request/onSession.js, mettez à jour l’implémentation du onSession hook pour le nouveau flux d’acheteurs invités :

   • Extrayez le dwsid from x-is-session_id header dans une variable.
   • Utilisez la variable dans l’appel à getSLASAccessTokenForGuestSessionBridge.
   • Configurez le dwsid cookie sur la réponse pour les nouveaux acheteurs invités.

Voir les fichiers modifiés dans cette demande de tirage.

1. Vérifiez que PWA Kit n’appelle pas . OCAPI /sessions

   • Accédez à votre boutique en ligne et effacez toutes les données du site.

     Si vous utilisez les outils de développement Chrome, consultez l’article Supprimer toutes les données du cache.

   • Actualisez votre boutique en ligne ou accédez à n’importe quelle page basée sur PWA Kit et inspectez l’onglet Réseau dans Chrome DevTools. Confirmez que vous ne voyez pas de demandes adressées à 'dw/shop//sessions'. Reportez-vous à cet exemple de Chrome DevTools.

2. Confirmez qu’il dwsid est envoyé avec toutes les requests SCAPI.

   • Accédez à votre boutique en ligne. Visitez n’importe quelle page basée sur SFRA/SG, puis accédez à une page basée sur PWA Kit.
   • Si vous utilisez Chrome DevTools :
     • Ouvrez Stockage des cookies et recherchez dwsid la valeur des cookies. Voir Ouvrir le volet Cookies.
     • Ouvrez l’onglet Réseau et inspectez toute requête SCAPI (par exemple, /baskets). Dans les en-têtes de requête, vérifiez que vous voyez l’en-tête sfdc_dwsid avec la même valeur que celle dwsid que vous avez trouvée à l’étape précédente. Reportez-vous à cet exemple de Chrome DevTools.

• Configurer une boutique hybride avec des plug-ins SLAS
• Créer des paniers et passer des commandes
• Premiers pas avec l’API B2C Commerce (SCAPI)
• Configurer une boutique hybride avec authentification hybride
• Premiers pas avec Composable Storefront