Configuração do cartucho

Para configurar a integração SalesForce, você precisa:

1. Configurar o cartucho base (quando aplicável);
2. Copiar os cartuchos;
3. Compilar os cartuchos;
4. Enviar os cartuchos;
5. Configurar o caminho dos cartuchos;
6. Importar os metadados;
7. Visão geral dos atributos personalizados adicionados aos Objetos do Sistema.

1. Configuração básica

ℹ️

Se você estiver adicionando o Gateway de Pagamento a um projeto personalizado, pule esta etapa e vá para a próxima. Esta etapa destina-se a projetos iniciais partindo do SFRA básico.

Para compilar corretamente o código front-end da Braspag, é necessário ter uma cópia do SFRA. O pacote pode ser baixado diretamente do repositório oficial da Salesforce. No entanto, para facilitar esse processo, já incluímos uma versão básica do SFRA junto ao pacote do cartucho Braspag.

Após descompactar o pacote do SFRA, atualize o caminho para o cartucho base (app_storefront_base) no arquivo package.json do pacote Braspag, apontando-o para o diretório real onde o SFRA foi instalado.

Exemplo:

    "paths": { 

        "BaseCartridge": "./cartridges/app_storefront_base" 

    } 

2. Copiar os cartuchos

Dois cartuchos dão suporte a esta integração:

1. braspag_changes_sfra: cartucho de referência para modificar trechos de código em seu cartucho de personalização base.

Se você estiver adicionando a Braspag a um projeto personalizado, use este cartucho como referência para aplicar alterações em seus cartuchos personalizados. Caso contrário, se você estiver criando um projeto do zero, basta copiar este cartucho para a pasta do seu projeto.

2. int_braspag: cartucho responsável por fornecer suporte para a Braspag como novo Processador de Pagamento para o Salesforce Commerce Cloud, com todas as funcionalidades relacionadas. Copie-o para a pasta do seu projeto.

Depois de copiado, execute npm install ou yarn install em um console executando na pasta do SFRA.

3. Complicar e testar os cartuchos

Após executar com sucesso o comando de instalação, execute npm run build ou yarn build para compilar o código da loja virtual na pasta storefront-reference-architecture.

Acesse a pasta raiz do repositório e execute npm run build ou yarn build.

Para os testes, acesse a pasta raiz do repositório e execute npm run test ou yarn run test.

4. Enviar os cartuchos

Envie os cartuchos pelo Visual Studio Code, usando o plugin Prophet.

1. Instale o plugin Prophet no Visual Studio Code.
2. Abra a pasta do seu projeto no VS Code.
3. Na raiz do diretório de trabalho, crie um arquivo chamado dw.json e cole o código abaixo, preenchendo-o conforme as informações do seu ambiente:

{ 

    "hostname": "your-sandbox-hostname.demandware.net", 

    "username": "yourlogin", 

    "password": "yourpassword", 

    "code-version": "version_code_to_be_uploaded_to" 

} 

4. Pressione F1 > Prophet: Enable Upload e então pressione Enter.
5. Pressione CTRL + SHIFT + U. Na lista suspensa, selecione a opção Prophet Uploader e verifique se todos os cartuchos foram enviados com sucesso para sua instância do SFCC.

5. Configurar o caminho dos cartuchos

Acesse Business Manager > Administration > Sites > Manage Sites.

Em seguida, clique no nome do seu site:

Vá para a guia Configurações e adicione os cartuchos da Braspag no campo Cartridges, de acordo com o seu projeto:

6. Importar metadados

Os metadados/site-import estão localizados na pasta raiz do repositório da Braspag.

Crie um arquivo zip para a pasta site-import.

Se você quiser testar o cartucho, pode usar os dados de teste disponíveis na pasta metadata_demo. Isso é útil para ambientes de desenvolvimento e preparação, mas não para produção. Para usá-lo, importe também a pasta metadata_demo seguindo as mesmas etapas da pasta site-import.

Importe o arquivo de metadados indo para Business Manager > Administration > Site Development > Site Import & Export:

Faça upload do arquivo zip:

Importe o arquivo zip:

7. Atributos personalizados

Alguns atributos personalizados foram adicionados em 6 Objetos do Sistema. Veja abaixo a lista:

1. SitePreferences

2. Order

3. OrderPaymentInstrument

4. OrderAddress

5. CustomerAddress

6. PaymentCard