データ統合を作成する
統合ハブ の機能を使用してアプリケーション内の既存のテーブルにインポートすることで、新しい情報または更新された情報を現在のデータセットに追加します。特定の時刻にデータを追加するために、将来のインポートをスケジュールします。
このビデオでは、次の手順を実行する方法を紹介します。
始める前に
- アプリケーションに既存のテーブルが必要です。詳細については、「空白のテーブルを作成する」を参照してください。注:現在、ユーザーがアップロードできるデータ形式は Excel ファイルのみです。
- 必要なロール:admin、sn_app_eng_studio.user、sn_app_eng_studio.admin、または delegated_developer 詳細については、「AES を使用する開発者の委任」を参照してください。
手順
- 移動先 すべて > App Engine > App Engine Studio.
- [自分のアプリ] ページからアプリケーションを開きます。
-
[データ] 見出しの横にある追加アイコン (
) を選択します。
- [データ統合を作成する] を選択します。
-
次の手順を実行して、データインポートソースを構成します。
-
データ統合のフィールドに入力します。
フィールド 説明 名前 統合の名前 簡単な説明 統合の説明。 アプリケーション 統合のアプリケーションスコープの名前。 - [保存して続行] を選択します。
-
データソースタイプを選択するための [ソースタイプ] メニューを使用します。
- Excel ファイルまたは CSV ファイルを選択するには、 AD-HOC > > ファイルをクリックしてから 、Excel または CSV のいずれかを選択します。[ファイルのアップロード] セクションで、XLSX、XLS、CSV または ZIP ファイルをアップロードします。
- データストリームアクションを選択するには、[スポーク] を選択します。アクティブ化されているデータストリームがスポーク別に整理され、アルファベット順にリストされます。[接続] セクションで、接続エイリアスを選択します。接続エイリアスを使用するデータストリームアクションでは、デフォルトの接続エイリアスをその子エイリアスで上書きできます。詳細については、「接続および資格情報エイリアスの作成」を参照してください。
-
データソースの設定
- Excel スプレッドシートを設定するには、使用するシートとヘッダーに使用する行番号を指定します。1 つのシートと 1 つのヘッダーのみを指定できます。
- CSV ファイルを設定するには、区切り文字を選択します。
- データストリームアクションを設定するには、必要な入力項目を入力します。このセクションは、データストリームアクションに入力すべき項目がある場合にのみ表示されます。入力のあるデータストリームアクションには一意の入力があるため、このセクションのフィールドは、選択されたデータストリームアクションとその設定によって異なります。スポーク入力によって既に設定されているデフォルト値は、事前に入力されています。データストリームアクションの詳細を表示するには、その横にある情報アイコン (
) をクリックします。このアイコンをクリックすると、データストリームアクションの設定ページが開きます。
-
データ統合のフィールドに入力します。
- [Save] ボタンを選択します。
- [ターゲットにマッピング] タブを選択します。
-
作成するデータ統合のターゲットテーブルとオプションを選択します。
ソースデータをターゲットテーブルにマッピングすることで、アップロードしたデータをシステムでどのように処理するかを制御できます。
- [ソースからターゲットテーブルへのデータマッピング] ページで、[テーブルを追加する] をクリックします。
-
マッピングプロパティウィンドウで、次のフィールドに入力します。
フィールド 説明 ターゲットテーブル データの変換先のテーブルの名前。 インポート時にテーブルのビジネスルールを実行する データをインポートするときにターゲットテーブルのビジネスルールを実行するオプション。 インポートを同期的に実行 インポートを同期的に実行するオプション。データが並列変換され、特定の結合値を持つ複数のソースレコードが存在する場合、このオプションをオンにすると、その結合値を持つレコードが一度に 1 つだけ挿入されます。詳細については、「同時インポート」ページの「挿入を同期する」セクションを参照してください。 -
[保存] を選択します。
統合には複数のターゲットテーブルを追加できます。追加するターゲットテーブルごとに、ステップ 4a ~ 4c を繰り返します。
テーブルは、追加された順に一覧表示されます。各テーブルカードの左側にあるドラッグアイコン
を使用してカードを別の位置にドラッグすると、順序を変更できます。テーブルカードの順序によって、実行時にデータがターゲットテーブルに変換される順序が決まります。
注:同じテーブルを複数回選択することはできません。また、拡張テーブルまたは既に統合に含まれているテーブルの親テーブルを選択することもできません。
-
次のアクションを実行して、インポートのフィールドをターゲットテーブルにマッピングします。
図 : 1. ターゲットテーブルへのデータのマッピング -
[ソースからターゲットテーブルへのデータマッピング] ページで、マッピング先のターゲットテーブルのボタンを選択します。
これにより、テーブルのデータマッピングセクションが開きます。ページの左側にはソースデータが表示されます。右側はターゲットテーブル用です。
-
[フィールドを追加 (Add a field)]、[すべてのフィールドを追加] または [自動マッピング] ボタンを使用して、ターゲットサイドを設定し、マッピングデータを開始します。
- ターゲットテーブルのすべてのフィールドを追加するには、[すべてのフィールドを追加] を選択します。フィールドはアルファベット順に追加されます。
- フィールドを個別に追加するには、[フィールドを追加 (Add a field)] を選択し、リストからフィールド名を選択します。フィールドは 1 回のみ追加できます。
- フィールドを追加して自動的にマッピングするには、[自動マッピング] を選択します。自動マッピングは、ソースエンティティを同様の名前のターゲットエンティティにマッピングします。[自動マッピング] ボタンには 2 つのオプションがあります。
- [ターゲットテーブル内のすべての一致フィールド] に、すべてのフィールドが追加され、一致するフィールドがマッピングされます。
- [ターゲット選択でマッピングされていないすべてのフィールド] は、既に追加されているがまだマッピングされていないフィールドのみをマッピングします。フィールドがまだ追加されていない場合、このオプションは使用できません。
既にマッピングされているターゲットエンティティの場合、[自動マッピング] を選択してもその値は変更されません。自動マッピングされたフィールドには、データピルに杖のアイコンがあります。
デフォルトでは、自動マップは最大 1 つのソースエンティティをターゲットエンティティにマッピングします。これを変更するには、glide.ih.automap.extractone プロパティを false に設定します。
自動マッピングは、80% 以上一致する列名を探して、ソースとターゲットのエンティティを照合します。これは、glide.ih.automap.minimum.score のプロパティで変更できます。たとえば、60% の類似性に基づいて照合するには、glide.ih.automap.minimum.score を 60 に設定します。
-
データをマッピングするには、データピルをソースからターゲットテーブルの [値]列にドラッグします。
ターゲットテーブルの右側にあるピルピッカー (
) を使用してデータをマッピングすることもできます。[値] 列には複数の値を入力でき、テキストを入力することもできます。
ソースフィールドをターゲットフィールドにマッピングすると、ソースフィールド名の横に小さなチェックマークアイコン (
) が表示されます。カーソルをチェックマークに移動すると、ソースフィールドがマッピングされているターゲットフィールド (最大 5 つのフィールド) がツールヒントに一覧表示されます。
- オプション:
[一致] トグルスイッチを使用して、一致するデータをシステムがチェックするフィールドを指定し、見つかった場合は、新しいレコードを作成する代わりに既存のレコードを更新します。
たとえば、ターゲットテーブルに [注文番号] フィールドと注文番号が 743 のレコードがある場合、一致する可能性のあるものを処理するためのオプションが 2 つあります。
- [注文番号] フィールドの [一致] トグルスイッチがオンの場合、システムは一致するデータをチェックします。ソースデータに同じ注文番号のレコードがある場合、システムはターゲットテーブルの既存のレコードを更新します。
- [注文番号] フィールドの [一致] トグルスイッチがオフの場合、システムは一致するデータをチェックしません。ソースデータに同じ注文番号のレコードがある場合、システムはターゲットテーブルに新しいレコードを作成します。この場合、ターゲットテーブルには 2 つのレコードがあり、どちらも注文番号は 743 です。
- オプション:
選択フィールドと参照フィールドでは、データのマッピング先の列を指定します。
- 歯車アイコン (
) を選択します。
- [フィールド] で、マッピング先の列を選択します。
- [一致するレコードがない場合は、次の操作を行います] で、その列が利用できない場合の対処方法を指定します。
- [新しい選択肢/レコードを作成]:ターゲットテーブルに選択肢またはレコードを作成します。
- [このフィールドを無視]:ターゲットテーブルのそのフィールドのみを無視します。
- [このレコードをスキップ]:ターゲットテーブルのレコード全体をスキップします。
- [完了] を選択します。
- 歯車アイコン (
- オプション:
変換機能を適用して、データを変更または修正します。
たとえば、大文字変換機能を使用して、入力文字列をすべて大文字に変換できます。詳細については、「変換機能」を参照してください。注:フローおよびサブフローの作成時に利用可能なすべての変換機能が 統合ハブ - インポートで利用できるわけではありません。
- 変換機能アイコン (
) を選択します。
- メニューから変換機能を選択し、[OK] を選択します。
- 追加の変換関数を適用するには、[新しい変換を追加] を選択します。変換機能は、選択された順序で適用されます。
- すべての変換機能を追加したら、[完了] を選択します。
- 変換機能アイコン (
-
[ソースからターゲットテーブルへのデータマッピング] ページで、マッピング先のターゲットテーブルのボタンを選択します。
- マッピングが完了したら、[保存] をクリックします。
-
作成してマッピングしたデータインポートの処理方法を選択します。
- アップロードしたデータセットを今すぐインポートするには、[インポート実行] を選択します。
- データを後でインポートするように設定するには、[インポートをスケジュール] を選択します。
「Run or schedule a data import」を参照してください。 - オプション: インポートを実行した場合は、テーブルをプレビューして追加のコンテンツが表示されることを確認するために、ターゲットテーブルに戻り、ブラウザー画面を更新して、[プレビュー] をクリックします。
- オプション: インポート中に新しい列を追加してそれらをターゲットテーブルに表示する場合は、 [リストをカスタマイズ] を選択して表示される列を編集します。