[Beta 版]{class="badge informative"}

在用户界面中创建SAP Commerce源连接

NOTE
SAP Commerce源为测试版。 有关使用测试版标记源的更多信息,请参阅源概述

以下教程将指导您完成使用Adobe Experience Platform用户界面创建SAP Commerce源连接以引入SAP 订阅账单联系人和客户数据的步骤。

快速入门 getting-started

本教程需要对以下Experience Platform组件有一定的了解:

如果您已经拥有有效的SAP Commerce帐户,则可以跳过本文档的其余部分,并转到有关配置数据流的教程。

收集所需的凭据 gather-credentials

为了将SAP Commerce连接到Experience Platform,您必须提供以下连接属性的值:

凭据
描述
客户端 ID
服务键中clientId的值。
客户端密码
服务键中clientSecret的值。
令牌端点
服务键中url的值,它将类似于https://subscriptionbilling.authentication.eu10.hana.ondemand.com
区域
您的数据中心位置。 该区域存在于url中,其值类似于eu10us10。 例如,如果urlhttps://eu10.revenue.cloud.sap/api,您将需要eu10

有关详细信息,请参阅SAP Commerce 文档

创建Platform架构 create-platform-schema

在创建SAP Commerce源连接之前,还必须确保首先创建一个Experience Platform架构以用于您的源。 有关如何创建架构的完整步骤,请参阅有关创建平台架构的教程。

展开以下部分以查看模式示例。

查看架构示例
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"
}

连接您的SAP Commerce帐户 connect-account

在Platform UI中,从左侧导航栏中选择​ ​以访问源工作区。 Catalog屏幕显示您可以用来创建帐户的各种源。

您可以从屏幕左侧的目录中选择相应的类别。 或者,您可以使用搜索选项查找您要使用的特定源。

在​ 电子商务 ​类别下,选择​ SAP Commerce,然后选择​ 添加数据

带有SAP Commerce卡的目录的平台UI屏幕截图

此时会显示​ Connect SAP Commerce帐户 ​页。 在此页上,您可以使用新凭据或现有凭据。

现有账户 existing-account

要使用现有帐户,请选择要用于创建新数据流的SAP Commerce帐户,然后选择​ 下一步 ​以继续。

用于将SAP Commerce帐户与现有帐户连接的Platform UI屏幕截图

新帐户 new-account

如果要创建新帐户,请选择​ 新建帐户,然后提供名称、可选描述和凭据。 完成后,选择​ 连接到源,然后留出一些时间来建立新连接。

用于将SAP Commerce帐户与新帐户连接的Platform UI屏幕截图

选择数据 select-data

最后,必须选择要摄取到Platform的对象类型。

对象类型
描述
Customers
具有订阅的实体。
Contacts
客户的联系详细信息。
客户

若要摄取客户数据,请选择​ 客户 ​作为您的对象类型,然后选择​ 下一步

SAP Commerce的平台UI屏幕截图显示了与客户选项一起选择的配置

联系人

若要摄取联系人数据,请选择​ 联系人 ​作为对象类型,然后选择​ 下一步

SAP Commerce的平台UI屏幕截图显示了已选择“联系人”选项的配置

后续步骤 next-steps

通过学习本教程,您已建立与SAP Commerce帐户的连接。 您现在可以继续下一教程,并配置数据流以将数据导入Platform

其他资源 additional-resources

以下各节提供了在使用SAP Commerce源时可以参考的其他资源。

映射 mapping

Platform根据您选择的目标架构或数据集,为自动映射的字段提供智能推荐。 您可以手动调整映射规则以适合您的用例。 根据需要,您可以选择直接映射字段,或使用数据准备函数转换源数据以派生计算值或计算值。 有关使用映射器界面和计算字段的全面步骤,请参阅数据准备UI指南

数据流的映射配置将因架构和您选择要摄取的对象类型而异。

客户

对于客户数据,SAP Commerce使用SAP Business Partners API的客户客户联系人关系端点检索数据

以下是客户数据的SAP Commerce数据流映射配置示例:

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
目标字段 描述
customerNumber 客户的编号。
corporateInfo 客户的编号。
customerType 客户类型。
createdAt 指示客户创建时间的时间戳。
changedAt 指示客户上次更新的时间戳。
markets[*].country 客户市场,作为数组对象进行检索。
addresses[*].email 与客户多个地址关联的电子邮件,检索为数组对象。
addresses[*].city 与客户多个地址关联的城市,检索为数组对象。
addresses[*].addressUUID 与客户多个地址关联的ID,作为数组对象进行检索。
externalObjectReferences[*].externalSystemId 附加数据,检索为数组对象。
externalObjectReferences[*].externalId 附加数据,检索为数组对象。
customReferences[*].id 附加数据,检索为数组对象。
customReferences[*].typeCode 附加数据,检索为数组对象。

源工作流的映射步骤。

联系人

对于联系人数据,SAP Commerce使用SAP Business Partners API的联系人端点检索数据。

以下是联系数据的SAP Commerce数据流映射配置示例:

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
目标字段 描述
contactNumber 联系人的电话号码。
createdAt 指示联系人创建时间的时间戳。
changedAt 指示上次更新联系人的时间的时间戳。
personalInfo.lastName 联系人的姓氏。
personalInfo.firstName 联系人的名字。
externalObjectReferences[*].externalSystemId 附加数据,检索为数组对象。
externalObjectReferences[*].externalId 附加数据,检索为数组对象。
externalObjectReferences[*].externalIdTypeCode 附加数据,检索为数组对象。

源工作流的映射步骤。

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