マッピングソースデータ設定

概要

ソースデータは、データベース、WEB Service/API、 CSV、Excel、JSON、XMLファイルから選択できます。

ターゲットデータへの接続設定は、事前にコネクション設定画面で行ってください。

設定

データベース

テーブル

No	項目	説明
1	コネクション	コネクション設定画面で設定したコネクションを選択してください。
2	タイプ	RDBコネクションを選択した場合、ソースタイプとしてテーブルまたはクエリを選択できます。
3	テーブル	タイプに「テーブル」を選択した場合、RDBのテーブルとビューの一覧が表示されます。リストから該当するオブジェクトを選択してください。
4	フィルター	データ抽出の条件がある場合、WHERE句を指定してください。 例：WHERE UPDATE_TIME >= SYSDATE - 1|
5	データ参照	既存のデータを参照する画面を開きます。

クエリ

No	項目	説明
6	クエリ	ソースデータの取得方法としてSQLを使用したい場合、クエリを選択してください。
7	クエリ内容	データ抽出のためのSQLを記述してください。 例： SELECT EMPID , EMPNAME , DEPT_CODE FROM HR.EMP WHERE DEPT_CODE = '0003'

CSVファイル

No	項目	説明
11	CSVファイル名	取込するCSVファイル名を入力します。 ファイルパターンで設定したい場合は、「対象ファイル詳細」ボタンを押して詳細設定を行ってください。
12	対象ファイル詳細	複数のCSVファイルを取込対象にしたい場合は、「対象ファイル詳細」ボタンを押して、詳細設定画面で設定を行ってください。 設定方法の詳細は、以下を参照してください。 :fa-book: ファイル詳細設定
13	エンコーディング	CSVファイルのエンコーディングを指定してください。 例：UTF-8、Shift_JIS
14	ヘッダー行あり	ヘッダー行の有無を選択してください。
15	ファイルからカラム情報取得	ひな型CSVファイルを選択し、そのカラム情報を解析して一覧で表示します。
16	カラム	ひな型CSVファイルのカラムを一覧表示するリスト。
※		デリミタや囲み文字は自動判別されるため、指定する必要はありません。

Excelファイル

No	項目	説明
21	Excelファイル名	取込するExcelファイル名を入力します。 ファイルパターンで設定したい場合は、「対象ファイル詳細」ボタンを押して詳細設定を行ってください。
22	対象ファイル詳細	複数のExcelファイルを取込対象にしたい場合は、「対象ファイル詳細」ボタンを押して、詳細設定画面で設定を行ってください。 設定方法の詳細は、以下を参照してください。 :fa-book: ファイル詳細設定
23	シート	取り込み対象のシート番号を選択してください。 ※番号は1から始まります。
24	エンコーディング	Excelファイルのエンコーディングを指定してください。 例：UTF-8、Shift_JIS
25	ヘッダー行あり	ヘッダー行の有無を選択してください。
26	ファイルからカラム情報取得	ひな型Excelファイルを選択し、そのカラム情報を解析して一覧で表示します。
27	カラム	ひな型Excelファイルのカラムを一覧表示するリスト。

JSONファイル

No	項目	説明
31	JSONファイル名	取込するJSONファイル名を入力します。 ファイルパターンで設定したい場合は、「対象ファイル詳細」ボタンを押して詳細設定を行ってください。
32	対象ファイル詳細	複数のJSONファイルを取込対象にしたい場合は、「対象ファイル詳細」ボタンを押して、詳細設定画面で設定を行ってください。 設定方法の詳細は、以下を参照してください。 :fa-book: ファイル詳細設定
33	ファイルから構造取得	ひな型のJSONファイルを選択し、その構造を解析してツリービュー形式で表示する。
34	対象オブジェクト	データが配列で構成されている場合、配列内の各要素（明細行）を1レコードとして取り込むことができます。取り込み対象となる配列のオブジェクトを選択してください。
35	親オブジェクトを表示	デフォルトでは、選択されたオブジェクトの下位レイヤのオブジェクトが表示されますが、親レイヤのオブジェクトも必要な場合は、このオプションをチェックしてください。

サンプルで表示されているオブジェクト一覧は、以下のJSON例です。

{ 
 "orderno": 1, 
 "customercode": "A001", 
 "customeraddress":
   {
   "streetaddress":"長島一丁目1-1",
   "city":"青森市",
   "state": "青森県",
   "postalcode":"030-8570"
   }, 
 "detail": [
     {
      "prodcode": 1,
      "ordernumber": 3,
      "price": 2000,
      "amount": "6000"
     },
     {
      "prodcode": 2,
      "ordernumber": 2,
      "price": 1700,
      "amount": 3400
     }
      ]
} 

XMLファイル

