ベータ版

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

最終更新日： 2023-10-31
  • トピック：
  • Sources
    このトピックの詳細を表示
  • 作成対象：
  • Developer
    User
    Admin
    Leader
メモ

SAP Commerce ソースはベータ版です。詳しくは、 ソースの概要 ベータラベル付きのソースの使用に関する詳細

次のチュートリアルでは、 SAP Commerce 持ち込むソース接続 SAP サブスクリプションの請求 Adobe Experience Platformユーザーインターフェイスを使用しての連絡先と顧客データ。

はじめに

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

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

必要な資格情報の収集

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

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

詳しくは、 SAP Commerce ドキュメント.

Platform スキーマの作成

を作成する前に SAP Commerce ソース接続の場合は、まず、ソースに使用するExperience Platformスキーマを作成する必要があります。 に関するチュートリアルを参照してください。 Platform スキーマの作成 スキーマの作成方法に関する包括的な手順を参照してください。

次のセクションを展開して、サンプルのスキーマを表示します。

 スキーマの例を表示
{
  "_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 アカウントの接続

Platform UI の左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。

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

の下 e コマース カテゴリ、選択 SAP Commerce​を選択し、 データを追加.

SAP Commerce カードを使用したカタログの Platform UI スクリーンショット

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

既存のアカウント

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

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

新規アカウント

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

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

データの選択

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

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

顧客データを取り込むには、 顧客 を選択し、を選択します。 次へ.

SAP Commerce の Platform UI のスクリーンショットに、「顧客」オプションが選択された設定が表示される

連絡先データを取り込むには、 連絡先 を選択し、を選択します。 次へ.

連絡先オプションが選択された状態で設定が表示された、SAP Commerce の Platform UI スクリーンショット

次の手順

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

その他のリソース

以下の節では、 SAP Commerce ソース。

マッピング

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

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

顧客データの場合、 SAP Commerce は 顧客 そして 顧客と連絡先の関係 のエンドポイント SAP Business Partners データを取得する API

以下は、 SAP Commerce 顧客データのデータフロー：

ターゲットフィールド 説明
customerNumber 顧客の番号。
corporateInfo 顧客の番号。
customerType 顧客タイプ。
createdAt 顧客がいつ作成されたかを示すタイムスタンプ。
changedAt 顧客が最後に更新された日時を示すタイムスタンプ。
markets[*].country 顧客は、配列オブジェクトとして取得された市場を市場に投入します。
addresses[*].email 顧客の複数のアドレスに関連付けられ、配列オブジェクトとして取得された E メール。
addresses[*].city 顧客の複数のアドレスに関連付けられ、配列オブジェクトとして取得された市区町村。
addresses[*].addressUUID 顧客の複数のアドレスに関連付けられ、配列オブジェクトとして取得された ID。
externalObjectReferences[*].externalSystemId 配列オブジェクトとして取得された追加データ。
externalObjectReferences[*].externalId 配列オブジェクトとして取得された追加データ。
customReferences[*].id 配列オブジェクトとして取得された追加データ。
customReferences[*].typeCode 配列オブジェクトとして取得された追加データ。

ソースワークフローのマッピング手順です。

連絡先データの場合、 SAP Commerce は 連絡先 エンドポイント SAP Business Partners データを取得する API。

以下は、 SAP Commerce 連絡先データのデータフロー：

ターゲットフィールド 説明
contactNumber 連絡先の番号。
createdAt 連絡先がいつ作成されたかを示すタイムスタンプ。
changedAt 連絡先が最後に更新された日時を示すタイムスタンプ。
personalInfo.lastName 連絡先の姓。
personalInfo.firstName 連絡先の名。
externalObjectReferences[*].externalSystemId 配列オブジェクトとして取得された追加データ。
externalObjectReferences[*].externalId 配列オブジェクトとして取得された追加データ。
externalObjectReferences[*].externalIdTypeCode 配列オブジェクトとして取得された追加データ。

ソースワークフローのマッピング手順です。
前のページ
Next page

このページ