Atualização de estabilidade híbrida para PWA Kit versão 3.8.0

Este guia explica como fazer e verificar alterações de código em uma vitrine híbrida para:

• Atualize um projeto do Progressive Web App (PWA) Kit da versão 3.5.0 ou posterior para a versão 3.8.0.
• Atualize do Plugin Shopper Login and API Access Service (Plugin SLAS) versão 7.3.0 ou posterior para a versão 7.4.0.

Recomendamos testar as etapas em um ambiente que não seja de produção antes de implantar suas alterações na produção.

Para melhorar a estabilidade e o desempenho das vitrines híbridas, nós:

• Chamadas para OCAPI /sessions de PWA Kit removidas para eliminar a rotatividade de sessão (alterações frequentes em dwsid). Para obter mais informações sobre dwsid o , consulte Compreender o gerenciamento de sessão entre SFRA e PWA Kit.
• Adicionado um cabeçalho às chamadas da Salesforce Commerce API (SCAPI) para enviar à SCAPI e garantir que as dwsid solicitações de uma determinada sessão do comprador sejam roteadas para o mesmo servidor de aplicativos.
• Removido o proxy Open Commerce API (OCAPI) da configuração PWA Kit, o que torna PWA Kit totalmente baseado em SCAPI.

Se você ainda não tiver feito isso, conclua estas etapas.

• Configurar SLAS para o PWA Kit
• Configurar o bridging de sessão
• Configurar o roteamento. Consulte também CDN APIs para implementação headless em fases.
• Fazer outras mudanças nos projetos do PWA Kit

Abra um caso de suporte que solicite ao suporte ao cliente da Salesforce para habilitar a substituição de sessão para dwsid. No caso de suporte:

• Solicitação para habilitar as alternâncias pai e filho.
• Mencione seu ID de realm e ID de inquilino corretos. Se você não souber o ID do seu realm, pergunte ao seu Executivo de Conta ou Customer Success Manager.

Se você estiver usando PWA Kit versão 3.5.0 ou posterior:

1. Para atualizar para a versão mais recente do Commerce SDK React, execute:

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

2. Para atualizar para a versão mais recente do Retail React App, execute este comando:

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

Se você estiver usando o Plugin SLAS versão 7.3.0 ou posterior, conclua estas etapas.

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

   • Remova o access_token cookie após logout /Login-Logout no controlador
   • Adicionar config.ACCESS_TOKEN_COOKIE_NAME à cookiesToRemove matriz no /Login-Logout controlador.

2. No cartridges/plugin_slas/cartridge/scripts/helpers/slasAuthHelper.js, atualize a removeCookie função para remover quaisquer partes existentes de cookies:

   • Altere a condição de correspondência exata (==) para .startsWith.

3. No cartridges/plugin_slas/cartridge/scripts/hooks/request/onSession.js, atualize a implementação do onSession gancho para o novo fluxo de compradores visitantes:

   • Extraia o dwsid de x-is-session_id header em uma variável.
   • Use a variável na chamada para getSLASAccessTokenForGuestSessionBridge.
   • Defina o dwsid cookie como a resposta para novos compradores convidados.

Veja os arquivos alterados nesta solicitação pull.

1. Confirme se PWA Kit não está fazendo chamadas para OCAPI /sessions.

   • Acesse sua vitrine e limpe todos os dados do site.

     Se você estiver usando o Chrome DevTools, consulte Excluir todos os dados de cache.

   • Atualize sua vitrine ou acesse qualquer página baseada em PWA Kit e inspecione a guia Rede no Chrome DevTools. Confirme que você não vê solicitações sendo feitas para 'dw/shop//sessions'. Veja este exemplo no Chrome DevTools.

2. Confirme se dwsid foi enviado com todas as solicitações SCAPI.

   • Vá até a sua vitrine. Visite qualquer página baseada em SFRA/SG e vá para uma página baseada em PWA Kit.
   • Se você estiver usando o Chrome DevTools:
     • Abra o Armazenamento de Cookies e procure dwsid valor nos cookies. Consulte Abrir o painel Cookies.
     • Abra a guia Rede e inspecione qualquer solicitação SCAPI (por exemplo, /baskets). Em Cabeçalhos de solicitação, confirme dwsid se você vê o sfdc_dwsid cabeçalho com o mesmo valor encontrado na etapa anterior. Veja este exemplo no Chrome DevTools.

• Configurar um Storefront híbrido com SLAS de plug-ins
• Crie carrinhos e faça pedidos
• Introdução à API do B2C Commerce (SCAPI)
• Configurar um Storefront híbrido com autenticação híbrida
• Como começar no Composable Storefront