UI でのローカルファイルアップロードソースコネクタの作成

このチュートリアルでは、ユーザーインターフェイスを使用してローカルファイルを Platform に取り込むためのローカルファイルアップロードソースコネクタを作成する手順を説明します。

はじめに

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

• Experience Data Model (XDM) System: The standardized framework by which Platform organizes customer experience data.
  • スキーマ構成の基本：スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
  • スキーマエディターのチュートリアル:スキーマエディターの UI を使用してカスタムスキーマを作成する方法を説明します。
• Real-time Customer Profile：複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。

Platform へのローカルファイルのアップロード

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

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

「ローカルシステム」カテゴリで、「ローカルファイルのアップロード」を選択し、「設定」を選択します。

既存のデータセットを使用する

データフローの詳細 ページでは、CSV データを既存のデータセットに取り込むか、新しいデータセットに取り込むかを選択できます。

CSV データを既存のデータセットに取り込むには、「既存のデータセット」を選択します。 詳細検索 オプションを使用するか、ドロップダウンメニューで既存のデータセットのリストをスクロールして、既存のデータセットを取得できます。

With a dataset selected, provide a name for your dataflow and an optional description.

このプロセスの間に、エラー診断 および 部分取得 を有効にすることもできます。 エラー 診断では、データフローで発生したエラーレコードの詳細なエラーメッセージ生成が可能で す。部分的な取り込みで は、エラーを含むデータを、手動で定義した特定のしきい値まで取り込むことができます。詳しくは、 バッチの部分取得の概要 を参照してください。

新しいデータセットの使用

CSV データを新しいデータセットに取り込むには、「新しいデータセット」を選択し、出力データセット名と説明（オプション）を入力します。 次に、「詳細検索」オプションを使用するか、ドロップダウンメニューで既存のスキーマのリストをスクロールして、マッピングするスキーマを選択します。

With a schema selected, provide a name for your dataflow and an optional description, and then apply the Error diagnostics and Partial ingestion settings you want for your dataflow. 終了したら、「次へ」を選択します。

Select data

The Select data step appears, providing you an interface to upload your local files and preview their structure and contents. 「ファイル を選択」を選択して、ローカルシステムから CSV ファイルをアップロードします。 または、アップロードする CSV ファイルを ファイルをドラッグ&ドロップ パネルにドラッグ&ドロップできます。

ファイルがアップロードされると、プレビューインターフェイスが更新され、ファイルの内容と構造が表示されます。

ファイルに応じて、ソースデータの列区切り文字（タブ、コンマ、パイプ、カスタム列区切り文字など）を選択できます。 区切り文字 ドロップダウン矢印を選択し、メニューから適切な区切り文字を選択します。

終了したら、「次へ」を選択します。

マッピング

マッピング 手順が表示され、ソーススキーマのソースフィールドをターゲットスキーマの適切なターゲット XDM フィールドにマッピングするインターフェイスが提供されます。

データのプレビュー

「データのプレビュー」を選択すると、選択したデータセットから最大 100 行のサンプルデータのマッピング結果が表示されます。

プレビュー時、ID 列は最初のフィールドとして優先付けされます。マッピング結果を検証する際に必要な重要な情報です。 終了したら、「閉じる」を選択します。

計算フィールドの追加

計算フィールドでは、入力スキーマの属性に基づいて値を作成できます。 これらの値をターゲットスキーマの属性に割り当て、名前と説明を指定して参照を容易にできます。

「計算済みフィールドを追加」ボタンを選択して次に進みます。

計算フィールドの作成 パネルが表示されます。 左側のダイアログボックスには、計算フィールドでサポートされるフィールド、関数、演算子が含まれています。タブの 1 つを選択して、式エディターに関数、フィールドまたは演算子を追加します。

式エディターを選択して、フィールド、関数、演算子を手動で追加します。 Once you have created a calculated field, select Save to proceed.

Filter source schema mapping tree

ソーススキーマをフィルタリングするには、「すべてのソースフィールド」を選択し、ドロップダウンメニューからマッピングする特定のフィールドを選択します。

次の表に、ソーススキーマツリーの並べ替えオプションを示します。

Intelligent recommendations

Platform automatically provides intelligent recommendations for auto-mapped fields based on the target schema or dataset that you selected. You can manually adjust mapping rules to suit your use cases.

すべての自動生成マッピング値を受け入れるには、「すべてのターゲットフィールドを受け入れる」を選択します。

ソーススキーマに複数のレコメンデーションが使用できる場合があります。 この場合、マッピングカードには最も目立つレコメンデーションが表示され、その後に使用可能なレコメンデーションの数を示す青い円が表示されます。 電球アイコンを選択すると、追加の推奨事項のリストが表示されます。 代わりに、マッピング先のレコメンデーションの横にあるチェックボックスを選択して、代替レコメンデーションの 1 つを選択できます。

または、ソーススキーマを手動でターゲットスキーマにマッピングすることもできます。 それには、マッピングするソーススキーマの上にマウスポインターを置き、プラス (+) アイコンを選択します。

「ソースをターゲットフィールドにマッピング」ポップオーバーが表示されます。 ここから、マッピングするフィールドを選択し、「保存」を選択して新しいマッピングを追加できます。

終了したら、「終了」を選択します。

データ取得の監視

CSV ファイルがマッピングされ、作成されたら、監視ダッシュボードを使用して、CSV ファイルを通じて取り込まれるデータを監視できます。 For more information, see the tutorial on monitoring sources dataflows in the UI.

次の手順

このチュートリアルに従うと、フラットな CSV ファイルを XDM スキーマにマッピングし、Platform に取り込むことができます。このデータは、Real-time Customer Profile などのダウンストリームの Platform サービスで使用できるようになりました。 詳しくは、Real-time Customer Profile の概要を参照してください。