[Beta]{class="badge informative"}

Criar uma conexão de origem SAP Commerce na interface

NOTE
A origem SAP Commerce está na versão beta. Consulte a visão geral das fontes para obter mais informações sobre o uso de fontes com rótulo beta.

O tutorial a seguir orienta você pelas etapas para criar uma conexão de origem do SAP Commerce para trazer contatos de SAP Faturamento da assinatura e dados do cliente usando a interface do usuário do Adobe Experience Platform.

Introdução getting-started

Este tutorial requer um entendimento prático dos seguintes componentes do Experience Platform:

Se você já tiver uma conta válida do SAP Commerce, ignore o restante deste documento e prossiga para o tutorial em configurando um fluxo de dados.

Coletar credenciais necessárias gather-credentials

Para conectar SAP Commerce ao Experience Platform, você deve fornecer valores para as seguintes propriedades de conexão:

Credencial
Descrição
ID de cliente
O valor de clientId da chave de serviço.
Segredo do cliente
O valor de clientSecret da chave de serviço.
Endpoint do token
O valor de url da chave de serviço será semelhante a https://subscriptionbilling.authentication.eu10.hana.ondemand.com.
Região
O local do data center. A região está presente no url e tem um valor semelhante a eu10 ou us10. Por exemplo, se o url for https://eu10.revenue.cloud.sap/api, você precisará de eu10.

Para obter mais informações, consulte a SAP Commerce documentação.

Criar um esquema da Platform create-platform-schema

Antes de criar uma conexão de origem SAP Commerce, você também deve garantir que crie primeiro um esquema Experience Platform para usar na sua origem. Consulte o tutorial sobre criação de um esquema da Platform para obter etapas abrangentes sobre como criar um esquema.

Expanda a seção a seguir para exibir um schema de exemplo.

Exibir exemplo de esquema
code language-none
{
  "_extconndev": {
    "addresses": [
      {
        "addressUUID": "{ADDRESS_UUID}",
        "city": "Burnaby",
        "country": "Canada",
        "email": "chandni@acme.com",
        "houseNumber": "27",
        "isDefault": false,
        "phone": "123-456-7890",
        "postalCode": "V3J 1X9",
        "state": "British Columbia",
        "street": "Beresford"
      }
    ],
    "changedAt": "1687204041",
    "changedBy": "vero@acme.com",
    "contactNumber": "123-456-7980",
    "corporateInfo": {
      "company": "acme"
    },
    "createAt": "1687204041",
    "createdBy": "vero@acme.com",
    "customReferences": [
      {
        "id": "Sample value",
        "typeCode": "Sample value"
      }
    ],
    "customerNumber": "Sample value",
    "customerType": "Sample value",
    "defaultAddress": {
      "addressUUID": "Sample value",
      "city": "North Vancouver",
      "country": "Canada",
      "email": "chandni@acme.come",
      "houseNumber": "34",
      "isDefault": false,
      "phone": "123-456-7890",
      "postalCode": "V7H 2P1",
      "state": "British Columbia",
      "street": "Maple"
    },
    "externalObjectReferences": [
      {
        "externalId": "{EXTERNAL_ID}",
        "externalIdTypeCode": "{EXTERNAL_ID_TYPE_CODE}",
        "externalSystemId": "{EXTERNAL_SYSTEM_ID}"
      }
    ],
    "markets": [
      {
        "active": false,
        "country": "USA",
        "currency": "USD",
        "marketId": "Sample value",
        "priceinfo": {
          "incoterms": "{INCO_TERMS}",
          "incotermsLocation": "{INCO_TERMS_LOCATION}",
          "priceGroup": "{PRICE_GROUP}",
          "priceListType": "{PRICE_LIST_TYPE}"
        },
        "salesArea": {
          "distributionChannel": "{DISTRIBUTION_CHANNEL}",
          "division": "{DIVISION}",
          "salesOrganization": "{SALES_ORGANIZATION}"
        }
      }
    ],
    "personalInfo": {
      "firstName": "Chandni",
      "lastName": "Kaur"
    }
  },
  "_id": "/uri-reference",
  "_repo": {
    "createDate": "2004-10-23T12:00:00-06:00",
    "modifyDate": "2004-10-23T12:00:00-06:00"
  },
  "createdByBatchID": "/uri-reference",
  "modifiedByBatchID": "/uri-reference",
  "personID": "{PERSON_ID}",
  "repositoryCreatedBy": "kevin@acme.com",
  "repositoryLastModifiedBy": "kevin@acme.com"
}

Conectar sua conta do SAP Commerce connect-account

Na interface da Platform, selecione Fontes na barra de navegação esquerda para acessar o espaço de trabalho Fontes. A tela Catálogo exibe uma variedade de fontes com as quais você pode criar uma conta.

Você pode selecionar a categoria apropriada no catálogo no lado esquerdo da tela. Como alternativa, você pode encontrar a fonte específica com a qual deseja trabalhar usando a opção de pesquisa.

