uCosminexus 電子フォームワークフロー 解説

[目次][用語][索引][前へ][次へ]

付録H.2 EUR Form連携帳票の添付ファイルの使用方法

ここでは,EUR Form帳票から添付ファイルを操作する手順を説明します。

<この項の構成>
(1) EUR Form連携帳票の添付ファイルを使うための環境設定
(2) EUR Form帳票送信先URLのJSPファイルの使い方
(3) EUR Form連携帳票の添付ファイルを使う上での注意事項

(1) EUR Form連携帳票の添付ファイルを使うための環境設定

EUR Form連携帳票から添付ファイルを操作するための環境設定の方法を説明します。

(a) 添付ファイル情報格納用テーブルの作成

BLCでは,データベース(HiRDB,OracleおよびSQL Server)用に,添付ファイルを操作するためのテーブル情報を定義したファイル(BLCFile.txt)をサンプルとして提供しています。サンプルファイルは,次のディレクトリに格納されています。

Windows版の場合
<BLC2のインストールディレクトリ>\blc\setup\sql\<データベース種別>
HiRDBを使う場合の注意事項
  • HiRDB用のサンプルファイル(BLCFile.txt)は,使用する環境に合わせて,LOB列格納用RDエリアを指定する必要があります。サンプルファイル(BLCFile.txt)のLOB_RDAREA_NAME(Ex.RLOB1)を,正しいRDエリア名に変更してください。
  • HiRDBを使う場合,BLOB型のカラムに指定するRECOVERYオペランドには,必ず"ALL"または"PARTIAL"を指定します。
(b) J2EEサーバのリソースアダプタで使用するコンフィグレーションプロパティの設定

HiRDB,OracleおよびSQL Serverの環境で,コンフィグレーションプロパティに設定する値を次に示します。

表H-6 コンフィグレーションプロパティの設定値

項目名 HiRDBの場合 Oracleの場合 SQL Serverの場合
LONGVARBINARY_Access LOCATOR
(凡例)
−:指定しません。
注※
LOCATORを設定することを推奨します。LOCATORを設定する場合は,HiRDBのバージョンがLOCATOR機能に対応しているか確認してください。

(2) EUR Form帳票送信先URLのJSPファイルの使い方

添付ファイル用サンプルデータのEUR Form帳票送信先URLのJSPファイル(BLCEURAttachedSample.jsp)とユーザ追加処理について説明します。

(a) 対応ボタン

添付ファイル用サンプルデータのEUR Form帳票送信先URLのJSPファイルが対応するボタンと,ユーザ追加処理で添付ファイルを処理するボタンについて次に示します。

表H-7 対応ボタン

ボタン名 EUR Form帳票送信先URLのJSPファイル ユーザ追加処理
申請
承認
閉じる
(凡例)
○:対応しています。
−:該当しません。

(b) 動作仕様

ユーザ追加処理で添付ファイルの処理をするタイミングを説明します。

●申請時の動作仕様

申請方法には次の四つがあります。

帳票を表示したとき
申請作業で帳票を表示する時は,添付ファイルの処理はできません。
申請作業でボタンをクリックしたとき
申請作業でボタンをクリックしたときの動作を次に示します。

表H-8 申請作業でボタンをクリックしたときの動作仕様

ボタン 処理
データベースからの取得 EUR Form連携帳票への設定 EUR Form連携帳票からの取得 データベースへの更新
申請
閉じる
(凡例)
○:処理します。
−:処理しません。

●承認時の動作仕様
帳票を表示するとき
受信ボックスからの選択の動作を次に示します。

表H-9 承認作業で帳票を表示するときの動作仕様

帳票の表示時 処理
データベースからの取得 EUR Form連携帳票への設定 EUR Form連携帳票からの取得 データベースへの更新
受信ボックスからの選択
(凡例)
○:処理します。
−:処理しません。

承認作業でボタンをクリックしたとき
承認作業でボタンをクリックしたときの動作を次に示します。

表H-10 承認作業でボタンをクリックしたときの動作仕様

ボタン 処理
データベースからの取得 EUR Form連携帳票への設定 EUR Form連携帳票からの取得 データベースへの更新
申請
閉じる
(凡例)
○:処理します。
−:処理しません。

●内容確認時の動作仕様
帳票を表示するとき
送信ログからの選択の動作を次に示します。

表H-11 送信ログからの帳票を表示するときの動作仕様

帳票の表示時 処理
データベースからの取得 EUR Form連携帳票への設定 EUR Form連携帳票からの取得 データベースへの更新
送信ログからの内容確認
(凡例)
○:処理します。
−:処理しません。

内容確認作業でボタンをクリックしたとき
内容確認作業でボタンをクリックしたときは,添付ファイルの処理はしません。
(c) 添付ファイル機能が使用するデータベースの説明

BLC_FILE_TテーブルのNMITEM1カラム,NMITEM2カラムおよびNMITEM3カラムは,添付ファイル用サンプルデータのユーザ追加処理で使用します。ユーザが独自に利用している場合,ユーザ追加処理のカスタマイズが必要になります。

BLC_FILE_TテーブルのNMITEM1カラム,NMITEM2カラムおよびNMITEM3カラムについて次に示します。そのほかのカラム名については,「付録D.3(7) BLC_FILE_Tテーブル」を参照してください。

表H-12 BLC_FILE_Tテーブルのカラム名一覧

