Guia de instalação do M2E Multichannel para o Adobe Commerce PaaS

Este guia explica como adquirir, implementar e instalar o M2E Multichannel para o Adobe Commerce PaaS.

PaaS refere-se ao Adobe Commerce em infraestrutura na nuvem e ao Adobe Commerce no local.

O M2E Multichannel é distribuído como uma aplicação do Adobe App Builder não transferível. Não é necessário transferir o código-fonte da aplicação nem implementá-la localmente utilizando a CLI do Adobe I/O.

💡 Tutorial em vídeo: Veja o guia passo a passo da instalação do M2E Multichannel para o Adobe Commerce PaaS

Requisitos #

Antes de começar, certifique-se de que tem:

• Adobe Commerce 2.4.5 ou versão posterior instalada e em funcionamento.
• Acesso ao Adobe Exchange.
• Acesso à conta Adobe e à organização associadas ao seu ambiente Adobe Commerce.
• Acesso de administrador ao Adobe Commerce Admin.
• Permissão para adquirir, implementar, associar e instalar aplicações do App Builder.

ℹ️ O M2E Multichannel utiliza a autenticação Adobe IMS para o Adobe Commerce PaaS. A autenticação Commerce Integration (OAuth 1.0a) não é suportada.

Passo 1. Ativar o Adobe IMS #

O Adobe IMS deve estar ativado no ambiente PaaS Commerce para que o M2E Multichannel possa utilizar a autenticação IMS.

Para ativar o Adobe IMS, execute os seguintes comandos a partir do diretório raiz da aplicação Adobe Commerce:

php bin/magento admin:adobe-ims:enable
php bin/magento cache:flush

Quando solicitado, introduza o seu ID da organização, ID do cliente e segredo do cliente e confirme se a autenticação de dois fatores (2FA) está ativada para a sua organização Adobe. O Adobe Commerce 2.4.5 e versões posteriores incluem o metapacote IMS, mas a integração deve ser configurada antes da utilização.

💡 Siga as instruções de integração do Commerce Admin da Adobe com a Adobe ID para obter orientações sobre como configurar o Adobe IMS.

Passo 2. Configurar o SDK da IU de Administração #

O M2E Multichannel requer que a Gestão de Aplicações e o SDK da IU de Administração estejam disponíveis no seu ambiente Adobe Commerce.

Adobe Commerce 2.4.8 e versões posteriores #

O SDK da IU de Administração e a Gestão de Aplicações são incluídos automaticamente. Não é necessária qualquer instalação adicional.

Adobe Commerce 2.4.5–2.4.7 #

Instale o SDK da IU de Administração 3.3 ou posterior a partir da raiz da aplicação do Adobe Commerce:

composer require magento/commerce-backend-sdk:^3.0

php bin/magento module:enable \
  Magento_AdminUISDK \
  Magento_AdobeIms \
  Magento_AdminAdobeIms

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

💡 Para mais informações, consulte o guia de instalação do Adobe Admin UI SDK.

Ativar o SDK da IU de administração #

Assim que o SDK estiver disponível:

1) Aceda a Lojas > Definições > Configuração.

2) Abra Adobe Services > Admin UI SDK.

3) Defina Ativar SDK da IU de administração como Sim.

4) Guarde a configuração.

Passo 3. Verificar a gestão de aplicações #

Depois de configurar o IMS e o SDK da interface de utilizador de administração, certifique-se de que Aplicações > Gestão de aplicações está disponível no seu Adobe Commerce Admin.

A gestão de aplicações é onde irá associar e instalar a aplicação M2E Multichannel implementada.

Passo 4. Obter a aplicação M2E Multichannel a partir do Adobe Exchange #

1) Inicie sessão no Adobe Exchange.

2) Em Experience Cloud, procure M2E Multichannel for Adobe Commerce Cloud.

3) Abra a página da aplicação e clique em Adquirir.

