ファイル項目を指定すると図1のような入力欄が用意されます。
「ファイルを選択」ボタンへファイルをドラッグ&ドロップして登録することができます。
詳細表示画面では図3のようにイメージが表示されます。
WordやExcelといった非画像ファイルを登録することもできます。詳細表示画面では図4のようにアイコンが表示されます。
文字列型項目の型詳細設定で「ファイル型」を選択します。
「ファイル名」型の項目を検索条件とした場合、ファイル名が検索対象となります。文字列型として扱われるため部分一致、前方一致といった検索方法を指定することもできます。
Word,Excel,PowerPoint,PDFといったファイルの内容を検索することもできます。 詳細は"全文検索"をお読みください。
繰り返しコンテナ内のファイル項目は、複数ファイルを一括でドラッグ&ドロップして登録することができます。ボタン名が「複数ファイルを選択」となっています。
2つのファイルをドラッグ&ドロップした状態です。
保存ボタンを押下すると、繰り返しコンテナ部分に「2レコード」が登録されます。つまり、1ファイル毎に1レコードとなって登録されます。
Wagbyのファイル型は、次のような動作になります。
ブラウザによって挙動が異なります。
| ブラウザ | 複数ファイルアップロード | ドラッグ&ドロップ操作 | バッググラウンドアップロード |
|---|---|---|---|
| Google Chrome Firefox IE 10 IE 11 |
○ | ○ | ○ |
| Edge | ○ | - | ○ |
| IE 9 以前 その他のブラウザ |
- | - | - |
ファイル本体はデータベースに格納されません。upload_dirというフォルダ内にモデルIDのフォルダが用意され、その中に一時ファイル名が付与されて保存されます。
ファイル型項目を作成すると、対応する(データベースの)テーブルには二つの項目が用意されます。例を示します。
モデル product にファイル型項目 photo を用意したとします。このとき、テーブル product が作成されますが、項目は次のように二つ用意されます。
| 項目名 | 説明 | 例 |
|---|---|---|
| photo | ファイル名が格納されます。 | duke3D.jpg |
| photo_jshfilename | ファイルの存在するパスを示します。起点は wagbyapp/bin となっています。 | ../../upload_dir/product/__multi1869501174086226700.tmp |
アップロードしたファイルの実体は upload_dir フォルダに格納されます。ファイル名は内部で機械的に変更され、拡張子は「.tmp」となります。(図10)
「画面 > その他 > ファイル名型項目の制御」内の「サーバに保存される実ファイル名」を指定することで、このルールを次の3種類から選択することができます。
「オリジナルファイル名をそのまま使う」設定時の upload_dir フォルダを図11に示します。アップロード時のファイル名で格納されています。
運用後に「ファイル名にオリジナルファイル名をそのまま使う」ように設定を変更して再ビルドし、アプリケーションを入れ替えた場合は次のようになります。
過去に登録された .tmp ファイル名を、オリジナルファイル名に戻すためのツールを提供しています。 詳細は"ファイル名の扱いをオリジナルファイル名を残す方式に変更する"をお読みください。
Wagby では、ファイル型の項目を定義するとテーブルには二つのカラムが用意されます。
ファイルの削除処理を行なった場合、データベースからファイル名の情報は削除されますが、ファイルの実体は残っています。ファイル名にオリジナルファイル名をそのまま使う設定を行っていた場合、同名のファイルをアップロードすることで上書きされます。
ファイルの実体を upload_dir フォルダに残す理由は次のとおりです。
残っているファイル(の実体)を定期的に削除するジョブが用意されています。 "サポート > 管理者ガイド(R7) > 参照されていないファイルの削除ジョブ"をお読みください。
データ削除のタイミングでファイルの実体を削除する方法も用意されています。この方法は上述した「ファイルの実体を upload_dir フォルダに残す理由」に該当しない場合にのみ行なってください。
ビルド後のアプリケーションである $(APPHOME)\webapps\$(APPNAME)\webpage\WEB-INF\web.xml ファイル内の context-param 指定箇所に次の内容を含めます。
<context-param> <param-name>file_delete_mode</param-name> <param-value>UnsavedFile</param-value> </context-param>
上記設定を追加後、アプリケーションを再起動します。この設定はアプリケーション全体に適用されます。
一覧更新、アップロード更新、一括更新、メール受信、メール送信でのファイル削除には未対応です。また、カスタマイズコードで Dao/Service を使った場合も未対応です。これらは将来の Wagby で対応する計画です。
詳細表示画面と一覧表示画面でそれぞれ、画像の幅と高さを指定することができます。(図12,図13)
モデル項目詳細定義の出力制御タブを選択します。詳細画面と一覧画面のタブにある「画像のサイズ」を指定します。単位はピクセルです。幅と高さの両方を指定できますが、一方を指定した場合、もう一方は比率を維持して自動調整されます。
ファイル名を非表示にすることができます。(図16)
モデル項目詳細定義の出力制御タブを選択します。詳細画面と一覧画面のタブにある「ファイル名(URL)を表示する」のチェックをはずします。(標準ではチェックされています。)
ファイルのアイコンをクリックすると、そのファイルをダウンロードできるという機能を無効にすることができます。
図18は、アイコンをクリックしてもファイルがダウンロードされません。
モデル項目詳細定義の出力制御タブを選択します。詳細画面と一覧画面のタブにある「ファイル名(URL)リンクを有効にする」のチェックをはずします。(標準ではチェックされています。)
アップロードするファイルの最小サイズおよび最大サイズを指定することができます。単位は「バイト」です。
指定サイズに満たない、または指定サイズを超えた場合は図22のようなエラーメッセージが表示されます。
アップロードするファイルの拡張子を指定することができます。複数個の場合はコンマ「,」で区切ります。
許容されるファイル拡張子でない場合、図24のようなエラーメッセージが表示されます。
自動生成された WEB-INF\classes\savedir.properties.UTF8 ファイルをテキストエディタで開きます。 次のように記載されています。
# ライセンスファイル savedir.jfclicenseholder=../../upload_dir/jfclicenseholder # メールテンプレート savedir.jfcmailtemplate=../../upload_dir/jfcmailtemplate # 帳票テンプレート savedir.jfcreporttemplate=../../upload_dir/jfcreporttemplate # 顧客 savedir.customer=../../upload_dir/customer
標準では、起点ディレクトリ (wagbyapp\bin) からの相対パスとなっています。保存先はモデル毎に指定できるようになっています。
ここで、変更したいモデルのみエントリを残して編集します。変更が不要なモデルは、もともとのファイルから記述を削除します。 例えば「顧客」モデルのみ保存先を変更したい場合は、次のようになります。
# 顧客 savedir.customer=C://Users//YOURNAME//Desktop//newfolder
編集したファイルを customize\resources フォルダに、mysavedir.properties.UTF8 というファイル名で保存します。
運用途中に mysavedir.properties.UTF8 ファイルを作成した場合、次のルールとなります。
"サポート > Wagby Developer Network(R7) > Javaを用いたカスタマイズ > リソースファイル"をお読みください。
ファイル型項目で登録されたファイルをクリックしてダウンロードしたとき、ログが出力されます。
2016-xx-xx 00:01:02 [INFO wagbyDownload2 _jspService] (admin) Download test.xls
MIME タイプのタイプ名が text の場合(テキストファイルやHTMLファイルなど)、文字エンコーディングは "utf-8" が標準となります。
「環境 > アプリケーション > 初期パラメータ > ダウンロードファイルの文字エンコーディング」を指定して、標準の文字エンコーディングを変更することもできます。これはプロジェクト全体で統一されます。
文字エンコーディングの標準は Shift_JIS です。これを変更することはできません。