サポート > Wagby定義ファイル > 17 CSV入出力 > CSVダウンロード

モデルのデータをCSV(カンマ区切り)形式としてダウンロードすることができます。R6.1.0よりTSV(タブ区切り)形式のファイルにも対応しています。 R6.1.0

実行例

「顧客」モデルを CSV 形式でダウンロードする機能例を示します。設定を行うと画面にメニューが用意されます(図1)。


図1 顧客モデルにダウンロード画面を作成した例

クリックすると、ダウンロード画面に遷移します。 出力したいデータの条件を指定し、「ダウンロード」ボタンをクリックします(図2)。


図2 顧客ダウンロード画面

図 2 において検索条件となっている項目は、Wagby 定義ファイルで「検索条件に指定した項目」が用いられます。

次のようなダイアログが表示されますので、「開く」または「保存」ボタンで出力される CSV ファイルを確認してください(図3)。


図3 ダイアログが表示される

複数の利用者が同時にダウンロード機能を利用することができます。

WebブラウザにIE6/7をご利用の場合、ポップアップがブロックされることがあります。この詳細は「よくある質問と回答 - IE6/7 を利用したとき、ポップアップブロックに関するメッセージが表示されます」をお読み下さい。

  

出力されたファイルの内容

ファイルには、1行目に項目名、2行目以降にデータが出力されています。(TSVファイルも同様です。) 繰り返し項目など特別な型については、次のように出力されます。

出力される項目の形式 備考
繰り返し項目 データの個数分項目名の後に番号が振られて出力される。項目名[1]、項目名[2]・・・となる。(※図4) 0個(登録がない)場合は、項目名[1]のみ用意され、データは空白で出力される。
繰り返しコンテナ データの個数分項目名の後に番号が振られて出力される。コンテナ名[1]/項目名、コンテナ名[2]/項目名・・・となる。(※図5) 0個(登録がない)場合は、コンテナ名[1]/項目名のみ用意され、データは空白で出力される。
マスタ/ストアモデル参照(コンボボックス、ラジオボタン、検索画面) 定義した項目名が出力され、データ部には選択した項目の内容が表示される。(※図4) 登録がない場合は、データ部は空白で出力される。
マスタ/ストアモデル参照(チェックボックス) 定義した項目名の後に参照内容が出力され、データ部には選択した内容の箇所に「1」が出力される。(※図5) 選択していないものは「0」が出力される。


図4 CSV ファイルの内容(1)

図5 CSV ファイルの内容(2)

もし、同じ項目名(日本語)が定義されていた場合、ファイルには区別できるように日本語の項目名の後に 「(英語名)」が出力されます(図6)。

図6 CSV ファイルの内容(3)

参照連動型の項目で、参照先のモデル項目の型がチェックボックスの場合については、現在の Wagby ではサポートしていません。 (正しくダウンロードされません。)

出力されるデータの並び順は、定義ファイルで指定するソート順となります。

設定方法

  1. ダウンロード機能を利用したいモデルについて、モデル定義シートの「画面動作定義」ボタンをクリックして画面動作定義シートを開きます(図7)。

    図7 「画面動作定義」ボタン
  2. 画面動作定義シートの「ダウンロード画面」-「画面を作成する」という項目で「○」を設定します(図8)。 続いて、「ダウンロードファイルのタイプ」を選択します。「CSV(カンマ区切り)」、「TSV(タブ区切り)」が選択できます。 標準では、「CSV」となっています。
    「ダウンロードファイル名」では、ダウンロードするファイルの名前を任意に指定することができます(R6.3.0より)。
    またこの欄の設定では、画面名や画面に表示させる説明文を記述することもできます。 「同時複数ダウンロードを許可する」では同時に複数の利用者がダウンロードを行うことを許可します。標準では「○」が設定されています。

    図8 ダウンロード画面を作成する
  3. 次に、ダウンロードの対象となる項目を指定します。 一度モデル定義シートに戻り、「詳細表示」ボタンをクリックしてモデル項目定義シートを開きます。
    モデル項目定義シートの「出力制御(ダウンロード画面)」-「CSV形式出力時にこの項目を加える」で「○」を設定します。 この項目に○がついていない項目については、出力されません。 標準では、「○」が設定されています(図9)。

    図9 「CSV形式出力時にこの項目を加える」で「○」を設定
    設定項目「CSV形式出力時にこの項目を加える」は R6.3.0 より「出力制御(ダウンロード画面)」に分類されています(R6.2 系以前は「出力制御」に分類)。

TSV ファイルをExcelで開くR6.1.0

TSV ファイルを Excel で開く場合は、以下のいずれかの方法で開くことができます。

  • 開くファイルのアイコン上で右クリックし、「プログラムから開く」を選び、「Microsoft Office Excel」を指定する。
  • Excelを起動し、開きたいファイルをドラッグ&ドロップする。