Commerce Services Connector
Alguns recursos do Adobe Commerce e do Magento Open Source são fornecidos pelo Commerce Services e implantados como SaaS (software como um serviço). Para usar esses serviços, você deve conectar sua instância do Commerce usando chaves de API de sandbox e produção e especificar o espaço de dados na configuração. Você só precisa configurar a conexão uma vez para cada instância do Commerce.
Serviços disponíveis availableservices
Veja a seguir uma lista dos recursos do Commerce que você pode acessar por meio do Commerce Services Connector:
Arquitetura
Em um nível superior, o Commerce Services Connector é composto dos seguintes elementos principais:
As seções a seguir discutem cada um desses elementos com mais detalhes.
Credenciais apikey
As chaves de API de sandbox e produção são geradas a partir da conta Commerce do proprietário da licença. A conta do Commerce é identificada por um identificador exclusivo Commerce (MageID). O proprietário da licença da organização do comerciante pode gerar chaves de API para serviços como o Recommendations do produto ou o Live Search, desde que a conta esteja em boa posição.
As chaves podem ser compartilhadas com base no "conhecimento necessário" com o integrador de sistemas ou a equipe de desenvolvimento que gerencia projetos e ambientes em nome do titular da licença. Os desenvolvedores aos quais o proprietário da licença concedeu Shared Access não podem gerar as chaves em seu nome, mesmo que a organização do comerciante esteja presente na lista suspensa Switch Accounts em sua conta.
Além disso, os integradores de soluções também podem usar o Commerce Services. Se você for um integrador de soluções, o signatário do contrato de parceiro Commerce deve gerar as chaves de API.
Gerar as chaves de API de produção e sandbox genapikey
-
Faça logon em sua conta do Commerce em https://account.magento.com{:target="_blank"}.
-
Na guia Magento, selecione Portal de API na barra lateral.
-
No menu Ambiente, selecione Produção ou Sandbox.
-
Insira um nome na seção Chaves de API e clique em Adicionar novo para abrir a caixa de diálogo para baixar a nova chave.
note warning WARNING Esta caixa de diálogo fornece a única oportunidade que você tem para copiar ou baixar suas chaves. -
Clique em Baixar e em Cancelar.
-
Repita as etapas acima para cada ambiente (produção e sandbox).
A seção Chaves de API agora exibe suas chaves de API (Públicas). Você precisa das chaves de produção e de sandbox (Público+Privado) ao selecionar ou criar um projeto SaaS.
Configuração SaaS saasenv
Commerce instâncias devem ser configuradas com um projeto SaaS e um espaço de dados SaaS para que Commerce Services possa enviar os dados para o local correto. Um projeto SaaS agrupa todos os espaços de dados SaaS. Os Espaços de dados SaaS são usados para coletar e armazenar dados que permitem que o Commerce Services funcione. Alguns desses dados podem ser exportados da instância Commerce e outros podem ser coletados do comportamento do comprador na loja. Esses dados são mantidos para proteger o armazenamento na nuvem.
Para Product Recommendations, o espaço de dados SaaS contém dados de catálogo e comportamentais. Você pode apontar uma instância Commerce para um espaço de dados SaaS ao selecioná-la na configuração Commerce.
Selecionar ou criar um projeto SaaS createsaasenv
Para selecionar ou criar um projeto SaaS, solicite a chave de API Commerce ao proprietário da licença Commerce da sua loja:
-
Na barra lateral Admin, vá para System > Services > Commerce Services Connector.
Se você não vir a seção Commerce Services Connector na configuração Commerce, instale os módulos Commerce do Commerce serviço desejado. Além disso, verifique se o pacote
magento/module-services-id
está instalado. -
Nas seções Chaves de API de sandbox e Chaves de API de produção, cole os valores de chave.
As chaves privadas devem incluir
----BEGIN PRIVATE KEY---
no início da chave e----END PRIVATE KEY----
no final da chave privada. -
Clique em Salvar.
Qualquer projeto SaaS associado às suas chaves é exibido no campo Projeto da seção Identificador SaaS.
-
Se não existirem projetos SaaS, clique em Criar projeto. Em seguida, no campo Projeto, digite um nome para o projeto SaaS.
Todos os comerciantes podem acessar um espaço de dados de produção e dois espaços de dados de teste por projeto SaaS. Para projetos do On Cloud Pro com vários ambientes de preparo, é possível solicitar espaços de dados de teste adicionais para cada ambiente de preparo ao enviar uma solicitação de suporte.
-
Selecione o Espaço de Dados a ser usado para a configuração atual do seu repositório Commerce.
Para alterar os nomes do projeto SaaS ou do espaço de dados, clique em Renomear. Alterar o nome não afeta seu serviço porque o nome é apenas um rótulo que ajuda a identificar e diferenciar entre projetos e espaços de dados.
Organização IMS (opcional) organizationid
Para conectar sua instância do Adobe Commerce à Adobe Experience Platform, faça logon em sua conta Adobe usando sua Adobe ID. Após fazer logon, a organização IMS associada à sua conta Adobe é exibida nesta seção.
Exportação de dados SaaS
Quando a instância do Commerce é conectada com êxito ao Commerce Services, o processo de exportação de dados SaaS exporta os dados do Commerce do servidor Commerce para o Commerce SaaS Services para que ele possa ser sincronizado com os Commerce Services conectados. No Administrador, você pode verificar o status da sincronização usando o painel de Gerenciamento de Dados. Para obter detalhes, consulte o Guia de Exportação de Dados SaaS.