[ベータ版]{class="badge informative"}

UI での SAP Commerce ソース接続の作成

NOTE
SAP Commerce ソースはベータ版です。ベータラベル付きソースの使用について詳しくは、 ソースの概要を参照してください。

以下のチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用して SAP サブスクリプション請求連絡先と顧客データを取り込むための SAP Commerce ソース接続を作成する手順を説明します。

はじめに getting-started

このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

有効な SAP Commerce アカウントを既にお持ちの場合は、このドキュメントの残りの部分をスキップし、データフローの設定に関するチュートリアルに進んでください。

必要な資格情報の収集 gather-credentials

SAP Commerce をExperience Platformに接続するには、次の接続プロパティの値を指定する必要があります。

資格情報
説明
クライアント ID
サービスキーからの clientId の値。
クライアントシークレット
サービスキーからの clientSecret の値。
トークンエンドポイント
サービスキーからの url の値は、https://subscriptionbilling.authentication.eu10.hana.ondemand.com と似ています。
領域
データセンターの場所。 領域は url 内に存在し、値は eu10 または us10 に類似しています。 例えば、urlhttps://eu10.revenue.cloud.sap/api の場合、eu10 が必要になります。

詳しくは、SAP Commerce ドキュメントを参照してください。

Platform スキーマの作成 create-platform-schema

SAP Commerce ソース接続を作成する前に、まずソースに使用するExperience Platformスキーマを作成する必要もあります。 スキーマの作成方法に関する包括的な手順については、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 の左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。

画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。

e コマース カテゴリで、「SAP Commerce」を選択し、次に「データを追加」を選択します。

SAP Commerce カードを含むカタログの Platform UI のスクリーンショット

Connect SAP Commerce アカウント ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。

既存のアカウント existing-account

既存のアカウントを使用するには、新しいデータフローを作成する SAP Commerce アカウントを選択し、「次へ」を選択して続行します。

SAP Commerce アカウントを既存のアカウントに接続するための Platform UI のスクリーンショット

新規アカウント new-account

新しいアカウントを作成する場合は、「新しいアカウント」を選択し、続けて名前、説明(オプション)、の認証情報を指定します。 終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。

SAP Commerce アカウントを新しいアカウントに接続するための Platform UI のスクリーンショット

データの選択 select-data

最後に、Platform に取得するオブジェクトタイプを選択する必要があります。

オブジェクトタイプ
説明
Customers
サブスクリプションを持つエンティティ。
Contacts
顧客の連絡先の詳細。
顧客

顧客データを取り込むには、オブジェクトタイプとして 顧客 を選択してから、次へ を選択します。

「Customers」オプションが選択された設定を示す、SAP Commerceの Platform UI のスクリーンショット

連絡先

連絡先データを取り込むには、オブジェクトタイプとして 連絡先 を選択してから、次へ を選択します。

「連絡先」オプションが選択された設定を示す、SAP Commerceの Platform UI のスクリーンショット

次の手順 next-steps

このチュートリアルでは、SAP Commerce アカウントとの接続を確立しました。次のチュートリアルに進み、データを Platform に取り込むためのデータフローの設定を行いましょう。

その他のリソース additional-resources

以下の節では、SAP Commerce ソースを使用する際に参照できるその他のリソースを示します。

マッピング mapping

Platform は、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに対してインテリジェントなレコメンデーションを提供します。 マッピングルールは、ユースケースに合わせて手動で調整できます。 必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。マッパーインターフェイスと計算フィールドの使用に関する包括的な手順については、 データ準備 UI ガイドを参照してください。

データフローのマッピング設定は、スキーマと、取り込むように選択したオブジェクトタイプによって異なります。

顧客

顧客データの場合、SAP Commerce は SAP Business Partners API の customers エンドポイントと customer-contacts relationship エンドポイントを使用してデータを取得します

以下は、顧客データのデータフローのマッピング設定 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 の contacts エンドポイントを使用してデータを取得します。

以下は、連絡先データのデータフローのマッピング設定 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