[ベータ版]{class="badge informative"}
UI での SAP Commerce ソース接続の作成
以下のチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用して SAP サブスクリプション請求連絡先と顧客データを取り込むための SAP Commerce ソース接続を作成する手順を説明します。
はじめに getting-started
このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム:Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本:スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル:スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
有効な SAP Commerce アカウントを既にお持ちの場合は、このドキュメントの残りの部分をスキップし、データフローの設定に関するチュートリアルに進んでください。
必要な資格情報の収集 gather-credentials
SAP Commerce をExperience Platformに接続するには、次の接続プロパティの値を指定する必要があります。
clientId
の値。clientSecret
の値。url
の値は、https://subscriptionbilling.authentication.eu10.hana.ondemand.com
と似ています。url
内に存在し、値は eu10
または us10
に類似しています。 例えば、url
が https://eu10.revenue.cloud.sap/api
の場合、eu10
が必要になります。詳しくは、SAP Commerce ドキュメントを参照してください。
Platform スキーマの作成 create-platform-schema
SAP Commerce ソース接続を作成する前に、まずソースに使用するExperience Platformスキーマを作成する必要もあります。 スキーマの作成方法に関する包括的な手順については、Platform スキーマの作成に関するチュートリアルを参照してください。
次のセクションを展開すると、スキーマの例が表示されます。
code language-none |
---|
|
SAP Commerce アカウントの接続 connect-account
Platform UI の左側のナビゲーションバーで「ソース」を選択し、ソースワークスペースにアクセスします。カタログ画面には、アカウントを作成できる様々なソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。または、使用する特定のソースを検索オプションを使用して探すこともできます。
e コマース カテゴリで、「SAP Commerce」を選択し、次に「データを追加」を選択します。
Connect SAP Commerce アカウント ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。
既存のアカウント existing-account
既存のアカウントを使用するには、新しいデータフローを作成する SAP Commerce アカウントを選択し、「次へ」を選択して続行します。
新規アカウント new-account
新しいアカウントを作成する場合は、「新しいアカウント」を選択し、続けて名前、説明(オプション)、の認証情報を指定します。 終了したら「ソースに接続」を選択し、新しい接続が確立されるまでしばらく待ちます。
データの選択 select-data
最後に、Platform に取得するオブジェクトタイプを選択する必要があります。
Customers
Contacts
顧客データを取り込むには、オブジェクトタイプとして 顧客 を選択してから、次へ を選択します。
連絡先データを取り込むには、オブジェクトタイプとして 連絡先 を選択してから、次へ を選択します。
次の手順 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 |
追加データ。配列オブジェクトとして取得されます。 |