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-idestá 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.
Ao criar um projeto SaaS, o Commerce gera um ou mais espaços de dados SaaS dependendo da sua licença do Commerce:
- Adobe Commerce - Um espaço de dados de produção; dois espaços de dados de teste somente. Em projetos do Cloud Pro com vários ambientes de preparo, você pode solicitar espaços de dados de teste adicionais para cada ambiente de preparo enviando uma solicitação de suporte.
- Magento Open Source - Um espaço de dados de produção; sem espaços de dados de teste
-
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.