Introdução ao AEM Commerce as a Cloud Service start
Para começar a usar o Adobe Experience Manager (AEM) Commerce as a Cloud Service, o Experience Manager Cloud Service deve ser provisionado com o complemento Commerce integration framework (CIF). O complemento CIF é um módulo extra sobre o AEM Sites as a Cloud Service.
Integração onboarding
A integração do AEM Commerce as a Cloud Service é um processo de duas etapas:
- Ativação do AEM Commerce as a Cloud Service e provisionamento do complemento CIF
- Conectar o AEM Commerce as a Cloud Service com sua solução comercial
A primeira etapa de integração é realizada pela Adobe. Para obter mais detalhes sobre preços e provisionamento, entre em contato com seu representante de vendas.
Depois de provisionado com o complemento CIF, ele é aplicado a todos os programas Cloud Manager existentes. Caso não tenha um Programa Cloud Manager, é necessário criar um. Para obter mais detalhes, consulte Configurar o programa.
A segunda etapa é o autoatendimento para cada ambiente do AEM as a Cloud Service. Há algumas configurações adicionais que você deve fazer após o provisionamento inicial do complemento CIF.
Conectar o AEM com uma solução da Commerce solution
Para conectar o complemento CIF e os Componentes principais do AEM CIF com uma solução comercial, você deve fornecer a URL do ponto de extremidade do GraphQL por meio de uma variável de ambiente do Cloud Manager. O nome da variável é COMMERCE_ENDPOINT. Deve ser configurada uma conexão segura por meio de HTTPS.
Essa variável de ambiente é usada em dois lugares:
- Chamadas de GraphQL do AEM para o back-end de comércio, por meio de algum cliente GraphQl compartilhável comum, usado pelos Componentes principais do AEM CIF e componentes do projeto do cliente.
- Configure uma URL de proxy GraphQL em cada ambiente AEM para o qual a variável esteja disponível em
/api/graphql. Esse URL é usado pelas ferramentas de criação do AEM Commerce (complemento do CIF) e pelos componentes do cliente do CIF.
Um URL de endpoint do GraphQL diferente pode ser usado para cada ambiente AEM as a Cloud Service. Dessa forma, os projetos podem conectar ambientes de preparo do AEM a sistemas de preparo de comércio e o ambiente de produção do AEM a um sistema de produção de comércio. Esse endpoint do GraphQL deve estar disponível publicamente. Não há suporte para VPN privada ou conexões locais. Opcionalmente, um cabeçalho de autenticação pode ser fornecido para usar recursos adicionais do CIF que exigem autenticação.
Opcionalmente e somente para o Adobe Commerce Enterprise/Cloud, o complemento CIF é compatível com o uso de dados de catálogo preparados para autores do AEM. Esses dados exigem a configuração de um cabeçalho de autorização. Esse cabeçalho só está disponível e é usado em instâncias do AEM Author por motivos de segurança. As instâncias de Publicação do AEM não podem mostrar dados preparados.
Há duas opções para configurar o endpoint:
Por meio da interface do usuário do Cloud Manager (padrão) cm-ui
Essa configuração pode ser feita usando uma caixa de diálogo na página Detalhes do ambiente. Ao visualizar esta página para um programa habilitado para Commerce, um botão será exibido se o endpoint não estiver configurado no momento:
Clicar nesse botão abre uma caixa de diálogo:
Depois que o ponto de extremidade e, opcionalmente, um cabeçalho de autorização para suporte ao catálogo em etapas forem definidos, o ponto de extremidade será exibido na página de detalhes. Clicar no ícone Editar para abrir a mesma caixa de diálogo, na qual você pode editar o endpoint, se necessário.
Por meio da CLI do Adobe I/O adobe-cli
Para conectar o AEM a uma solução comercial por meio da CLI do Adobe I/O, siga estas etapas:
-
Obtenha a CLI do Adobe I/O com o plug-in do Cloud Manager.
- Verifique a documentação do Adobe Cloud Manager sobre como baixar, configurar e usar a CLI do Adobe I/O com o plug-in do Cloud Manager CLI.
-
Autentique a Adobe I/O CLI com o programa AEM as a Cloud Service.
-
Defina a variável
COMMERCE_ENDPOINTno Cloud Manager.code language-bash aio cloudmanager:set-environment-variables ENVIRONMENT_ID --variable COMMERCE_ENDPOINT "<Magento GraphQL endpoint URL>"-
Consulte documentos da CLI para saber mais.
-
O URL do ponto de extremidade de GraphQL de comércio deve apontar para o serviço GraphQl do comércio e usar uma conexão HTTPS segura. Por exemplo:
https://<yourcommercesystem>/graphql.
-
-
Habilitar recursos de catálogo em etapas que exigem autenticação (Opcional).
note note NOTE Esse recurso só está disponível com o Adobe Commerce Enterprise ou Cloud Edition. Consulte Autenticação baseada em token para obter detalhes. - Defina a variável secreta
COMMERCE_AUTH_HEADERno Cloud Manager:
code language-bash aio cloudmanager:set-environment-variables ENVIRONMENT_ID --secret COMMERCE_AUTH_HEADER "Authorization: Bearer <Access Token>" - Defina a variável secreta
aio cloudmanager:list-environment-variables ENVIRONMENT_IDVocê está pronto para usar o AEM Commerce as a Cloud Service e pode implantar seu projeto por meio do Cloud Manager.
Configuração de lojas e catálogos catalog
O complemento CIF e os Componentes principais do CIF podem ser usados em várias estruturas de site do AEM conectadas a diferentes lojas de comércio (ou exibições de loja e assim por diante). Por padrão, o complemento CIF é implantado com uma configuração padrão conectada à loja e ao catálogo padrão da Adobe Commerce.
Essa configuração pode ser ajustada para o projeto por meio da configuração do CIF Cloud Service seguindo estas etapas:
-
No AEM, acesse Ferramentas > Serviços da nuvem > Configuração do CIF.
-
Selecione a configuração de comércio que deseja alterar.
-
Abra as propriedades de configuração por meio da barra de ações.
As seguintes propriedades podem ser configuradas:
-
Cliente GraphQL - selecione o cliente GraphQL configurado para comunicação de back-end de comércio. Normalmente, esse cliente deve permanecer no padrão.
-
Exibição de loja - o identificador de exibição de loja. Se estiver vazia, a exibição de loja padrão será usada.
-
Caminho de proxy do GraphQL - o caminho de URL que o Proxy da GraphQL no AEM usa para solicitações de proxy para o endpoint do GraphQL de back-end de comércio.
note note NOTE Na maioria das configurações, o valor padrão /api/graphqlnão deve ser alterado. Somente a configuração avançada que não usa o proxy do GraphQL fornecido deve alterar essa configuração.* Habilitar suporte ao UID do catálogo - habilite o suporte para o UID em vez da ID nas chamadas de GraphQL de back-end de comércio.
note note NOTE O suporte para UIDs foi introduzido no Adobe Commerce 2.4.2. Habilite os UIDs somente se o back-end de comércio suportar um esquema do GraphQL versão 2.4.2 ou posterior. * Identificador de categoria raiz do catálogo - o identificador (UID ou ID) da raiz do catálogo de armazenamento
note caution CAUTION A partir da versão 2.0.0 dos Componentes Principais do CIF, o suporte para idfoi removido e substituído poruid. Se o seu projeto usar os Componentes principais do CIF versão 2.0.0, você deverá ativar o Suporte ao UID do catálogo e usar uma categoria válida do UID como "Identificador de categoria raiz do catálogo".
A configuração mostrada acima serve como referência. Os projetos devem fornecer suas próprias configurações.
Para configurações mais complexas, usando várias estruturas de site do AEM combinadas com diferentes catálogos de comércio, consulte o tutorial Configuração de várias lojas do Commerce.