インポートファイルローダー

インポートファイルローダーを使用すると、ウィンドウから簡単にデータをインポートする事ができます。ここでは、インポートファイルローダーについて調査及び研究し、その成果をまとめています。

インポートファイルローダー概要

インポートファイルローダーを使用すると、ウィンドウでデータをインポートする事ができます。インポートするファイルの形式はCSVのみです。ファイルのフォーマット（書式）は、ファイルのエクスポート処理により自動作成する事ができ、それを必要に応じて修正しカスタマイズして使うと手間なく簡単です。

インポートファイルローダーを使用すると、ウィンドウに直接データをインポートする事ができます。インポートするファイルの形式はCSVのみです。ファイルのフォーマット（書式）は、ファイルのエクスポート処理により自動作成する事ができ、それを必要に応じて修正しカスタマイズして使うと手間なく簡単です。

1行目はヘッダー情報として、CSVデータをiDempiereのウィンドウの各フィールドにマッピングするために必要となります。

1行目のヘッダー項目には、その項目名の付け方に次のようなルールがあります。

ヘッダー項目名は、その列のCSVデータをマッピングさせるフィールドのカラム名にする。例：伝票番号→DocumentNo
外部参照しているフィールドについては、カラム名の後ろに[]で、CSVデータに入力している値が対応しているカラム名を入力する。例：伝票タイプ→C_DocType_ID[Name]
子タブのデータについては、対応するカラム名の前に"子タブのテーブル名>"を付加する。例：受注伝票明細の品目フィールド→C_OrderLine>M_Product_ID[Value]
レコードの識別情報となる項目には、ヘッダー項目名の最後に"/K"もしくは"/KT"を指定します。"/KT"を指定した場合は、インポート処理全体を１つのトランザクションとして処理し、エラーがあればすべてロールバックされます。"/KT"と指定しなかった場合は、レコード毎にコミットされます。
インポートの後に伝票ステータス更新処理を実行したい場合は…

インポートファイルローダーのインポート処理では、ウィンドウでデータを登録するように、デフォルト値の設定やコールアウトが実行されます。その事を前提にデータを作成する必要があります。

ファイルフォーマットは、ウィンドウのツールバーのアイコンのエクスポートを実行しCSV形式でダウンロードすると簡単に作成できます。

●ファイルの種類にCSVを選択して下さい。

●選択行のみエクスポートをONにして下さい。

●選択しているタブのデータの他に一緒にエクスポートする子タブを選択して下さい。

以上で、選択した行のデータがCSV形式でエクスポートされます。それを開くと、ヘッダー部分がインポートフォーマットのルールにそって作成されていますので、必要に応じて修正し、インポートフォーマットとして活用できます。

CSV形式で一緒にダウンロードできる子タブには次のような制限があります。

CSV形式でダウンロードされるフィールドは画面に表示されている全てのフィールドがダウンロードされるわけではありません。次のようなルールがあります。

インポートファイルローダーを使用すると、ウィンドウでデータをインポートする事ができます。インポートするファイルの形式はCSVのみです。インポート方法には、次の3種類があります。

インサート…インポートするCSVデータをすべて新規レコードとして登録します。
アップデート…インポートするCSVデータを既存データの更新として処理します。既存データを識別するキーカラムにはインポートデータのヘッダー行に"/K"もしくは"/KT"を付けます。
マージ…既存データがある場合には、"アップデート"され、既存データがない場合には"インサート"されます。