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.
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.
-
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 de todas as quatro chaves (tanto as chaves de produção quanto de sandbox, Público+Privado) ao selecionar ou criar um projeto SaaS em qualquer um dos ambientes/instalações associados à licença.
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.
Se isso acontecer, envie uma solicitação de suporte para solicitar limpeza de dados.
Provisionamento de espaço de dados SaaS
Todos os comerciantes do Adobe Commerce podem acessar um espaço de dados de produção e dois espaços de dados de teste por projeto SaaS.
Você pode usar os espaços de dados de teste em qualquer ambiente de não produção, desde que não use o mesmo espaço de dados em vários ambientes ao mesmo tempo. Para usar o espaço de dados de teste em um ambiente diferente, execute uma limpeza de dados antes de selecionar e configurar o espaço de dados nesse ambiente.
Para projetos do Adobe Commerce 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. No entanto, se você tiver apenas um ambiente de preparo e exigir espaços de dados de teste adicionais, terá as seguintes opções:
- Entre em contato com a equipe de Sucesso do cliente ou com o Gerente de sucesso do cliente designado para solicitar um ambiente de preparo adicional. Há um custo adicional envolvido.
- Envie uma solicitação de suporte para um espaço de dados de teste adicional e indique a justificativa comercial para o espaço de dados extra. Esta solicitação está sujeita a aprovação.
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 Sandbox API Keys e_Production API Keys_, cole seus valores de chave.
- As chaves privadas devem incluir
----BEGIN PRIVATE KEY---no início da chave e----END PRIVATE KEY----no final da chave. - Se você não tiver uma cópia das chaves reais, peça ao Proprietário da conta que as informe e, em seguida, conecte os valores à configuração.
note warning WARNING Se você adicionar valores-chave consultando um backup de banco de dados ou snapshot e colando os valores na configuração, uma camada adicional de criptografia será aplicada e as chaves não funcionarão. - As chaves privadas devem incluir
-
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.
-
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.