4) Será apresentada uma mensagem a indicar que a aplicação requer o Adobe App Builder. Clique em Sim, continuar para avançar.

5) Assim que a aplicação for adquirida, clique em Gerir a sua aplicação.

Será redirecionado para a página de gestão de aplicações no Adobe Exchange.

Passo 5. Criar um ambiente #

Depois de a aplicação ter sido adquirida e aprovada, crie um ambiente onde será implementada.

1) Na página de gestão de aplicações, clique no nome da aplicação M2E Multichannel for Commerce Cloud.

2) Clique em + Adicionar Ambiente.

3) Introduza um nome para o ambiente, como Teste ou Produção. Deve ter entre 3 e 10 caracteres.

4) Clique em Guardar ambiente.

Depois de guardar o ambiente, a Adobe cria automaticamente o projeto correspondente do App Builder na Adobe Developer Console.

Abra o ambiente recém-criado para continuar.

Passo 6. Configurar e implementar o ambiente #

Um ambiente recém-criado tem o estado Rascunho e tem de ser configurado e implementado.

1) Abra Configuração no menu do ambiente.

2) Selecione o Perfil do produto pretendido.

3) Clique em Implementar.

4) Aguarde até que a implementação esteja concluída.

A implementação pode demorar alguns minutos. Assim que estiver concluída, o estado do ambiente passa a ser Implementado.

Durante a implementação, os valores de autenticação IMS necessários são configurados automaticamente:

Variável	Descrição
AIO_COMMERCE_AUTH_IMS_ORG_ID	O seu ID de organização da Adobe.
AIO_COMMERCE_AUTH_IMS_CLIENT_ID	Identifica as suas credenciais OAuth «servidor para servidor».
AIO_COMMERCE_AUTH_IMS_CLIENT_SECRETS	O segredo do cliente proveniente da mesma credencial OAuth «Servidor para Servidor».
AIO_COMMERCE_AUTH_IMS_TECHNICAL_ACCOUNT_ID	A identidade da máquina para a qual o token de acesso é emitido.
AIO_COMMERCE_AUTH_IMS_SCOPES	Permissões que o token resultante está autorizado a utilizar.

💡 Para mais informações sobre as credenciais OAuth «servidor para servidor», consulte a documentação de autenticação da Adobe.

Passo 7. Associar a aplicação ao Adobe Commerce #

Associe a aplicação do App Builder à sua instância do Adobe Commerce.

1) Inicie sessão no Painel de Administração do Adobe Commerce.

2) Aceda a Aplicações > Gestão de Aplicações.

3) Clique em + Associar Aplicação.

4) Selecione o Projeto pretendido.

5) Selecione o Espaço de trabalho correspondente.

6) Clique em Associar.

Assim que a associação estiver concluída, o M2E Multichannel aparecerá na Gestão de Aplicações com o estado Associado.

Passo 8. Instalar o M2E Multichannel #

1) Localize o M2E Multichannel para Adobe Commerce Cloud na Gestão de Aplicações.

2) Clique em Instalar.

3) Confirme a ação clicando novamente em Instalar.

4) A janela de progresso da instalação irá abrir. Durante a instalação, Gestão de Aplicações:

• ativa o SDK da IU de Administração e regista a extensão na IU de Administração do Adobe Commerce;
• executa o passo de instalação personalizado Inicializar conta M2E, que envia os dados necessários para inicializar a conta M2E.

5) Não é necessário fazer nada enquanto estes passos estão a decorrer. Mantenha a página aberta até que a instalação esteja concluída.

Assim que estiver concluída, a aplicação apresentará o estado Instalada na Gestão de Aplicações.

O M2E Multichannel ficará disponível na secção Aplicações do Adobe Commerce Admin. Pode abrir a aplicação e prosseguir com a configuração inicial descrita no Guia do Utilizador do M2E Multichannel.

Precisa de ajuda? #

Se tiver dúvidas ou precisar de ajuda para instalar o M2E Multichannel, contacte a equipa de apoio.