Na categoria comércio eletrônico, selecione SAP Commerce e Adicionar dados.

Captura de tela da interface do usuário da plataforma para catálogo com o cartão SAP Commerce

A página Conectar conta SAP Commerce é exibida. Nesta página, você pode usar credenciais novas ou existentes.

Conta existente existing-account

Para usar uma conta existente, selecione a conta SAP Commerce com a qual deseja criar um novo fluxo de dados e clique em Avançar para continuar.

Captura de tela da interface do usuário da plataforma para conectar a conta SAP Commerce a uma conta existente

Nova conta new-account

Se você estiver criando uma nova conta, selecione Nova conta e forneça um nome, uma descrição opcional e suas credenciais. Quando terminar, selecione Conectar à origem e aguarde algum tempo para que a nova conexão seja estabelecida.

Captura de tela da interface do usuário da plataforma para conectar a conta SAP Commerce a uma nova conta

Selecionar dados select-data

Finalmente, você deve selecionar o tipo de objeto que deseja assimilar na Platform.

Tipo de objeto
Descrição
Customers
As entidades que têm assinaturas.
Contacts
Os detalhes de contato dos clientes.
Clientes

Para assimilar dados do cliente, selecione Clientes como seu tipo de objeto e selecione Próximo.

Captura de tela da interface do usuário da plataforma para SAP Commerce mostrando a configuração com a opção Clientes selecionada

Contatos

Para assimilar dados de contato, selecione Contatos como seu tipo de objeto e selecione Avançar.

Captura de tela da interface do usuário da plataforma para SAP Commerce mostrando a configuração com a opção Contatos selecionada

Próximas etapas next-steps

Seguindo este tutorial, você estabeleceu uma conexão com sua conta do SAP Commerce. Agora você pode seguir para o próximo tutorial e configurar um fluxo de dados para trazer dados para a Platform.

Recursos adicionais additional-resources

As seções abaixo fornecem recursos adicionais que você pode consultar ao usar a origem SAP Commerce.

Mapeamento mapping

A Platform fornece recomendações inteligentes para campos mapeados automaticamente com base no esquema ou conjunto de dados de destino selecionado. Você pode ajustar manualmente as regras de mapeamento para atender aos seus casos de uso. Com base nas suas necessidades, você pode optar por mapear campos diretamente ou usar funções de preparação de dados para transformar dados de origem para derivar valores calculados ou calculados. Para obter etapas abrangentes sobre como usar a interface do mapeador e campos calculados, consulte o Guia da Interface do Preparo de Dados.

As configurações de mapeamento para o fluxo de dados serão diferentes dependendo do esquema e do tipo de objeto que você seleciona para assimilar.

Clientes

Para dados de clientes, o SAP Commerce usa os pontos de extremidade clientes e relações cliente-contatos da API SAP Business Partners para recuperar os dados

Este é um exemplo de configurações de mapeamento para o fluxo de dados SAP Commerce para dados do cliente:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2
Campo de público alvo Descrição
customerNumber O número do cliente.
corporateInfo O número do cliente.
customerType O tipo de cliente.
createdAt Um carimbo de data e hora indicando quando o cliente foi criado.
changedAt Um carimbo de data e hora indicando quando o cliente foi atualizado pela última vez.
markets[*].country Os clientes comercializam, recuperados como um objeto de matriz.
addresses[*].email Emails associados aos vários endereços do cliente, recuperados como um objeto de matriz.
addresses[*].city Cidades associadas aos vários endereços do cliente, recuperadas como um objeto de matriz.
addresses[*].addressUUID IDs associadas aos vários endereços do cliente, recuperadas como um objeto de matriz.
externalObjectReferences[*].externalSystemId Dados adicionais, recuperados como um objeto de matriz.
externalObjectReferences[*].externalId Dados adicionais, recuperados como um objeto de matriz.
customReferences[*].id Dados adicionais, recuperados como um objeto de matriz.
customReferences[*].typeCode Dados adicionais, recuperados como um objeto de matriz.

A etapa de mapeamento do fluxo de trabalho de origens.

Contatos

Para dados de contato, SAP Commerce usa o ponto de extremidade contatos da API SAP Business Partners para recuperar os dados.

Este é um exemplo de configurações de mapeamento para o fluxo de dados SAP Commerce para dados de contato:

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2
Campo de público alvo Descrição
contactNumber O número do contato.
createdAt Um carimbo de data e hora indicando quando o contato foi criado.
changedAt Um carimbo de data e hora indicando quando o contato foi atualizado pela última vez.
personalInfo.lastName O Sobrenome do contato.
personalInfo.firstName O Nome do contato.
externalObjectReferences[*].externalSystemId Dados adicionais, recuperados como um objeto de matriz.
externalObjectReferences[*].externalId Dados adicionais, recuperados como um objeto de matriz.
externalObjectReferences[*].externalIdTypeCode Dados adicionais, recuperados como um objeto de matriz.

A etapa de mapeamento do fluxo de trabalho de origens.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089