データの個数分項目名の後に番号が付与されます。 具体的には項目名[1]、項目名[2]・・・となります。
データの個数分項目名の後に番号が付与されます。 コンテナ名[1]/項目名、コンテナ名[2]/項目名・・・となります。
数値フォーマットは適用されません。
CSV形式の場合、日付・時刻・日付時刻型のフォーマットは適用されます。
Excel形式の場合、日付・時刻・日付時刻型のフォーマットは固定となります。それぞれ "yyyy/mm/dd", "h:mm:ss", "yyyy/mm/dd h:mm:ss" です。
項目の内容部が表示されます。(上図1の青枠部分) 登録がない場合は、データ部は空白で出力されます。
定義した項目名の後に参照内容が出力されます。二行目以降は、選択した内容の箇所に "1" が出力されます。 選択していない場合は "0" が出力されます。(上図2の青枠部分)
区別するため、日本語の項目名の後に "(" + 項目ID + ")" が出力されます。(図3)
区別するため、項目名の後に "(" + 項目ID + ")" が出力されます。(図4)
グループ権限を設定したモデルには「データ所有者」を示すための項目 "jgroupidjshparam" が含まれます。この項目は Wagby 内部で必要になります。
参照連動型項目の参照先が繰り返し、およびチェックボックスの場合には未対応です。(出力されません。)
ページタイトルと説明文を指定することができます。(図5)
図5の設定で生成された画面を図6に示します。
ダウンロード設定の詳細を説明します。
"CSV(カンマ区切り)", "TSV(タブ区切り)", "Excel(xls)", "Excel(xlsx)", "実行時指定" が選択できます。
ダウンロードするファイルの名前を任意に指定することができます。 詳細は"ダウンロードファイル名の設計"をお読みください。
モデル毎にダウンロードファイルの文字エンコードを指定することができます。この値が空白のときは「環境 > アプリケーション > 初期パラメータ > CSVファイルの文字エンコーディング」の値が用いられます。
例えば UTF-8 で出力したい場合はこの欄に utf-8 と記述します。
チェックすると、ヘッダ部の項目名が項目IDに変わります。
同時に複数の利用者がダウンロードを行うことを許可します。本設定は標準で有効になっています。
参照権限がない項目は、項目名およびデータは表示されません。しかし本設定を有効にすると権限がない場合でも項目名は出力されるようになります。データは空白で出力されます。
チェックボックス型ではデータ項目に対して "1" または "0" が出力されます。(図3)
本設定を有効にすると、データを一つにまとめて出力します。データ同士の区切り文字は "," を使います。例えば "官公庁,その他" のように出力します。
上述した「チェックボックスを区切り文字で区切って1つの列で出力する」の区切り文字を指定することもできます。空白時は "," (カンマ) が用いられます。
モデル参照の項目は内容部が出力されます。本設定を有効にすると参照先モデルの主キーも同時に出力することができます。 主キーの項目は "項目名#id" となります。
標準ではダウンロードファイル中、カラムの前後にダブルクォーテーションが付与されます。本設定欄に「(なし)」を指定すると、ダブルクォーテーションを出力しません。本設定の未指定時(標準)はダブルクォーテーションです。
ダウンロードファイル名を空白としたとき、ファイル名は次のルールに従います。
ログオンアカウント_data_日付時刻.拡張子
固定ファイル名を指定することができます。拡張子は不要です。ファイル名は次のようになります。
固定ファイル名.拡張子
検索条件をプレースホルダとして含めることができます。"モデル名_cp.項目名" となります。拡張子は不要です。 例を示します。
${report_cp.title}
プレースホルダと他の文字を混在することもできます。
${report_cp.title}_${report_cp.type}_ファイル
ファイル名の設定欄に式(関数)を含めることはできません。そこで次のようにします。
サンプルのモデル定義を図8に示します。項目ID "csvfilename" は、ダウンロードするファイル名が格納される項目とします。
この項目はデータベースに保存しません。(図9)
この項目は入力時に隠し項目とします。(図10)
この項目は出力時にも隠し項目とします。(図11)
この項目は検索時にも隠し項目とします。(図12)
検索時の初期値に式を指定します。これがファイル名になります。(図13)
次の例は、検索条件時のname項目が空であればログオンアカウント名を使います。そうでなければ検索条件欄に入力されたname項目の値を使います。その後ろに日付を "yyyy-MM-dd" 書式で加えるものです。
IF(ISBLANK(${name}),USERNAME(),${name})+TEXT(TODAY(),"yyyy-MM-dd")
「画面 > ダウンロード > ダウンロード設定 > ダウンロードファイル名」には、この隠し項目を指定します。
${customer_cp.csvfilename}
各項目をダウンロードの対象に含めるかどうかを個別に指定できます。
「モデル項目詳細定義>出力制御>その他」の「CSVに出力する」を制御します。標準では有効となっています。
出力されるデータの並び順は、リポジトリで指定したソート順に従います。
モデルに繰り返し項目および繰り返しコンテナが含まれる場合、これらのデータを独立してダウンロードすることができます。
図16は、繰り返し項目「電子メール」ならびに繰り返しコンテナ項目「商談履歴」を含むモデルです。 検索条件下部の「ダウンロード形式」で出力する内容を選択することができます。
繰り返しコンテナ「商談履歴」をダウンロードし、Excelで開いた例を図17に示します。
"すべて" をダウンロードした場合、繰り返し項目・繰り返しコンテナ項目がすべて一行にまとめて出力されます。(図1,図2)
繰り返し項目や繰り返しコンテナ項目を独立してダウンロードすると、行毎に展開して出力されます。(図17)
ファイル名の命名規則は次のようになります。
ログオンアカウント_data_Modelitem_繰り返し項目ID_日付時刻.拡張子
ログオンアカウント_data_Modelitem_繰り返しコンテナ項目ID_日付時刻.拡張子
ファイル名の命名規則を変更することはできません。
モデルに繰り返し項目または繰り返しコンテナがあり、かつ、これらがダウンロード対象となっていた場合、「ダウンロード形式」は必ず用意されます。これを非表示とする設定はありません。
そのため、この項目を非表示とするためには次のような方法で回避してください。
CSV(カンマ区切り),TSV(タブ区切り)ファイルをダブルクリックするとExcelが起動する環境では、次の問題が生じることがあります。
この問題を回避する方法は次のとおりです。
Excel形式でダウンロードしたファイルは、型の情報が反映されます。
拡張子 xls 形式を選択した場合、256列までのデータ項目を扱うことができます。(256列を超える部分は無視されます。)
取り扱うことができるデータ数の上限は 65,536 行です。
拡張子 xlsx 形式を選択した場合、16,384列までのデータ項目を扱うことができます。
取り扱うことができるデータ数の上限は 1,048,576 行です。
項目に権限設定を行った場合は次のように動作します。
条件付き閲覧権限を設定したモデルのデータをCSV形式ファイルでダウンロードした場合、これを編集してアップロード更新する運用には配慮が必要です。
以下のモデル定義を例に説明します。
| 項目 | 説明 |
|---|---|
| id | 主キー |
| a | |
| b | 条件付き閲覧権限を指定。項目aが"0"の場合にのみ閲覧可 |
次のようなデータを想定します。
データ1:id:1000 a:0 b:aaa データ2:id:1001 a:1 b:bbb
権限を有したアカウントでログオンし、このモデルのデータをダウンロードすると、下記のようなCSVとなります。
(id),(a),(b) 1000,0,aaa 1001,1,
条件付き閲覧権限によって、"id=1001" のデータの b 列は、空になっています。(条件を満たさないため閲覧不可)
この状態で、"id=1001" のデータの a 列を 1 から 0 に修正し、CSVアップロード更新します。 このとき、列 b の値が (本来、データベースには保存されている "bbb" から) "から文字" に更新されるということを配慮する必要があります。
この問題への対応は次のように行ってください。
検索・一覧表示画面で、検索結果をすぐにダウンロードすることができます。 詳細は"画面機能 > 検索・一覧表示(一覧表示)> ダウンロード"をお読みください。
生成したCSVファイルを(Wagbyが稼働する)サーバの所定フォルダに保存することができます。「画面 > ダウンロード」タブで設定します。
| 設定欄 | 説明 | 記述例 |
|---|---|---|
| 取得方法 | "download" と "local" を選択できる。標準は "download" だが、"local" にするとサーバに保存される。 | - |
| 保存先ファイル名 | 取得方法が "local" の場合に有効。保存するファイル名。保存先は本番運用サーバ。 指定がない場合は wagbyapp\tempフォルダに、download_xxx.csvというファイル名で出力される。(xxxはランダムな文字列。) | C:\Downloads\YOURFILE.csv /home/wagby/YOURFILE.csv |
| 保存先フォルダ名 | 取得方法が "local" の場合に有効。保存先ファイル名が指定されていない場合に用いる。指定されたフォルダ名に保存する。ファイル名は「ファイル名種別」の指定に準じる。 | C:\Downloads /home/wagby |
| ファイル名種別 | ファイル名種別。未指定、temp、filename、extを指定できる。 未指定、tempの場合は一時ファイル名として、download_[ランダムな文字列].csvとなる。必ず一意になる。現状のダウンロードジョブと同様。tsvやxlsなどcsvでない形式を選択しても、拡張子は.csvとなる。 filenameの場合はDesignerで設定されたファイル名で保存する。拡張子も指定した形式に対応して設定される。 extの場合は拡張子はfilenameと同様に指定した形式に対応して設定されるが、拡張子を除くファイル名はtempと同様に必ず一意になるファイル名が設定される。 |
temp filename ext |
iPad上のブラウザでWagbyアプリケーションを利用する場合、CSVファイルの文字エンコーディングを"UTF-8"に変更してください。
iPadからCSVダウンロード機能を利用する場合、ダウンロード画面からCSVファイルを表示した画面に遷移するためにブラウザの「戻るボタン」を押す必要があります。
CSV ファイルの文字エンコーディングの標準は Windows-31J となっています。これは日本語環境のみに対応しています。
多言語のデータを含む場合、このモデルの文字エンコードを utf-8 に変更してください。
ファイルのダウンロードが終了する前にエクセルファイルが立ち上がっている可能性があります。「ファイルを開く、保存、キャンセル」のダイアログは IE が出力するもので Wagby では制御することができません。このようなメッセージが出力されたあと、数秒ほど待って実行すると問題ないようです。
参照連動型項目の参照先が繰り返し、およびチェックボックスの場合には未対応です。(出力されません。)
データベース非保存項目で、自モデル(親)に紐づく子モデルの値を取得する計算式は処理されません。例えば親モデルのDB非保存項目item1の式がCOUNT(${child_lp})であった場合、この項目は常に0になります。この理由は、親モデルの1データのダウンロード処理で、紐づく子モデルをすべて読み込むとパフォーマンス低下につながるためです。
代替案として次の方法を行なってください。