Introdução ao AEM Commerce as a Cloud Service start
Para começar a usar o Commerce as a Cloud Service do Adobe Experience Manager (AEM), seu 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
- Conecte o AEM Commerce as a Cloud Service à sua solução comercial
A primeira etapa de integração é feita pelo 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 existentes do Cloud Manager. 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 a uma solução da Commerce solution
Para conectar o complemento CIF AEM e os Componentes principais do CIF com uma solução comercial, você deve fornecer o URL do endpoint 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:
- O GraphQL chama o AEM para o back-end comercial, por meio de algum cliente GraphQl compartilhável comum, usado pelos componentes principais do AEM CIF e componentes do projeto do cliente.
- Configure um URL de proxy do 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 para comércio do AEM (complemento CIF) e componentes do lado 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 de AEM com sistemas de preparo de comércio e ambiente de produção de 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 de CIF adicionais que exigem autenticação.
Opcionalmente e somente para 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 de Autores do AEM por motivos de segurança. As instâncias do Publish 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
Consulte a documentação do Adobe Cloud Manager sobre como baixar, configurar e usar o Adobe I/O CLI com o plug-in do Cloud Manager CLI.
-
Autentique a CLI do Adobe I/O com o programa AEM as a Cloud Service
-
Defina a variável
COMMERCE_ENDPOINTno Cloud Managercode 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>"
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 visualizações de loja e assim por diante). Por padrão, o complemento CIF é implantado com uma configuração padrão conectada ao armazenamento e catálogo padrão da Adobe Commerce.
Essa configuração pode ser ajustada para o projeto por meio da configuração de Cloud Service CIF seguindo estas etapas:
-
No AEM, acesse Ferramentas > Cloud Service > 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 do 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 a UID do catálogo - habilite o suporte para UID em vez de 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 usa os Componentes principais do CIF versão 2.0.0, você deve habilitar o Suporte à UID do catálogo e usar uma UID de categoria válida 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 AEM combinadas com diferentes catálogos de comércio, consulte o tutorial Configuração de várias lojas do Commerce.