iDempiereの標準の添付ファイル機能は、添付ファイル自体の検索が行い難く、ポップアップウィンドウも少々使いずらいです。また、添付ファイルの削除を制御できなかったりもします。そのようなiDempiere標準の添付ファイル機能を改善した、JPiereオリジナルの添付ファイル管理機能を作成しました。
JPiereオリジナル添付ファイル管理概要
iDempiereの標準の添付ファイル機能と、JPiereオリジナル添付ファイル管理機能との主な違いを紹介します。
添付ファイルのレコード管理
iDempiereの標準の添付ファイル機能は、添付しているファイルの情報をXMLで管理していますが、JPiereオリジナルの添付ファイル管理機能ではレコードで管理しています。そして、そのレコードには、ファイルを添付したレコードの情報が引き継がれます。そのため、添付ファイル自体の検索が容易に行えます。
添付ファイルを検索して探す事ができます!!
添付ファイルの削除の可／不可の制御
iDempiereの標準の添付ファイル機能は、添付しているファイルの削除を制御するような事はできませんが、JPiereオリジナルの添付ファイル管理機能では、ファイルの削除を制御する事ができます。
完成にした伝票の添付ファイルを削除できないようにする事ができます!!
準備
JPiereオリジナル添付ファイル管理機能では、DB内にはファイルを保存せずに、ハードディスク上にディレクトリ(フォルダ)を作成してファイルを管理します。そのためストレージプロバイダーの設定が必要になります。
ストレージプロバイダー
◆メソッド
File Systemを選択して下さい。
◆フォルダ
ここに設定したフォルダ(ディレクトリ)の直下にファイルを配置して行きます。
クライアントウィンドウのクライアント情報タブにストレージプロバイダーを設定する
クライアントウィンドウのクライアント情報タブの、添付ファイル用ストレージプロバイダータブに、登録したストレージプロバイダーを設定します。
添付ファイルポップアップウィンドウ
JPiereオリジナルの添付ファイルアイコンをクリックした時に表示される、ポップアップウィンドウの機能について説明します。
ツールバーアイコン
添付ファイルのポップアップウィンドウ
【補足説明】ページング設定
システムコンフィグ設定で、添付ファイルを一覧表示する際にページングするレコード件数を制御する事ができます。
JPIERE_ATTACHMENT_FILE_RECORD_PAGING_SIZE
Clik here to view.
クリップアイコン
クリップをクリックするとポップアップウィンドウが表示され、ファイルを添付する事ができます。
Clik here to view.
一括ダウンロードアイコン
一括ダウンロードアイコンをクリックすると、添付ファイルを一括でダウンロードする事ができます。
OKボタンを押すと、組織毎に添付ファイルをまとめて1つのZIPファイルとしてダウンロードする事ができます。キャンセルすると、添付ファイルの個別のダウンロード用のリストが表示されます。
◆添付ファイルの一覧表示アイコン
Clik here to view.
をクリックするとそのファイルだけをダウンロードする事ができます。
Clik here to view.
をクリックすると添付ファイルを管理しているレコードにズームする事ができます。
Clik here to view.
をクリックするとファイルをレビューする事ができます。※ファイルによってはレビューできない場合もあります。
Clik here to view.
をクリックすると添付ファイルを削除します。添付ファイル台帳の削除可能フラグがOFFの場合は、削除する事はできません。
添付ファイル台帳
JPiereオリジナルの添付ファイルの機能では、添付ファイルの情報をレコードとして管理します。そのレコードには、ファイルを添付したレコードの情報がコピーされます。この事により、添付ファイルを色々な情報をもと検索する事ができます。
◆組織
添付ファイル台帳のレコードへのアクセス制御に使用します。添付ファイルのポップアップウィンドウで、添付ファイルをアップロードした時に選択されている組織が自動入力されます。
◆テーブル
ファイルを添付しているレコードのテーブルが自動入力されます。
◆レコード
ファイルを添付しているレコードのID。クリックするとそのレコードにズームする事ができます。
◆販売(ON)/購買(OFF)
ファイルを添付しているレコードに販売(ON)/購買(OFF)フラグ(IsSOTrxカラム)がある場合に、その値がコピーされます。
◆添付ファイルの名前
添付ファイルのファイル名。
◆添付ファイルのパス
ファイルが保存されているディスクへのパスが自動入力されます。ここに入力されるパスは、ストレージプロバイダーに設定されているパスは除かれた相対パスになります。 ここに設定されるパスは下記のような構成になります。
- クライアントID
- 組織ID
- テーブル名
- レコードID
◆添付ファイルの説明
添付ファイルのポップアップウィンドウで、添付ファイルをアップロードした時に入力されている”添付ファイルの説明”が、自動入力されます。タグ的に、検索したいワードを入力する事を意図しています。
◆メディアコンテンツタイプ
添付ファイルの種類が自動入力されます。
◆メディアフォーマット
添付ファイルの拡張子が自動入力されます。
◆添付ファイルのダウンロード
添付ファイルをダウンロードする事ができます。
◆添付ファイルビューワー
添付ファイルをプレビューする事ができます。ただしプレビューできるのは、下記のメディアコンテンツタイプになります。
- image/jpeg
- image/png
- image/gif
- text/plain
- application/pdf
- text/html
◆アクティブ
レコードの論理削除フラグです。添付したファイルは削除されませんが、添付ファイルポップアップウィンドウには表示されなくなります。
◆削除可能
レコードの物理削除フラグです。このフラグがONの場合、削除アイコンでレコードを削除する事ができ、レコードを削除するとディスクにあるファイルも削除されます。このフラグがOFFの場合は、レコードもファイルも削除できません。
- リファレンスのフィールドグループ
リファレンスのフィールドグループに配置されているフィールド(≒カラム)と同じフィールドが、ファイルを添付したテーブルにある場合に、その情報がコピーされます。タグ的に添付ファイルを検索するのに使用する事を意図しています。 ただしコピーした情報は、ファイルを添付した時点の情報です。ファイルを添付した後で、ファイルを添付したレコードの情報が変更になっても、添付ファイル台帳には反映はされません。
JP_AttachmentFileRecordテーブルにカラムを追加すれば、そのカラムがファイルを添付したレコードにあれば、その情報もコピーされます。
- 伝票のフィールドグループ
主に伝票に関連する情報を、伝票のフィールドグループに配置されています。
◆伝票日付
伝票日付フィールドには下記のカラムの情報がコピーされます。
- 注文日付(DateOrdered)
- 移動日付(MovementDate)
- 請求日付(DateInvoiced)
- 取引日付(DateTrx)
- 記帳日付(StatementDate)
添付ファイルの削除の制御
“添付ファイル台帳(JP_AttachmentFileRecord)”には、削除可能フラグがあり、ONの状態であれば、添付ファイル台帳のレコードを削除する事で、ハードディスク上のファイルも削除されます。OFFにする事で添付ファイル台帳のレコードは削除する事ができなくなり、ハードディスク上のファイルも削除できません。
JPiereの添付ファイル管理では、システムコンフィグ設定で、伝票ステータス更新処理を行った時と、ファイルが添付されているデータのデータが変更になった時に、添付ファイル台帳の削除可能フラグを自動的にOFFにする事ができます。