No	項目	説明
41	XMLファイル名	取込するXMLファイル名を入力します。 ファイルパターンで設定したい場合は、「対象ファイル詳細」ボタンを押して詳細設定を行ってください。
42	対象ファイル詳細	複数のXMLファイルを取込対象にしたい場合は、「対象ファイル詳細」ボタンを押して、詳細設定画面で設定を行ってください。 設定方法の詳細は、以下を参照してください。 :fa-book: ファイル詳細設定
43	ファイルから構造取得	ひな型のXMLファイルを選択し、その構造を解析してツリービュー形式で表示する。
44	対象要素	データが配列で構成されている場合、配列内の各要素（明細行）を1レコードとして取り込むことができます。取り込み対象となる配列の要素を選択してください。
45	親要素を表示	デフォルトでは、選択された要素の下位階層の要素が表示されますが、親階層の要素も必要な場合は、このオプションをチェックしてください。
46	属性を表示	デフォルトでは、XMLの属性が表示されません。属性データも必要な場合は、このオプションをチェックしてください。

サンプルで表示されている要素一覧は、以下のXML例です。

<data>
     <orderno>1</orderno>
     <customercode>A001</customercode>
     <customeraddress>
         <streetaddress>長島一丁目1-1</streetaddress>
         <city>青森市</city>
         <state>青森県</state>
         <postalcode>030-8570</postalcode>
     </customeraddress>
     <detail>
         <prodcode>1</prodcode>
         <ordernumber>3</ordernumber>
         <price>2000</price>
         <amount>6000</amount>
     </detail>
     <detail>
         <prodcode>2</prodcode>
         <ordernumber>2</ordernumber>
         <price>1700</price>
         <amount>3400</amount>
     </detail>
 </data>

ファイル詳細設定

No	項目	説明
51	データ取込対象	データ取込対象は、シングルファイルまたはファイル名パターンにマッチしたファイルリストとして設定できます。
52	ファイル名パターン	データ取込対象としてファイル名のパターンを選択した場合、パターンの設定はワイルドカードおよび正規表現で行うことができます。
53	ファイルマスク	ワイルドカードまたは正規表現のファイルマスクを入力してください。
54	ソート対象	複数のファイルを対象とする場合、ファイル取込の順番を設定します。
55	ソート順	ソート順を設定してください。
56	テスト	設定されたファイルマスクに基づき、現在の対象ファイル一覧を表示します。

Web Service/ Web API

No	項目	説明
61	エンドポイント	相対URLを入力してください。 時間に関する動的パラメータの設定が可能です。 設定方法の詳細は、以下を参照してください。 :fa-book: 動的パラメータの設定について
62	リクエスト詳細設定	リクエストの メソッド、ヘッダー、POSTボディ などの詳細情報を設定します。
63	更新	エンドポイントから最新情報を取得します。

Web Service/ Web APIリクエスト詳細設定

No	項目	説明
71	メソッド	リクエストのメソッドを選択します。GET と POST がサポートされています。
72	エンドポイント	相対URLを入力してください。 時間に関する動的パラメータの設定が可能です。 設定方法の詳細は、以下を参照してください。 :fa-book: 動的パラメータの設定について
73	テスト	Webサービス/Web API に対してアクセステストを実行します。
74	ヘッダ	リクエストヘッダーを設定してください。
75	ボディ	POSTの場合ボディを設定してください。
76	Content-Type設定ボタン	ヘッダーの Content-Type を text、JSON、XML、HTML に自動設定するボタンです。
77	レスポンス	テストを実行すると、レスポンスに関する情報を表示します。

No	項目	説明
81	テキスト	ボディタイプが RAWテキスト の場合は、「テキスト」を選択してください。
82	ボディテキスト	ボディテキストを入力してください。 時間に関する動的パラメータの設定が可能です。 設定方法の詳細は、以下を参照してください。 :fa-book: 動的パラメータの設定について

No	項目	説明
83	動的生成	ボディの内容が 動的生成 の場合は、「動的生成」を選択してください。 動的生成では、データベースから SELECT SQL に設定されたSQLの実行結果をボディとして POST します。
84	コネクション	対象となるデータベースを選択します。
85	SELECT SQL	実行するSQLを入力します。

動的パラメータの設定について

設定方法は、{}で囲んだ式を評価し、計算した値を使用します。

例	設定方法
現在日付を使用する場合の設定例	/api/v1/orders/{yyyyMMdd} /api/v1/orders/{yyyyMMdd}
	{ "orderno": 1, "customercode": "A001", "updatedate": "{yyyy/MM/dd HH:mm:ss}", }
昨日の日付を使用する場合の設定例	/api/v1/orders/{DateTime.Now.AddDays(-1).ToString("yyyyMMdd")}
	{ "orderno": 1, "customercode": "A001", "updatedate": "{DateTime.Now.AddDays(-1).ToString(\"yyyyMMdd\")}" }