BISやFormaのテーブルにCSVファイルからのインポート・エクスポートを行うには

このCookbookでは、明細テーブルやグリッドテーブルとCSVファイルを連携する方法を紹介します。
この方法を活用することにより、明細テーブルやグリッドテーブルへの入力の手間を軽減できます。

完成イメージ

サンプルでは、グリッドテーブルや明細テーブルとCSVファイルを組み合わせた入出力を行います。

各ボタンから実行できる操作は以下の通りです。

Export from Grid Table
グリッドテーブルのデータをCSVファイルとして出力できます。
Import to Grid Table
CSVファイルのデータをグリッドテーブルに取り込むことができます。
Download CSV template file
このサンプルでのCSVファイルのテンプレートをダウンロードできます。
Export from Detail Table
明細テーブルのデータをCSVファイルとして出力できます。
Import to Detail Table
CSVファイルのデータを明細テーブルに取り込むことができます。

完成サンプル

以下はBIS定義のサンプルです。
ダウンロードして一括インポート機能からご利用ください。

BIS一括インポート用ファイル : im_cookbook_113726_bis.zip
- BISの一括インポート機能からインポートしてください。
- 手順の詳細は以下のドキュメントをご覧ください。
  [IM-BIS システム管理者操作ガイド] - [一括インポート・エクスポートを行う]

サンプルに含まれる定義情報は以下の表の通りです。

種類	定義名	補足説明
BIS定義	CB113726	関連するFormaアプリケーション定義やIM-Workflowのフロー定義等の情報も含まれます。
CSVエクスポート	【SAMPLE】CSVエクスポート	-
CSVインポート	【SAMPLE】CSVインポート	-

上記のサンプルの利用条件は以下の通りです。

intra-mart Accel Platform(Advanced) 2016 Summer(8.0.14), IM-BIS 2016 Summer(8.0.11)以降のバージョンであること
サンプルデータのインポートが行われていること

サンプルは、intra-mart Accel Platform(Advanced) 2016 Summer(8.0.14), IM-BIS 2016 Summer(8.0.11)で動作確認を行っています。

レシピ

CSVインポート・エクスポートのデータソース定義を登録する。
グリッドテーブルや明細テーブルとデータソース定義をマッピングする。
グリッドテーブルや明細テーブルのデータをCSVファイル経由で入出力する。

1. CSVインポート・エクスポートのデータソース定義を登録する。

CSVインポート・エクスポートを利用するためのデータソース定義を登録しましょう。

1.1. CSVインポートのデータソース定義を登録する。

以下の手順でCSVインポートのデータソース定義を登録してください。

「サイトマップ」-「IM-BIS」-「データソース定義」をクリックしてください。
データソース一覧の「登録」アイコンをクリックしてください。
データソース種別には「CSVインポート」を選択してください。
データソース名を入力後、「登録」をクリックしてください。

詳しくは以下のドキュメントをご覧ください。

[IM-BIS システム管理者操作ガイド] - [データソース定義を設定する]

以下の手順でCSVインポートのファイル形式を設定してください。

CSVファイルのヘッダーに項目名を表示するために「スキップ行数（先頭）」に「1」を入力してください。
CSVファイルの列数に合わせて、データフォーマットに列を追加または削除してください。
データフォーマットの列名を入力してください。
各列のデータ型を選択後、「登録」をクリックしてください。

詳しくは以下のドキュメントをご覧ください。

[IM-BIS システム管理者操作ガイド] - [CSVインポート]

1.2. CSVエクスポートのデータソース定義を登録する。

以下の手順でCSVエクスポートのデータソース定義を登録してください。

「サイトマップ」-「IM-BIS」-「データソース定義」をクリックしてください。
データソース一覧の「登録」アイコンをクリックしてください。
データソース種別には「CSVエクスポート」を選択してください。
データソース名を入力後、「登録」をクリックしてください。

詳しくは以下のドキュメントをご覧ください。

[IM-BIS システム管理者操作ガイド] - [データソース定義を設定する]

以下の手順でCSVエクスポートのファイル形式を設定してください。

CSVファイルの出力対象の列に合わせて、データフォーマットに列を追加または削除してください。
データフォーマットの列名を入力してください。入力した列名がCSVファイルのヘッダーに列名として出力されます。
各列のデータ型を選択後、「登録」をクリックしてください。

詳しくは以下のドキュメントをご覧ください。

[IM-BIS システム管理者操作ガイド] - [CSVエクスポート]

2. グリッドテーブルや明細テーブルとデータソース定義をマッピングする。

次に、フォーム上の明細テーブルやグリッドテーブルと登録したデータソース定義のマッピングを設定しましょう。

2.1. データマッパーを表示する。

以下の手順でデータマッパーを表示してください。

フォーム・デザイナで以下のアイテムを配置してください。
- ボタン（インポート）
- ボタン（エクスポート）
- グリッドテーブル
- 明細テーブル
「アクション設定」をクリックしてください。
「アイテムイベント」タブをクリックしてください。
「ボタン(インポート)」または「ボタン(エクスポート)」の「設定」アイコンをクリックしてください。
「追加」をクリックしてください。

2.2. グリッドテーブル・明細テーブルとCSVファイルのデータソース定義のマッピングを設定する。

CSVファイルから明細テーブルやグリッドテーブルに入力する場合、データマッパーの設定は以下の通りです。

リクエスト
- ボタン（インポート）と「csvParam」をマッピングしてください。
レスポンス
- データソース定義（CSVインポート）で設定した列と明細テーブルやグリッドテーブルの列をマッピングしてください。

明細テーブルやグリッドテーブルからCSVファイルを出力する場合、データマッパーの設定は以下の通りです。

リクエスト
- データソース定義（CSVエクスポート）で設定した列と明細テーブルやグリッドテーブルの列をマッピングしてください。
レスポンス
- ボタン（エクスポート）と「csvParam」をマッピングしてください。

サンプルの「Download CSV template file」のように空のテンプレートを出力したい場合、リクエストを設定せずにレスポンスのマッピングを設定してください。

詳しくは以下のドキュメントをご覧ください。

[IM-BIS 業務管理者操作ガイド] - [外部連携の特殊イベントを設定する（一覧選択、CSVインポート・エクスポート）]

3. グリッドテーブルや明細テーブルのデータをCSVファイル経由で入出力する。

最後に、申請画面上でグリッドテーブルや明細テーブルに対するCSVファイルの入出力を実行してみましょう。

申請画面を表示してください。
グリッドテーブルや明細テーブルに入力後、「Export from Grid Table」または「Export from Detail Table」をクリックしてください。
テーブルのデータがCSVファイルとして出力されることを確認できます。
出力したファイルの内容を変更して保存してください。
「Import to Grid Table」または「Import to Detail Table」をクリックしてください。
先の手順で保存したファイルを追加後、「確定」をクリックしてください。
ファイルの内容がグリッドテーブルや明細テーブルに反映されることが確認できます。