カラム名 データ型 サイズ
(バイト)
意味 備考
NMITEM1 VARCHAR 128 タイトル タイトルには添付書類名称を設定します。添付書類名称は128バイト以下になるように設定してください。
 
注 添付書類名称はEUR Form帳票定義ファイルを作成するときに設定します。
NMITEM2 VARCHAR 128 添付種別 DEMAND:指定添付ファイル
FREE:自由添付ファイル
nullの場合は,指定添付ファイルとして処理します。
NMITEM3 VARCHAR 128 エンコードタイプ BINARY:未Base64タイプ
null:Base64タイプ
上記以外:Base64タイプ
(d) 処理のフロー

添付ファイル用サンプルデータのEUR Form帳票送信先URLのJSPファイルの処理フローを次に示します。

図H-6 EUR Form帳票送信先URLのJSPファイルの処理フロー

[図データ]

図の説明
  1. EURFormModelオブジェクトの設定処理
    BLCのAPIを使用して,EURFormModelオブジェクトの設定をします。
  2. ボタンをクリックしたときの処理
    [申請]ボタン,[承認]ボタンおよび[閉じる]ボタンは,既存のBLCEURProcessSample.jspと同様の処理をします。
図の説明
  1. ノード判定
    ノード名が"@Source"の場合は処理を終了します。"@Source"以外の場合は,データベースから添付ファイルを取得する処理をします。
  2. データベースからの添付ファイル取得処理
    BLCのAPIを使用して,データベースから添付ファイルの情報と実体を取得します。
  3. エンコードタイプ判定
    エンコードタイプが"BINARY"以外の場合はデコード処理をします。
  4. デコード処理
    取得した添付ファイルの実体をデコードします。
    エンコードタイプ:Base64
  5. 添付種別判定
    添付種別が"FREE"の場合,自由添付ファイル処理をします。"FREE"以外の場合,指定添付ファイル処理をします。
  6. 指定添付ファイル処理
    EUR Form ServiceのAPIを使用して,添付ファイルの情報および実体をEUR Form連携帳票へ設定します。
  7. 自由添付ファイル処理
    EUR Form ServiceのAPIを使用して,添付ファイルの情報および実体をEUR Form連携帳票へ設定します。
図の説明
  1. EFormModelオブジェクト取得処理
    BLCのAPIを使用して,EFormModelオブジェクトの取得処理をします。
  2. EFormAttachInfoオブジェクト取得処理
    EUR Form ServiceのAPIを使用して,EFormAttachInfoオブジェクトの取得処理をします。
  3. EFormAttachInfoオブジェクトからの添付ファイル取得処理
    EUR Form ServiceのAPIを使用して,EFormAttachInfoオブジェクトから添付ファイルの情報と実体を取得します。
  4. 既存添付ファイル数取得処理
    BLCのAPIを使用して,既存添付ファイル数を取得します。
図の説明
  1. 添付ファイル数ループ
    EUR Form連携帳票で添付したファイルをすべて処理するまで,2,3および4を繰り返します。
  2. 添付ファイル情報設定処理
    添付ファイルの情報を設定します。
  3. 添付ファイル更新処理
    ループ回数が既存添付ファイル数以内の場合,BLCのAPIを使用して,添付ファイルの情報と実体を更新します。
  4. 添付ファイル新規追加処理
    ループ回数が既存添付ファイル数より多い場合,BLCのAPIを使用して,添付ファイルの情報と実体を登録します。
  5. 削除対象数ループ
    EUR Form連携帳票で添付したファイル数が既存添付ファイル数を超えるまで,添付ファイル削除処理をします。
  6. 添付ファイル削除処理
    BLCのAPIを使用して,削除対象の添付ファイルの情報と実体を削除します。

(3) EUR Form連携帳票の添付ファイルを使う上での注意事項

添付できるファイル名は,マニュアル「電子フォームシステム EUR Form uCosminexus EUR Form サーバプログラム開発」を参照してください。

EUR Form連携帳票では,帳票データをBASE64でエンコードして送信します。そのため,HTTPリクエストの送信データサイズは実際の添付ファイルサイズよりも大きくなります。帳票のサイズチェック機能を利用する場合は,BLCプロパティのBLCMaxRequestSizeキーの設定値に注意してください。

EUR Form連携帳票のおおよその送信データサイズは,次の計算式を基に確認してください。

(帳票コントロールに入力する平均データ長
+(帳票コントロールに付けたメンバ名の平均の長さ×2))×帳票コントロール数
+添付ファイルサイズ×1.5

帳票コントロールおよびEUR Form連携帳票の送信データについては,マニュアル「電子フォームシステム EUR Form uCosminexus EUR Form システム設計・管理」を参照してください。

帳票のサイズチェック機能については,「付録H.3 帳票のサイズチェック機能」を参照してください。

アプリケーションサーバのメモリ不足で,通信エラーのポップアップがクライアント側に表示される場合があります。エラーが発生した場合は,添付ファイル処理とユーザ業務で追加した処理やセションのメモリ使用量の合計がCosminexusの最大ヒープサイズを超えていないか,次の計算式を基に確認してください。なお,次の計算式の単位はMB(メガバイト)です。

最大ヒープサイズ > 添付ファイルサイズ×係数※1×多重度+100※2+ユーザ追加業務処理やセションの消費メモリ
注※1
EUR Form連携帳票のアップロードおよびダウンロードの場合,係数は13です。
注※2
Cosminexusが消費するメモリです。

なお,Cosminexusの最大ヒープサイズの指定方法は,マニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。