IBM FormWave for WebSphere

IBM FormWave for WebSphere
バージョン 6.1.2
フィックス・パック ４
リリースノート
2011 年 12 月 公開
本版は IBM FormWave for WebSphere バージョン 6.1.2 に適用されます。
© Copyright International Business Machines Corporation 1999-2011. All rights reserved.
目次
はじめに.......................................................................................................................................................... ４
フィックス・パックの内容............................................................................................................................. ４
モジュールごとの修正履歴............................................................................................................................. ４
フィックス・パックの適用手順...................................................................................................................... ５
機能拡張項目 .................................................................................................................................................. ８
[15-338-60675]
転送機能の追加 ...........................................................................................................................８
修正項目.......................................................................................................................................................... ８
クライアント・サービス ........................................................................................................................... ８
[15-157-61039] schemaConversionを使用しても添付ファイルテーブルの情報がコンバージョンされない .........８
開発環境..................................................................................................................................................... ８
[15-020-51210] ローカルプロジェクトでアーカイブ定義を手入力で設定した時にIDの形式がおかしくなる .......８
付録A これまでにリリースしたフィックス一覧...................................................................................... １０
機能拡張項目 ......................................................................................................................................... １０
FixPack 1 追加分.................................................................................................................................. １０
クライアント・サービス ....................................................................................................................... １０
[14-007-38519]
[14-088-69912]
リッチ・ユーザーインターフェースのDojo Toolkit 1.3.1 対応 ........................................... １０
クライアント・サービスからFormWaveのバージョンを確認する方法の追加....................... １０
その他 .................................................................................................................................................... １０
[13-342-39917]
イベント処理で代行者を取得するAPIの拡張........................................................................... １０
FixPack 2 追加分.................................................................................................................................. １１
開発環境................................................................................................................................................. １１
[14-181-45011]
プロジェクト・テンプレート機能........................................................................................... １１
その他 .................................................................................................................................................... １１
[14-187-51558]
マルチ・テナント環境構築ガイド........................................................................................... １１
FixPack 3 追加分.................................................................................................................................. １１
クライアント・サービス ....................................................................................................................... １１
[14-132-41691]
[14-312-38353]
リッチ・ユーザーインターフェースのDojo Toolkit 1.4.1 対応 ........................................... １１
IBM拡張設定の「自動要求エンコーディング」対応 .............................................................. １２
フロー・エンジン .................................................................................................................................. １３
[14-152-48681]
setRollbackOnlyフラグを設定するAPIの追加........................................................................ １３
開発環境................................................................................................................................................. １３
[14-341-36881]
表形式のレイアウトファイルの自動生成 ................................................................................ １３
修正項目................................................................................................................................................. １４
FixPack 1 修正分.................................................................................................................................. １４
クライアント・サービス ....................................................................................................................... １４
[12-183-71653] 重複した代行レコードが生成される ......................................................................................... １４
[13-260-49974] ListGeneratorの_usersでAltManagerを指定するとエラーが発生する場合がある ............... １４
[13-323-59462] リッチ・ユーザーインターフェースでブランク伝票一覧が 20 件までしか表示されない ....... １４
[13-323-61898] リッチ・ユーザーインターフェースで代行者一覧およびグループ・メンバー一覧のstartRowがリ
セットされない.................................................................................................................................................... １５
[14-022-57366] リッチ・ユーザーインターフェースの検索条件入力画面でフィールド検索条件に不要な文字列が
表示される........................................................................................................................................................... １５
[14-025-45994] リッチ・ユーザーインターフェースの検索画面で日付フィールドの検索条件を指定した場合に正
しくないリクエストが送信される ....................................................................................................................... １５
[14-061-40866] マルチ・テナント機能で他テナントのアーカイブ定義が一覧に表示される........................... １６
[14-085-60304] Firefoxで状況表示を 2 回以上繰り返すとエラーが発生する.................................................. １６
開発環境................................................................................................................................................. １６
[12-324-51210]
フィールド定義のエクスポート時にコメントが空白だとnullが出力される ........................... １６
管理画面................................................................................................................................................. １７
[12-183-71653] 重複した代行レコードが生成される ......................................................................................... １７
[13-351-38330] 管理者の一覧にadminユーザーが表示されない ....................................................................... １７
[14-060-58110] マルチ・テナント機能でどのテナントにも属さないユーザーを作成できてしまう.................. １７
[14-070-43110] マルチ・テナント機能において管理者が自分自身の管理者権限を削除できてしまう ............ １８
[13-055-42532]
FirefoxとJREのバージョンによる組み合わせによりログイン画面が表示されない............... １８
フロー・エンジン .................................................................................................................................. １８
[12-191-63756]
同じ状況表示ACLレコードが複数入る ..................................................................................... １８
FixPack 2 修正分.................................................................................................................................. １９
開発環境................................................................................................................................................. １９
[14-180-37612]
[14-186-42475]
アーカイブ・ノードのアーカイブIDが不正な値に書き換えられてしまう ............................. １９
同期ノードのノード名を変更しても経路図に反映されない.................................................... １９
全般........................................................................................................................................................ １９
[14-159-54855] データベースへのログイン・ユーザーIDと、TenantInfoテーブルのスキーマ名が異なると、テ
ーブルアクセス時にエラーとなる ....................................................................................................................... １９
FixPack 3 修正分.................................................................................................................................. ２０
クライアント・サービス ....................................................................................................................... ２０
[14-208-64836] リッチ・ユーザーインターフェースのプロジェクトの検索画面で複数のプロジェクトが反映され
る ......................................................................................................................................................................... ２０
[14-208-64836] リッチ・ユーザーインターフェースで検索条件の内容が保持されたままになる ................... ２０
開発環境................................................................................................................................................. ２１
[14-188-65964]
[14-188-46371]
各ノードでのフィールド属性設定ダイアログのデフォルト属性の表示がおかしくなる......... ２１
インターフェース・デザイナーでエラー・チェックやサーバー登録時にエラーが発生する.. ２１
操作ログ................................................................................................................................................. ２２
[14-342-62623]
クライアント・サービス、管理サービスへのログイン時のログ情報が取得できない ............ ２２
フロー・エンジン .................................................................................................................................. ２２
[14-152-46170] プログラムノードなどから取得できるコネクションに対してrollbackなどの処理ができない２２
[14-312-37526] FilterConditionでORを含む条件を指定するとフロー・エンジンの動作がおかしくなる ...... ２２
[15-026-52706] 状況表示閲覧者IDにグループを指定した場合にそのメンバーで取消し・取戻しができない. ２３
付録B 転送機能 ........................................................................................................................................ ２４
転送機能とは ......................................................................................................................................... ２４
転送機能の適用例 .................................................................................................................................. ２４
転送機能を利用するための準備 ............................................................................................................ ２６
転送機能の操作...................................................................................................................................... ２９
３
はじめに
本書は、IBM® FormWaveTM for WebSphere® V6.1.2 フィックス・パック 3 のリリースノートです。本書では、今
回のフィックス・パックで修正された不具合や追加された新機能について説明します。
フィックス・パックの内容
フィックス・パックは ZIP 形式の圧縮ファイルで提供されます。この圧縮ファイルは、以下のファイルを含んでい
ます。
FW6123_ReleaseNote.pdf
このファイルです。
fcserver.jar
FormWave 本体の修正モジュールです。
FormConnect.jar
FormWave 開発環境の修正モジュールです。
FormWave.ear
FormWave の修正エンタープライズ・アプリケーションです。
plugin.xml
FormWave 開発環境の Eclipse プラグインの設定ファイルです。
fpjtemplate.ddl(.sql)
プロジェクト・テンプレート機能用に追加されたテーブルを作成するための
DDL ファイルです。
associate.bat/associate_del.bat
プロジェクト・テンプレート・ファイル（fpjt ファイル）および派生プロジ
ェクト・ファイル（xfpj ファイル）とプロジェクト・デザイナーとの関連付
けを行うためのバッチ・ファイルです。
com/ibm/FormConnect/eventsrc/logging/handler/sample/SampleOperationLogHandler
操作ログ機能のハンドラーの Java サンプルコードです。
doc/FormWaveV612FP2ProgrammersGuide.pdf
本フィックス・パックに対応した製品マニュアルです。
doc/FormWaveV612MultiTenantGuide.pdf
マルチ・テナント機能の環境を構築するための製品マニュアルです。
samples/template.jsp
レイアウト生成ウイザードで使用するテンプレートファイルのサンプルです。
samples/template.css
template.jsp ファイルから使用されている CSS ファイルのサンプルです。
ForwardJsp.zip
転送機能で使用するJSPです。利用方法については「付録B 転送機能」を参
照してください。
モジュールごとの修正履歴
以下の表は、V6.1.2 出荷版からの各モジュールの修正履歴です。各行のモジュールに対して、○印のついている列
に対応するフィックス・バックで修正もしくは機能拡張が行われています。
なお、本フィックス・パックには、出荷版から変更されたモジュールすべてが含まれています。表中で、今回のフィ
ックス・パックでは内容に変更がないものは▲、コードの変更はないがファイル内のバージョン情報のみ FP3 に変
更されているものは△となっています。
表中にないモジュールは出荷版から修正のないことを意味します。現在ご使用のバージョンとこの表をもとに、本フ
ィックス・パックに含まれるどのモジュールを適用する必要があるかをご確認ください。なお、各モジュールの詳細
な修正内容については「機能拡張項目」および「修正項目」を参照してください。
モジュール
JAR
EAR
その他
fcserver.jar
FormConnect.jar
FCApplets.jar(※1)
FormWave.ear
plugin.xml
FP1
○
○
○
○
FP2
○
○
▲
▲
○
フィックス・パック・レベル
FP3
FP4
○
○
○
○
△
▲
○
▲
▲
▲
マニュ
アル
:
:
:
:
○
◎
△
▲
fpjtemplate.ddl(.sql)
associate.bat/associate_del.bat
SampleOperationLogHandler.java
template.jsp
template.css
ForwardJsp.zip
プログラマーズ・ガイド
マルチ・テナント環境構築ガイド
◎
◎
○
▲
▲
▲
◎
◎
○
◎
▲
▲
▲
▲
▲
▲
▲
◎
▲
▲
修正／拡張
新規追加
バージョン情報のみ変更
変更なし
※1 FCApplets.jar は FormWave.ear に含めてリリースされています。
フィックス・パックの適用手順
１．修正モジュールの適用
以下の手順にしたがって各修正モジュールを適用してください。
① fcserver.jar の適用
FormWave が稼働するすべてのマシンについて以下の手順(1)～(3)を実行してください。
(1) WebSphere Application Server の管理コンソールで FormWave 関連の
エンタープライズ・アプリケーションを停止してください。
例）FormWave、FlowEngine、MessageService
(2) 現在ご利用の fcserver.jar のバックアップを取り、今回のモジュールで置き換えて下さい。
fcserver.jar は、以下のディレクトリーにあります。
（FormWave 導入ディレクトリー）/lib/fcserver.jar
例）/opt/FormWave/lib/fcserver.jar
(3) WebSphere Application Server の管理コンソールで FormWave 関連の
エンタープライズ・アプリケーションを再始動すれば適用完了です。
② FormConnect.jar の適用
FormWave 開発ツールパッケージが導入されているすべてのマシンについて以下のファイルを置換してください。
開発ツールパッケージ JRE 版の場合：
（FormWave 導入ディレクトリー）¥com.ibm.FormConnect.design.eclipse¥FormConnect.jar
開発ツールパッケージ Eclipse 版の場合：
（SDP 導入ディレクトリー）¥eclipse¥plugins¥com.ibm.FormConnect.design.eclipse¥FormConnect.jar
③ plugin.xml の適用
FormWave 開発ツールパッケージ Eclipse 版が導入されているすべてのマシンについて以下のファイルを置換して
ください。
（SDP 導入ディレクトリー）¥eclipse¥plugins¥com.ibm.FormConnect.design.eclipse¥plugin.xml
④ プロジェクト・テンプレート機能用のテーブルの追加
本フィックス・パックで提供の fpjtemplate.ddl(Oracle の場合には fpjtemplate.sql)ファイルを使用して、プロジェ
クト・テンプレート機能で使用するテーブルを追加します。
⑤ プロジェクト・ファイルとプロジェクト・デザイナーとの関連付け
５
本フィックス・パックで提供の associate.bat ファイルを実行して、プロジェクト・テンプレート機能で新たに追加
されたプロジェクト・テンプレート・ファイル（fpjt ファイル）および派生プロジェクト・ファイル（xfpj ファイル）
と、プロジェクト・デザイナーとの関連付けを行います。FormWave の開発環境がインストール済みであることが
前提です。関連付けを削除する場合は、associate_del.bat を実行してください。
⑥ サンプル操作ログ・ハンドラーに関連する修正の適用
本フィックス・パックに同梱のプログラマーズ・ガイド P.200 の『サンプル操作ログ・ハンドラーの使用方法』に
ある手順を参照してください。
以下は EAR ファイルの適用方法になります。。EAR ファイルを適用する場合には、必ず EAR ファイルの中に配置
しております、JSP ファイルや HTML ファイルなどのアプリケーションの成果物のバックアップをしてから作業を
行ってください。
⑦ FormWave.ear の適用
以下の手順(1)～(5)を実行してください。
(1) 既存の FormWave.ear ファイルの中に配置してあります、アプリケーションの成果物(JSP, HTML ファイル
などの Web リソースや、クラスファイルや jar ファイルなど)のバックアップを取得します。
(2) 本フィックス・パックで提供の FormWave.ear ファイルを Rational Software Development Platform や
WAS に付属の Application Server Toolkit などにインポートします。
(3) インポートした FormWave.ear ファイルに、以下の修正による変更が無いファイルについて手順(1)でバック
アップしたファイルを戻します。下記の変更ファイルについてカスタマイズされている場合は、上書きせず
にカスタマイズ内容を新しいファイルに適用してください。カスタマイズされていない場合は、手順(1)でバ
ックアップしたファイルを戻さずに新しいファイルをそのままご使用ください。
フィックス・パック・レ
ベル
FP1
FP3
変更ファイル
AdminServiceWAR/admin/AppletTag.js
AdminServiceWAR/admin/AdminMenu.html
AdminServiceWAR/admin/AppletTag.js
AdminServiceWAR/admin/ArchiveConfig.html
AdminServiceWAR/admin/DeptConfig.html
AdminServiceWAR/admin/FolderConfig.html
AdminServiceWAR/admin/FormClassConfig.html
AdminServiceWAR/admin/GroupConfig.html
AdminServiceWAR/admin/NotAuthorizedPage.html
AdminServiceWAR/admin/ProjectGroupConfig.html
AdminServiceWAR/admin/RoleConfig.html
AdminServiceWAR/admin/ServiceEndPointConfig.html
AdminServiceWAR/admin/StatConfig.html
AdminServiceWAR/admin/TenantInfoConfig.html
AdminServiceWAR/admin/UserConfig.html
ClientService/WebContent/fcscript/Util.js
ClientService/WebContent/fcscript/widget/FCSearchFieldConditionDialog.js
ClientService/WebContent/fcscript/widget/FCList.js
ClientService/WebContent/fcscript/widget/FCGrid.js
ClientService/WebContent/fcscript/widget/themes/FCButton.js
ClientService/WebContent/rclient/CoolMenu.jsp
ClientService/WebContent/rclient/SearchFormPage.jsp
ClientService/WebContent/rclient/SearchResultPage.jsp
ClientService/WebContent/rclient/script/CoolMenuFuncs.js
ClientService/WebContent/rclient/script/SearchFormPageFuncsjs
ClientService/WebContent/rclient/themes/CoolMenu.css
ClientService/WebContent/rclient/themes/SearchFormPage.css
ClientService/WebContent/rclient/themes/SearchResultPage.css
ClientService/WebContent/fcscript/Util.js
ClientService/WebContent/fcscript/widget/FCList.js
ClientService/WebContent/fcscript/widget/FCGrid.js
ClientService/WebContent/fcscript/widget/FCSearchFieldConditionDialog.js
ClientService/WebContent/rclient/script/SearchFormPageFuncs.js
６
(4)
(5)
ear ファイルをエクスポートします。
WAS の管理コンソールから、既存の FormWave アプリケーションを削除し、新たに手順(4)でエクスポート
した ear ファイルをインストールします。インストール方法は、製品マニュアルの「インストール・ガイド」
を参照してください。
２．フィックス・パックの適用確認
修正モジュールを適用後に、以下の手順にしたがって FormWave のバージョンを確認してください。
(1) FormWave 導入ディレクトリー下の engine ディレクトリーに移動します。
(2) 以下のコマンドを実行します。
Windows 版：
fctool FWVersion [Enter]
AIX 版/Linux 版： ./fctool.sh FWVersion [Enter]
(3) コマンドの実行結果を確認します。
6.1.2 の FixPack 4 場合は、
IBM FormWave for WebSphere
Version : 6.1.2.4
と表示されます。
開発ツールパッケージのバージョンは、プロジェクト・マネージャーの「サーバー」の表示部分で確認することがで
きます。また、プロジェクト・デザイナーを起動して、「プリファレンス」メニューの「プロジェクト・デザイナー
について」を表示することでも確認することができます。
７
機能拡張項目
[15-338-60675]
転送機能の追加
機能概要
人事異動などによって伝票の現在の処理者を変更する必要がある場合に、ノードを移動することなく現在の処理者を
変更する「転送機能」を追加しました。
機能詳細
転送機能の詳細については「付録B 転送機能」を参照してください。
関連ファイル
fcserver.jar, FormConnect.jar, ForwardJsp.zip
修正項目
クライアント・サービス
[15-157-61039] schemaConversion を使用しても添付ファイルテーブルの情報がコンバージョンされない
障害概要
fcinstall.propertiesファイルにschemaConversionのプロパティを設定した場合、添付ファイルのテーブル名の変換
時に例外が発生する。
障害詳細
DBのデータを別スキーマ名のテーブルに移行して、fcinstall.propertiesファイルにschemaConversionのプロパティ
を設定する。
schemaConversion=true
oldSchema=xxxxx
newSchema=xxxxx
そのデータを使用して伝票を処理した時に、以下のような例外が発生する。
[11/06/03 13:52:48:956 JST] 00000028 SystemErr
R [FC] 2011/06/03 13:52:48 JST 0022033474 WfmUtil
WfmUtil01327 DYOC00129: 却下処理でエラーが発生しました。<P>詳細情報：
[11/06/03 13:52:48:956 JST] 00000028 SystemErr
R com.ibm.FormConnect.field.FieldAccessException:
DYOF00020:添付ファイルのコピー処理でＳＱＬエラーが発生しました。エラー内容：ORA-00942: 表またはビューが
存在しません。
(DYOB00025)
影響範囲
添付ファイルを使用していない場合には影響ありません。
関連ファイル
fcserver.jar, FormConnect.jar
開発環境
[15-020-51210] ローカルプロジェクトでアーカイブ定義を手入力で設定した時に ID の形式がおかしくなる
障害概要
ローカルプロジェクトで、アーカイブノードの定義時に手入力でテナントIDなしのアーカイブIDを設定した場合に、
８
正しくないアーカイブIDが保存される。
障害詳細
ローカルプロジェクトで、アーカイブノードの定義時に手入力でテナントIDなしのアーカイブIDを設定した場合に、
保存時にアーカイブIDにテナントIDが付加されずに保存される。
影響範囲
アーカイブノードの定義時に手入力でテナント ID なしのアーカイブ ID を設定した場合のみ正しくない形式でアーカ
イブ ID が保存されます。
関連ファイル
fcserver.jar, FormConnect.jar
９
付録A
これまでにリリースしたフィックス一覧
機能拡張項目
FixPack 1 追加分
クライアント・サービス
[14-007-38519]
リッチ・ユーザーインターフェースの Dojo Toolkit 1.3.1 対応
機能概要
リッチ・ユーザーインターフェースのサンプル画面および FormWave JavaScript ライブラリーを Dojo Toolkit 1.3.1
に対応しました。
機能詳細
V6.1.2 GA 版では、Dojo Toolkit 1.1.1 のみがサポート対象となっていましたが、WAS Feature Pack for Web2.0
1.0.0.2 を導入した場合、Dojo Toolkit のバージョンは 1.3.1 が導入されますので、Dojo Toolkit 1.3.1 でも正常に動
作するように対応しました。
関連ファイル
FormWave.ear
[14-088-69912]
クライアント・サービスから FormWave のバージョンを確認する方法の追加
機能概要
クライアント・サービスで使用されている fcserver.jar のバージョンを表示します。
機能詳細
Web ブラウザーで以下の URL を指定すると、画面にクライアント・サービスが参照している fcserver.jar のバージ
ョン情報が表示されます。
http://(ホスト名)/(アプリケーション名)/client/version.html
V6.1.2 FixPack 1 の場合は以下のようになります。
IBM FormWave for WebSphere V6.1.2.1(Build 5 APR 2010)
(C) Copyright IBM Corp. 1999-2010 All rights reserved.
関連ファイル
FormWave.ear
その他
[13-342-39917]
イベント処理で代行者を取得する API の拡張
機能概要
クライアント・サービス、フロー・エンジン両方のイベント処理から使用可能な、代行者を取得するための API を
拡張します。
機能詳細
クライアント・サービス、フロー・エンジンのイベント処理から取得できるイベントコンテキスト
(ClientEventContext, EngineEventContext)に以下の 4 つの API を追加しました。
1. getCurrentAllStaticDelegatees(String userId)
指定されたユーザーの、現在有効なすべての静的代行者を取得します。
UserInformation の Vector を返します。
2. getCurrentStaticDelegatees(String userId)
指定されたユーザーの、現在のフローの伝票定義に関して有効な静的代行者を取得します。
UserInformation の Vector を返します。
3. getCurrentDynamicDelegatees(String userId)
指定されたユーザーの、現在有効なすべての動的代行者を取得します。
UserInformation の Vector を返します。
4. getCurrentDynamicDelegatees(String userId, String formRecordId)
指定されたユーザーの、指定した伝票(formRecordId)に関して有効な動的代行者を取得します。
UserInformation の Vector を返します。
関連ファイル
fcserver.jar
FixPack 2 追加分
開発環境
[14-181-45011]
プロジェクト・テンプレート機能
機能概要
複数のプロジェクトで共通の定義部分をテンプレート化して再利用できる機能を提供します。
機能詳細
プロジェクトを開発する際に、複数のプロジェクト・データに共通の定義部分を切り出しプロジェクト・テンプレー
トとして登録、保存できる機能を提供します。プロジェクト・テンプレートからは、それをベースとした派生プロジ
ェクトをいくつでも作成することができます。この機能により、類似したプロジェクトの効率的な開発やマルチ・テ
ナント環境下での複数テナントへの効率的なプロジェクトの展開が可能となります。
この機能の使用方法については、本フィックス・パックに同梱のプログラマーズ・ガイドの『第 13 章 プロジェク
ト・テンプレート機能』を参照してください。
関連ファイル
fcserver.jar, FormConnect.jar, plugin.xml, fpjtemplate.ddl(.sql), associate.bat/associate_del.bat
その他
[14-187-51558]
マルチ・テナント環境構築ガイド
機能概要
マルチ・テナント環境を構築するための新規ガイドを作成しました。
機能詳細
V6.1.2 より追加されたマルチ・テナント機能の環境を構築する時のガイドを作成しました。本フィックス・パック
に同梱の FormWaveV612MultiTenantGuide.pdf で提供されています。
関連ファイル
FormWaveV612MultiTenantGuide.pdf
FixPack 3 追加分
クライアント・サービス
[14-132-41691]
リッチ・ユーザーインターフェースの Dojo Toolkit 1.4.1 対応
機能概要
リッチ・ユーザーインターフェースのサンプル画面および FormWave JavaScript ライブラリーを Dojo Toolkit 1.4.1
１１
に対応しました。
機能詳細
V6.1.2 GA 版では Dojo Toolkit 1.1.1、V6.1.2 FP1 では Dojo Toolkit 1.3.1 までがサポート対象となっていましたが、
WAS Feature Pack for Web2.0 V1.0.1 を導入した場合、Dojo Toolkit のバージョンは 1.4.1 が導入されますので、
Dojo Toolkit 1.4.1 でも正常に動作するように対応しました。
関連ファイル
FormWave.ear
[14-312-38353] IBM 拡張設定の「自動要求エンコーディング」対応
機能概要
IBM の拡張設定である「自動要求エンコーディング」を設定した場合に、正常に動作させるための機能を追加しま
した。
機能詳細
IBM 拡張設定である「自動要求エンコーディング」の設定に対応していないために、もしこのフラグを設定すると、
状況表示の検索文字列が文字化けしてしまい、正常に状況表示が検索できない問題が発生します。検索文字を
FormWave の内部でもエンコーディングを行っているために、二重でエンコーディングされてしますのが原因です。
この問題を回避するために、fcinstall.properties ファイルに以下のプロパティを true に設定することで、FormWave
の内部では、検索文字のエンコーディングを行なわないようになります。これにより、「自動要求エンコーディング」
を設定しても正常に動作するようになります。
client.auto.encoding=true
また、FormWave がサンプルとして提供している JSP ファイルの中でもエンコードを行うロジックが入っています。
「自動要求エンコーディング」を設定した場合には、もし FormWave 提供の JSP ファイルをカスタマイズして使用
されている場合、JSP ファイルの修正を行う必要があります。
例えば BlueMenu.jsp ファイルでは、以下の部分のエンコードロジックが不要になります。
例 : BlueMenu.jsp ファイルの場合(L739～L747)
<% String ss = (request.getParameterValues("ss") == null)?"": request.getParameterValues("ss")[0];
// WAS 側の「自動要求エンコード」を有効にした場合には、この部分の処理が不要ですので、
// コメントアウトしてください。
// String enc = request.getCharacterEncoding();
// if (enc == null) {
//
enc = "ISO-8859-1";
// }
// if (!enc.equals("Shift_JIS")) {
//
ss = new String(ss.getBytes(enc), "Shift_JIS");
// }
String sm = (request.getParemeterValues("sm") == null?"":request.getParameterValues("sm")[0];
………
%>
また、BlueMenu.jsp の他にも、以下の JSP ファイルに同じロジックが入っていますので、カスタマイズして使用
されている場合には、以下のファイルもあわせて修正してください。
・状況表示の検索フィールド
LightMenu.jsp
Status.jsp
・アドレス帳の検索フィールド
Users.jsp
１２
関連ファイル
fcserver.jar
フロー・エンジン
[14-152-48681]
setRollbackOnly フラグを設定する API の追加
機能概要
プログラムノード、フロー・エンジンのイベント処理、通知フレームワークの Java プログラムから、2PC のトラン
ザクションに対して setRollbackOnly のフラグを設定するための API を追加しました。
機能詳細
プログラムノード、フロー・エンジンのイベント処理、通知フレームワークのそれぞれのコンポーネントが使用可能
である以下のクラスに setRollbackOnly()の API を追加しました。この API を呼び出すことにより、伝票処理全体
のトランザクションがロールバックされます。
プログラムノード用 : JavaProgramNode クラス
フロー・エンジンのイベント処理用 : EngineEventContext クラス
通知フレームワーク用 : NofiticationContext クラス
また、この API は、フロー・エンジンが 2PC モードで動作している場合にのみ有効です。フロー・エンジンが 1PC
モードで動作している場合には、この API を呼び出してもトランザクションはロールバックされません。
関連ファイル
fcserver.jar
開発環境
[14-341-36881]
表形式のレイアウトファイルの自動生成
機能概要
レイアウト生成ウイザードにて、表形式のレイアウトファイルを自動生成する機能を追加しました。
機能詳細
レイアウト生成ウイザードにフィールドの出力形式として「表形式で出力する」、「フィールドを 2 列で出力する」
の 2 つの設定を追加しました。 これにより、フィールドが表形式で出力されたレイアウトファイルを自動で生成す
ることができるようになりました。
また、レイアウトのテンプレート JSP ファイルを使用した場合には、フィールドタイプごとに以下の class 属性を
付加するようにしました。この class 属性値を利用した CSS ファイルを組み合わせて使用していただくことで、簡
単にきれいなレイアウトファイルを作成することができるようになります。
また、本フィックス・パックの sample ディレクトリー以下に、サンプルのテンプレート JSP ファイル(template.jsp)
と CSS ファイル(template.css)がありますので、必要に応じてカスタマイズして使用してください。
出力タイプ
テキストフィールド
テキストエリア
隠しフィールド
ラジオボタン
チェックボックス
ドロップダウンリスト
リストボックス
スタティックテキスト
class属性値
fw_textFieldStyle
fw_textAreaStyle
fw_hiddenStyle
fw_radioStyle
fw_checkBoxStyle
fw_listStyle
fw_listStyle
fw_staticTextStyle
また、この機能を使用したレイアウト生成の Flash デモを以下の URL からご覧いただくことができますので、是非
ご覧ください。
１３
http://www.ibm.com/software/jp/websphere/formwave/fwdemo.html
関連ファイル
FormConnect.jar
修正項目
FixPack 1 修正分
クライアント・サービス
[12-183-71653] 重複した代行レコードが生成される
障害概要
すでに存在する代行権限と全く同じ条件の代行権限を追加することができてしまう。
障害詳細
代行者の設定画面から、すでに存在する代行権限と全く同じ条件の代行権限を指定して追加ボタンを押します。そう
すると、代行権限が追加され、Delegation テーブルに重複した内容のレコードが生成されます。本来は、全く同じ
条件の代行レコードが複数生成される必要はないため、代行権限を追加する時に、全く同じ権限のレコードが存在し
た場合には、追加しないように修正しました。
影響範囲
重複した代行レコードが作成されても動作上の影響はありません。
関連ファイル
fcserver.jar
[13-260-49974] ListGenerator の_users で AltManager を指定するとエラーが発生する場合がある
障害概要
ListGenerator のタイプが”_users”の時に、addColumn でアクセス・ルール ID の AltManager を指定すると、エラ
ーが発生する場合がある。
障害詳細
ListGenerator のタイプが"_users"のとき、addColumn でアクセス・ルール ID の AltManager を指定すると、代替
上司が存在しなかったり、複数存在して特定できない場合などにエラーが発生しました。
addColumn でアクセス・ルール ID の Manager を指定した場合には、上司が特定できない場合でもエラーが発生せ
ずに空文字が戻ります。この動作と同様に AltManager を指定した時にも、エラーが発生するのではなく空文字を
戻すように修正しました。
影響範囲
addColumn でアクセス・ルール ID の AltManager を指定していない場合には影響ありません。また指定していて
も、AltManager が一意に特定される場合には影響ありません。
関連ファイル
fcserver.jar
[13-323-59462]
リッチ・ユーザーインターフェースでブランク伝票一覧が 20 件までしか表示されない
障害概要
リッチ・ユーザーインターフェースのサンプル画面でブランク伝票の一覧を表示した時に、ブランク伝票が 20 件ま
でしか表示されない。
障害詳細
リッチ・ユーザーインターフェースのサンプル画面を使用してブランク伝票の一覧を開いた時に、ログインしたユー
１４
ザーが起票できる伝票が 21 件以上登録されていても 20 件までしか表示されませんでした。
ブランク伝票の一覧を表示する時にも、maxRows に 20 がセットされていることが原因ですので、ブランク伝票の
一覧を表示する時には、maxRows に 0 を設定するように修正しました。
影響範囲
リッチ・ユーザーインターフェースを使用していない場合には影響ありません。
関連ファイル
FormWave.ear
[13-323-61898] リッチ・ユーザーインターフェースで代行者一覧およびグループ・メンバー一覧の startRow がリ
セットされない
障害概要
リッチ・ユーザーインターフェースのサンプル画面を使用して、代行者の一覧およびグループ・メンバーの一覧を表
示した時に、開始件数が 1 からでなく途中から表示される場合がある。
障害詳細
リッチ・ユーザーインターフェースのサンプル画面を使用して、まず処理待ちなどの伝票一覧を表示し、ページ移動
のリンクをクリックして 2 ページ目へ遷移させます。その状態から、代行者一覧およびグループ・メンバー一覧を
表示すると、開始件数（startRow）が 1 からではなく、2 ページ目から表示される場合があります。
代行者一覧およびグループ・メンバー一覧の表示の際に、startRow が 1 にリセットされていないのが原因でしたの
で、リセットするように修正しました。
影響範囲
リッチ・ユーザーインターフェースを使用していない場合には影響ありません。
関連ファイル
FormWave.ear
[14-022-57366]
リッチ・ユーザーインターフェースの検索条件入力画面でフィールド検索条件に不要な
文字列が表示される
障害概要
リッチ・ユーザーインターフェースの検索条件入力画面で、アーカイブのフィールド検索条件を指定すると、その検
索条件のリストに不要な文字列が表示される。
障害詳細
リッチ・ユーザーインターフェースの検索条件入力画面にログインして、アーカイブ検索条件のフィールド検索条件
を追加します。その際、テキスト型フィールドに対して「等しい」以外の条件を指定します。
そうすると、フィールド検索条件をリストするテーブルに、指定した条件が追加されますが、この時のフィールド値
の表示に"（完全一致）"という不要なテキストが付加されてしまいます。
影響範囲
検索機能を使用していない場合には影響ありません。また検索機能を使用していても、リッチ・ユーザーインターフ
ェイスの検索画面を使用していない場合には影響ありません。
関連ファイル
FormWave.ear
[14-025-45994] リッチ・ユーザーインターフェースの検索画面で日付フィールドの検索条件を指定した場合に
正しくないリクエストが送信される
障害概要
リッチ・ユーザーインターフェースの検索画面で、アーカイブの日付フィールドの検索条件を指定した場合に、正し
くないリクエストが送信される。
１５
障害詳細
リッチ・ユーザーインターフェースの検索条件入力画面から、日付フィールドに対して、「以前」の検索条件を追加
します。(例 : 2010/04/01 以前)
この場合に、条件値で指定された日付に対して、本来は”23:59:59”の時間情報を付加してサーバーへ送信するのが正
しいですが、実際には”0:0:0”を付加してサーバーへ送信していました。そのため、指定した日付の当日の情報が検索
結果に含まれない現象が発生しました。
影響範囲
検索機能を使用していない場合には影響ありません。また検索機能を使用していても、リッチ・ユーザーインターフ
ェイスの検索画面を使用していない場合には影響ありません。
関連ファイル
FormWave.ear
[14-061-40866] マルチ・テナント機能で他テナントのアーカイブ定義が一覧に表示される
障害概要
マルチ・テナント機能を使用している場合に、あるユーザーがアーカイブ定義の一覧を表示した時に、他のテナント
で定義したアーカイブ定義が表示される場合がある。
障害詳細
マルチ・テナント機能を使用して、各テナントでテナントローカルのアーカイブを作成し、そのアーカイブ定義で「伝
票ごとのアクセス制御」を使用するように設定します。
その時に、あるユーザーが、アーカイブ定義一覧の画面を表示した時に、そのユーザーが属していない他のテナント
で定義したローカルのアーカイブ定義が一覧に表示されてしまいました。
影響範囲
マルチ・テナント機能を使用していない場合には影響ありません。また、マルチ・テナント機能を使用していても、
アーカイブを使用していない場合や、アーカイブの定義で「伝票ごとのアクセス制御」を使用していない場合には影
響ありません。
関連ファイル
fcserver.jar
[14-085-60304]
Firefox で状況表示を 2 回以上繰り返すとエラーが発生する
障害概要
Firefox を使用して、送付済みや処理済み伝票から、状況表示 → 戻る → 状況表示 と状況表示を 2 回以上繰り返
すとエラーが発生する。
障害詳細
Firefox を使用して、送付済みや処理済み伝票をオープンして、状況表示 → 戻る → 状況表示 と画面を遷移させ
て、状況表示を 2 回以上繰り返します。そうすると、「DYOC00109:伝票がメモリー中にありません。再度オープ
ンし直してください。」のエラーが出力され、状況表示が表示できませんでした。
影響範囲
Internet Explorer を使用している場合には影響ありません。
関連ファイル
fcserver.jar
開発環境
[12-324-51210]
フィールド定義のエクスポート時にコメントが空白だと null が出力される
障害概要
コメントが空白であるフィールド定義をエクスポートすると、そのフィールドのコメント箇所に”null”という文字が
出力される。
１６
障害詳細
プロジェクト・デザイナーで、フィールド定義をエクスポートした際に、コメントが空白であったフィールドのコメ
ント箇所に"null"という文字が出力されました。
既存のプロジェクト・ファイルをプロジェクト・デザイナーによりオープンした後でエクスポートすると出力されま
すが、新規にプロジェクト・ファイルを作成してエクスポートした直後は出力されません。
影響範囲
フィールド定義のエクスポートを行なわない場合には影響ありません。
関連ファイル
FormConnect.jar
管理画面
[12-183-71653] 重複した代行レコードが生成される
障害概要
すでに存在する代行権限と全く同じ条件の代行権限を追加することができてしまう。
障害詳細
代行者の設定画面から、すでに存在する代行権限と全く同じ条件の代行権限を指定して追加ボタンを押します。そう
すると、代行権限が追加され、Delegation テーブルに重複した内容のレコードが生成されます。本来は、全く同じ
条件の代行レコードが複数生成される必要はないため、代行権限を追加する時に、全く同じ権限のレコードが存在し
た場合には、追加しないように修正しました。
影響範囲
重複した代行レコードが作成されても動作上の影響はありません。
関連ファイル
fcserver.jar
[13-351-38330] 管理者の一覧に admin ユーザーが表示されない
障害概要
管理者の一覧に、FormWave のシステム・デフォルトの管理者「admin」ユーザーが表示されない。
障害詳細
メニューの「管理者」を選択した時に表示される管理者の一覧に、FormWave のシステム・デフォルトで登録され
る管理者「admin」ユーザーが表示されませんでした。
影響範囲
管理者一覧には表示されませんが、「admin」ユーザーの管理者としての動作には影響ありません。
関連ファイル
FormWave.ear
[14-060-58110] マルチ・テナント機能でどのテナントにも属さないユーザーを作成できてしまう
障害概要
マルチ・テナント機能を使用している場合に、どのテナントにも属していないユーザーを作成することができてしま
う。
障害詳細
マルチ・テナント機能を使用していて、テナント情報が一つの定義されていない状態で、ユーザーの追加画面を表示
します。この時に、テナント ID に指定できるテナントが存在しないため、そのままユーザーの追加を行うと、どの
テナントにも属さないユーザーが作成されてしまいました。
１７
影響範囲
マルチ・テナント機能を使用していない場合には影響ありません。また、マルチ・テナント機能を使用している場合
でも、テナントが最低一つ定義されていれば、この現象は発生しません。
関連ファイル
FormWave.ear
fcserver.jar
[14-070-43110]
マルチ・テナント機能において管理者が自分自身の管理者権限を削除できてしまう
障害概要
マルチ・テナント機能を使用している場合に、ログインしているローカル管理者が、管理者の設定画面から、自分自
身を削除できてしまう。
障害詳細
マルチ・テナント機能を使用していて、ローカル管理者の権限でログインします。左メニューの「管理者」を選択し
て、管理者の一覧から自分自身を選択して、削除ボタンを押します。確認ダイアログで OK ボタンを押すと、管理
者の削除処理は成功して、ログインユーザー自身の管理権限が削除できてしまいました。
影響範囲
マルチ・テナント機能を使用していない場合には影響ありません。また、マルチ・テナント機能を使用している場合
にも、グローバル管理者の権限でログインしている場合には影響ありません。
関連ファイル
FormWave.ear
[13-055-42532] Firefox と JRE のバージョンによる組み合わせによりログイン画面が表示されない
障害概要
Firefox と JRE のバージョンの組み合わせにより、管理画面にアクセスした時にログイン画面が表示されない場合
がある。
障害詳細
Firefox V3.0 または V3.5 + Sun の JRE V5.0, V6.0 の組み合わせで、管理画面にアクセスすると、以下のエラーダ
イアログが出力され、ログイン画面が表示されない場合がありました。
Java 1.1.4 以降のバージョンをサポートしているブラウザー
を必要とするアプレットが見つかりました。
Microsoft Internet Explorer 4.0 またはそれ以降
Netscape Communicator 4.06 またはそれ以降
JDK のバージョンチェックを行う JavaScript のロジックに問題がありましたので修正しました。
影響範囲
Internet Explorer を使用している場合には影響ありません。
関連ファイル
FormWave.ear
フロー・エンジン
[12-191-63756]
同じ状況表示 ACL レコードが複数入る
障害概要
全く同じ条件の状況表示 ACL レコードが複数生成される場合がある。
障害詳細
例えば、起票者 → 承認者 → 第二承認者 というような経路があり、「状況表示は処理者も参照可能」が設定され
１８
ているとします。
伝票を起票後に、「承認者」が承認処理を行って、「第二承認者」が差戻しを行ったとします。この時点で「承認者」
と「第二承認者」に状況表示の参照権限が与えられます。その後、「承認者」が再び承認処理を行うと、「承認者」
に状況表示の参照権限が再度付加され、重複した状況表示の ACL レコードが作成されます。
本来は、全く同じ条件の ACL レコードが複数生成される必要はないため、ACL レコードを追加する時に、全く同じ
条件の ACL が存在した場合には、追加しないように修正しました。
影響範囲
重複した状況表示 ACL レコードが作成されても動作上の影響はありません。
関連ファイル
fcserver.jar
FixPack 2 修正分
開発環境
[14-180-37612]
アーカイブ・ノードのアーカイブ ID が不正な値に書き換えられてしまう
障害概要
マルチ・テナント機能がオンの場合に、プロジェクト・デザイナーでアーカイブ・ノードのアーカイブ ID の値が自
動で不正な値に書き換えられてしまう。
障害詳細
マルチ・テナント機能がオンの場合に、プロジェクト・デザイナーからサーバー登録を実行する際に、アーカイブ・
ノードのアーカイブ ID の値が不正な値に自動で書き換えられてしまいます。具体的には、アーカイブ ID の指定に”
フィールド”を選択して任意のフィールド名を設定していると、サーバー登録のタイミングで自動的にテナント情報
（デリミターとテナント ID）がフィールド名に付加されてしまいます。
影響範囲
マルチ・テナント機能がオンでない場合は影響ありません。また、マルチ・テナント機能がオンであっても、経路定
義上にアーカイブ・ノードが無い場合は影響ありません。
関連ファイル
FormConnect.jar
[14-186-42475]
同期ノードのノード名を変更しても経路図に反映されない
障害概要
プロジェクト・デザイナーで同期ノードのノード名を変更しても、経路図のノード・アイコンの表示に反映されない
場合がある。
障害詳細
プロジェクト・デザイナーの経路図で同期ノードを選択し、「プロパティ」タブでノード名を変更しても経路図のノ
ード・アイコンに表示されるノード名に変更が反映されない場合があります。ただし、ノード名の変更がノード・ア
イコンに反映されていない状態であっても、ファイルに保存される時やサーバー登録が実行される時には変更した値
で処理が実行されます。
影響範囲
経路定義上に同期ノードが無い場合は影響ありません。
関連ファイル
FormConnect.jar
全般
[14-159-54855]
データベースへのログイン・ユーザーID と、TenantInfo テーブルのスキーマ名が異なると、テー
１９
ブルアクセス時にエラーとなる
障害概要
マルチ・テナント機能がオンの場合に、データベースへアクセスするログイン・ユーザーID と、TenantInfo テーブ
ルのスキーマ名が異なると、クライアント・サービスやフロー・エンジンで TenanntInfo テーブルへのアクセス時
にエラーとなる。
障害詳細
データベースへアクセスするログイン・ユーザーID は、アプリケーション・サーバーの管理画面で、データソース
毎に設定されます。またアプリケーションから各テーブルへのアクセス時にスキーマ名を指定しない場合に規定値と
してログイン・ユーザーID が使われます。FormWave では FormWave リポジトリーアクセス時のスキーマ名を
fcservice.properties に保持し、利用していましたが、TenantInfo テーブルへのアクセス時にその設定を参照してい
ませんでした。そのため、データベースへのログイン・ユーザーID と、スキーマ名が異なると、実行時に TenantInfo
テーブルが見つからず、エラーとなり、すべての操作が出来なくなります。
影響範囲
マルチ・テナント機能がオンでない場合は影響ありません。また、マルチ・テナント機能がオンであっても、データ
ベースへのログイン・ユーザーID と、TenantInfo テーブルのスキーマ名が同じならば、影響ありません。
関連ファイル
fcserver.jar
FixPack 3 修正分
クライアント・サービス
[14-208-64836]
リッチ・ユーザーインターフェースのプロジェクトの検索画面で複数のプロジェクトが反映される
障害概要
リッチ・ユーザーインターフェースの検索機能画面のプロジェクト選択画面において、複数のプロジェクトのラジオ
ボタンをクリックして OK ボタンを押すと、検索画面のフィールドに、クリックした複数のプロジェクトがカンマ
区切りで反映されてしまいます。
障害詳細
ラジオボタンでは複数の行を選択できませんが、検索画面のフィールドへ値を反映する時に、最後に選択された値で
はなく、クリックしたすべての値を反映してしまっているのが原因でした。
影響範囲
リッチ・ユーザーインターフェースを使用していない場合には問題ありません。また、リッチ・ユーザーインターフ
ェースを使用している場合でも、検索機能を使用していない場合には問題ありません。
関連ファイル
FormWave.ear
[14-208-64836]
リッチ・ユーザーインターフェースで検索条件の内容が保持されたままになる
障害概要
リッチ・ユーザーインターフェースの状況表示一覧画面で、検索を実行した後に、アーカイブ一覧画面を開いてアー
カイブ伝票を検索しようとすると、状況表示一覧画面で検索した文字列が表示されたままになる場合があります。
障害詳細
リッチ・ユーザーインターフェースにおいて、まず状況表示の一覧画面を開いて、任意の条件で状況表示の検索を行
います。その検索を行った後に、アーカイブ伝票の一覧画面の検索部分を表示すると、先ほど状況表示で検索した時
の情報が残ってしまう場合があります。一覧画面を切り替えた時に、内部で保持している検索条件がクリアされてい
ないのが原因でした。
影響範囲
２０
リッチ・ユーザーインターフェースを使用していない場合は問題ありません。また、検索文字列はフィールド上に残
ってしまいますが、文字列を上書きして検索すれば正常に検索はできます。
関連ファイル
FormWave.ear
開発環境
[14-188-65964]
各ノードでのフィールド属性設定ダイアログのデフォルト属性の表示がおかしくなる
障害概要
各ノードでのフィールド属性の設定ダイアログで、デフォルト属性の表示がおかしくなる場合があります。
障害詳細
人が処理するノード(処理者、上司、グループなど)でのフィールド属性の設定ダイアログにおいて、例えば「起票者」
ノードでフィールド属性の設定を行った場合に、その「起票者」以外のノード、例えば「上司」ノードの設定ダイア
ログを開くと、「デフォルト」属性の値が、「起票者」ノードで設定した値が表示されてしまいます。
値を表示する時に、フィールド定義のデフォルトの設定値ではなく、ノードで設定した値を表示しているのが原因で
す。
影響範囲
間違った値が表示されていますが、FormWave の内部では正常な値を保持していますので動作に影響はありません。
関連ファイル
FormConnect.jar
[14-188-46371]
インターフェース・デザイナーでエラー・チェックやサーバー登録時にエラーが発生する
障害概要
インターフェース・デザイナーで、エラー・チェックやサーバー登録を行おうとすると、内部でエラーが発生して、
処理が先に進まない現象が発生する場合があります。
障害詳細
この現象は、インターフェース・デザイナーでフィールド・グループを定義した後に、プロジェクト・デザイナーか
らフィールド・グループに含まれているフィールドを削除した場合に発生します。この現象が発生すると、画面上は
処理が先に進まなくなり、開発環境のログファイルには、以下のようなエラーが出力されます。
java.lang.NullPointerException
at com.ibm.FormConnect.design.soa.InterfaceDesignerVerifier.verifyFieldGroupContent
at com.ibm.FormConnect.design.soa.InterfaceDesignerVerifier.verifyFieldGroupDefinition
at com.ibm.FormConnect.design.soa.InterfaceDesignerVerifier.verify
at com.ibm.FormConnect.design.soa.InterfaceEditor.verify
at com.ibm.FormConnect.design.soa.InterfaceDesignerFrame.projectRegister
at com.ibm.FormConnect.design.soa.InterfaceDesignerFrame.projectRegister
at com.ibm.FormConnect.design.soa.InterfaceDesignerFrame.registProjectAction
at com.ibm.FormConnect.design.soa.RegistProjectAction.run
プロジェクト・デザイナーでフィールドを削除した時に、フィールド・グループの定義から、このフィールドを削除
していないのが原因でした。
影響範囲
インターフェース・デザイナーを使用していない場合には影響ありません。また、フィールド・グループに含まれて
いるフィールドをインターフェース・デザイナーで削除した場合には、この現象は発生しません。
関連ファイル
FormConnect.jar
２１
操作ログ
[14-342-62623]
クライアント・サービス、管理サービスへのログイン時のログ情報が取得できない
障害概要
クライアント・サービス、管理サービスへログインした時の操作ログ情報が取得できません。
障害詳細
クライアント・サービス、管理サービスへログインしたタイミングで、操作ログ用のハンドラーの呼び出しが行われ
ていないのが原因です。
影響範囲
この現象はフィックス・パック 1, フィックス・パック 2 をご使用の場合に発生します。GA 版をご使用の場合には、
この現象は発生しません。
関連ファイル
fcserver.jar
フロー・エンジン
[14-152-46170]
プログラムノードなどから取得できるコネクションに対して rollback などの処理ができない
機能概要
フロー・エンジンが 1PC モードで動作している場合に、プログラムノード、フロー・エンジンのイベント処理、通
知フレームワークの Java プログラムから取得可能な DB のコネクションに対して、commit や rollback の処理がで
きません。
機能詳細
フロー・エンジンが 1PC モードで動作している場合にも、プログラムノード、フロー・エンジンのイベント処理、
通知フレームワークの Java プログラムから取得可能な DB のコネクションに対して、commit や rollback の処理を
行っても、その処理が無効になっているのが原因でした。
影響範囲
フロー・エンジンが 2PC モードで動作している場合には、元々、ローカルトランザクションで commit や rollback
などの処理を行うことはできませんので影響ありません。
関連ファイル
fcserver.jar
[14-312-37526] FilterCondition で OR を含む条件を指定するとフロー・エンジンの動作がおかしくなる
機能概要
FilterCondition, APFilterCondition の設定で OR を含む条件を指定すると、サスペンドされた伝票に対してのスキ
ップ処理が繰り返され、動作がおかしくなる場合があります。
機能詳細
FilterCondition, APFilterCondition に OR の条件を指定した場合に、フロー・エンジンが ServerQueue テーブル
から処理するレコードを取得する時に発行する SQL の where 句にそのまま指定された条件を付加していたため、不
正な SQL が発行されてしまいました。FilterCondition で指定した条件を where 句に付加する時に、その条件を括
弧で囲んでいないのが原因でした。
影響範囲
FilterCondition を指定していない場合には影響ありません。また指定していても OR を含まない条件や、OR を含
んでいても条件全体を括弧で囲んでいる場合には影響ありません。
関連ファイル
fcserver.jar
２２
[15-026-52706]
状況表示閲覧者 ID にグループを指定した場合にそのメンバーで取消し・取戻しができない
機能概要
状況表示閲覧者 ID にグループを指定して、そのグループのメンバーが伝票の取消し・取戻し処理を行った場合に、
フロー・エンジン側で処理がスキップされてしまい、取消し・取戻し処理が正常に行われない場合があります。
機能詳細
プロジェクトの定義で取消し・取戻し処理が禁止に設定されている場合でも、その伝票の管理者または状況表示閲覧
者 ID に指定したユーザーまたはグループのメンバーは取消し・取戻し処理を行うことができます。状況表示閲覧者
ID にグループを指定した場合に、そのグループのメンバーで取消し・取戻し処理を行なうと、フロー・エンジン側
で処理がスキップされてしまい正常に処理が行われません。
取消し・取戻し処理の権限チェックで、状況表示閲覧者 ID にグループが指定されていることを考慮されていないの
が原因でした。
影響範囲
状況表示閲覧者 ID にグループを指定していても、伝票の取消し・取戻しが禁止されていない場合には影響ありませ
ん。また、状況表示閲覧者 ID にユーザーを指定している場合には影響ありません。
関連ファイル
fcserver.jar
２３
付録B
転送機能
転送機能とは
ワークフロー・システムにおいて以下のような状況で、伝票の現在の処理者(所有者)の変更をしたい場合がありま
す。その場合、これまでは代行者の一時的な設定などの運用による対応や、アプリケーション側での作りこみによ
る対応が必要でした。
今回のFix Packでは、ノード自体は移動せずにそのノードの処理者のみを変更する「転送」機能を追加しました。
この「転送」機能を利用することにより、これまで運用やアプリケーション側での作りこみによる対応が必要であ
った人事異動や起票前協議への対応が FormWave の標準機能のみで対応可能となります。
転送機能の適用例
これまでの FormWave では「転送」機能がなかったために、以下のようなケースでは代行機能を利用した運用に
よる対応や、アプリケーション側での作りこみが必要となっていました。
(例 1)人事異動によって上司が変更になる場合
1.
3 月 31 日時点のユーザーA さんの上司は X さんであった。4 月 1 日に人事異動が行われ、A さんの上司が X
さんから Y さんに変更になった。
2.
以下の図 1 のように承認者を起票者の上司として定義したワークフローにおいて、3 月 31 日に A さんが起票
を行い、伝票は承認者(A さんの 3 月 31 日時点の上司の X さん)へ送られた。
3.
X さんが 3 月 31 日は不在のために 3 月 31 日中には承認処理が行われなかった。
4.
4 月 1 日になり人事異動の結果 A さんの上司は Y さんになったが、ワークフローシステム上、2.の伝票の現
在の処理者は X さんのままである。
図 1 起票者の上司が承認者のワークフロー
例えば社内規定として承認処理は承認時点の上司が行う必要があると決められている場合、上記のワークフローで
現在の処理者である X さんは社内規定によって承認処理を行うことはできず、何らかの方法で承認者を Y さんに
変更する必要があります。
(例２)伝票の現在の処理者が退職した場合
1.
3 月 31 日時点のユーザーA さんの上司は X さんであった。
2.
上の(例 1) のように承認者を起票者の上司として定義したワークフローにおいて、3 月 31 日に A さんが起票
を行い、伝票は承認者(A さんの 3 月 31 日時点の上司の X さん)へ送られた。
3.
X さんは 4 月 1 日付けで退職予定であったが 3 月 31 日は不在のために 3 月 31 日中には承認処理が行われな
かった。
4.
4 月 1 日になり X さんは退職をしたため 2.の伝票の現在の処理者がいなくなり、伝票を処理できるユーザー
が存在しなくなった。
(例 1)や(例 2)のようなケースの場合、これまでは一度差し戻した後に上司関係を再評価し正しい処理者を決定した
り、正しい処理者を代行者として設定した後にその代行者が処理を行う必要がありました。
(例 3)複数のユーザー間で内容を事前協議しその後に起票をしたい場合
実際の業務では、正式にワークフローを起票する前に部門内の複数のユーザー間で事前に協議を行い、部門内で合
意が取れた後に正式に起票を行いたい場合や、関連部門の担当者に起票前に内容について事前確認(根回し)を行っ
た後に正式に起票を行いたい場合があります。
このような場合、これまでの FormWave では図 2 のように FormWave としては「起案者」が起票するが、アプ
リケーションとしては「正式起票者」が起票したとして伝票のステータスを管理するなどの対応が必要でした。
FormWave 上の起票者
アプリケーションとして
はこのユーザーを起票者
とみなして処理
図２ 正式起票前の協議の例
(例 1)から(例 3)などのようなケースに対応するため、現在のノードを移動することなく、その処理者のみを変更す
る「転送」機能を今回の Fix Pack で追加します。この「転送」機能を利用することにより、これまでアプリケー
ション側での作りこみによる対応が必要であった人事異動や起票前協議への対応が FormWave の標準機能のみで
可能となります。
「転送」機能を利用した(例 1)から(例 3)のケースの対応例は以下のようになります。
(例 1)人事異動によって上司が変更になる場合の対応例
1.
3 月 31 日時点のユーザーA さんの上司は X さんであった。4 月 1 日に人事異動が行われ、A さんの上司が X
さんから Y さんに変更になった。
2.
以下の図 3 のように承認者を起票者の上司として定義したワークフローにおいて、3 月 31 日に A さんが起票
を行い、伝票は承認者(A さんの 3 月 31 日時点の上司の X さん)へ送られた。
3.
X さんが 3 月 31 日は不在のために 3 月 31 日中には承認処理が行われなかった。
4.
4 月 1 日になり人事異動の結果 A さんの上司は Y さんになったが、ワークフローシステム上、2.の伝票の現
在の処理者は X さんのままである。
5.
4 月 1 日以降に X さんが自分の処理待ち伝票一覧から 4.の伝票を開いて内容を確認すると本来の処理者でな
いことに気づき、「転送」機能により人事上の正しい承認者である Y さんに伝票を転送する。
6.
転送の結果、伝票の現在の処理者は Y さんに変更される。伝票は X さんの処理待ち伝票一覧からはなくなり、
Y さんの処理待ち伝票一覧に入る。
X さんから Y さんへ転送
図 3 転送による承認者の変更
(例２)伝票の現在の処理者が退職した場合の対応例
1.
3 月 31 日時点のユーザーA さんの上司は X さんであった。
2.
上の(例 1) のように承認者を起票者の上司として定義したワークフローにおいて、3 月 31 日に A さんが起票
を行い、伝票は承認者(A さんの 3 月 31 日時点の上司の X さん)へ送られた。
3.
X さんは 4 月 1 日付けで退職予定であったが 3 月 31 日は不在のために 3 月 31 日中には承認処理が行われな
かった。
4.
4 月 1 日になり X さんは退職をしたため 2.の伝票の現在の処理者がいなくなり、伝票を処理できるユーザー
が存在しなくなった。
5.
伝票の管理者が状況表示一覧から対象伝票を選択し、「伝票状況の表示」画面を開く。
6.
伝票の管理者は 5.の「伝票状況の表示」画面から「転送」を行うことにより、X さんから業務を引き継いだ
ユーザーへ伝票を転送する。
7.
転送の結果、伝票の現在の処理者は業務を引き継いだユーザーに変更される。伝票は X さんの処理待ち伝票
一覧からはなくなり、業務を引き継いだユーザーの処理待ち伝票一覧に入る。
(例 3)複数のユーザー間で内容を事前協議しその後に起票をしたい場合の対応例
２５
伝票を起票する前に A さん、B さん、C さん 3 人で内容を確認し、確認後に正式に起票したい場合を考えます。
例として、A さんが最初に起案し、A さんは B さんにその内容を確認してもらい、その後 C さんにも内容を確認
してもらった結果、問題なければ正式に起票する場合を考えます。
1.
2.
3.
A さんがブランク伝票一覧から対象伝票を開きます。伝票へデータを入力後、伝票画面の「転送」ボタンを
押し、転送先として B さんを指定して転送を行います。その結果、伝票は B さんのドラフト伝票一覧に入り
ます。
B さんがドラフト伝票一覧から対象伝票を開き、内容を確認し、必要に応じて内容を修正します。その後、
伝票画面の「転送」ボタンを押し、転送先として C さんを指定して転送を行います。その結果、伝票は C さ
んのドラフト伝票一覧に入ります。
C さんがドラフト伝票一覧から対象伝票を開き、内容を確認し、必要に応じて内容を修正します。内容に問
題がないことが確認できたら、C さんは「起票」ボタンを押して伝票を起票します。
1.
2.
3.
A さん→B さんへ転送
B さん→C さんへ転送
C さんが起票
図 4 起票前転送による事前協議の例
上記の手順によって、「起票」が行われる前の「転送」では伝票はドラフト伝票のままBさん、Cさんに転送され
ます。Cさんが「起票」ボタンを押した時点でCさんを起票者として伝票が起票されます。
最後に「起票」ボタンを押したユーザーが起票者となりますので、起案者の A さんを正式な起票者としたい場合
は、上記の 3.以降を以下のように処理を行います。
3.
4.
C さんがドラフト伝票一覧から対象伝票を開き、内容を確認し、必要に応じて内容を修正します。その後、
伝票画面の「転送」ボタンを押し、転送先として A さんを指定して転送を行います。その結果、伝票は A さ
んのドラフト伝票一覧に入ります。
A さんがドラフト伝票一覧から対象伝票を開き、内容を確認し、必要に応じて内容を修正します。内容に問
題がないことが確認できたら、A さんは「起票」ボタンを押して伝票を起票します。
転送機能を利用するための準備
転送機能を利用するためには以下の準備が必要です。
1.
①
ファイルのコピー
当Fix Packに含まれるfcserver.jar, FormConnect.jarを「フィックス・パックの適用手順」に従っ
て適用する。
② ForwardJsp.zip を解凍し、”Status.jsp”、” SelectForwardTo.jsp” 、” StatusSelectForwardTo.jsp”
を以下のいずれかの手順で置き換えてください。
(1) EAR を更新する場合
FormWave.ear を Rational Application Developer などで開きます。
上記の 3 つの jsp ファイルを ClientServiceWAR プロジェクトの WebContent/client 以下にコピー
します。
FormWave.ear を WAS に再度インストールします。
(2) WAS 直下を直接更新する場合
FormWave.ear をインストールしたすべてのマシンについて以下のディレクトリに上記の 3 つの
jsp ファイルをコピーしてください。
(WAS_HOME)/profiles/(PROFILE_NAME)/installedApps/(CELL_NAME)/FormWave.ear/Clien
tService.war/client
その後、FormWave を再起動してください。
2. プロパティファイルの設定
「転送」機能を FormWave システム全体で使用可能にするには fcinstall.properties で以下の設定を追
加してください。設定をしない場合は「転送」機能は利用できません。
enableForwardEvent=true
２６
プロジェクト定義上は転送可能に設定されていたとしても、このプロパティがtrueに指定されていない
と、「転送」機能は利用できません。
3. 伝票定義の設定
上記の 2.の「プロパティファイルの設定」で enableForwardEvent=true をしてもデフォルトでは伝票
定義全体で「転送」機能は利用できない状態になっています。転送機能を利用するためには、既に定義
済みの伝票、新規に定義する伝票どちらについても明示的に「転送」機能をプロジェクトデザイナーで
有効にする必要があります。
伝票定義で伝票定義全体でデフォルトとして「転送」機能を有効にする場合は、プロジェクトデザイナ
ーのプロジェクトのプロパティの設定において以下の「転送操作の禁止」のチェックをはずしてくださ
い。
処理者ノードの設定
処理者ノードごとに「転送」機能の許可・禁止を設定するには、処理者ノードごとにプロパティの設定
で「転送操作」の項目の値を設定してください。設定値によって以下のように「転送」機能の許可・禁
止が決まります。
① 「デフォルト」を選択した場合
ノードごとの設定は伝票全体の「転送」操作の許可・禁止の設定と同じになります。
② 「許可する」を選択した場合
２７
③
伝票全体の「転送」操作の許可・禁止にかかわらず、指定されたノードの「転送」操作は有効に
なります。
「禁止する」を選択した場合
伝票全体の「転送」操作の許可・禁止にかかわらず、指定されたノードの「転送」操作は禁止に
なります。
上記の設定で「転送」が有効になっている処理者ノードで伝票を開くと伝票画面の処理ボタンに自動的
に「転送」ボタンが追加されます。ノード設定の「処理」定義で「転送」を追加する必要はありません。
自動処理の設定
処理者ノードでの「転送」処理以外に、自動処理でも「転送」処理を設定することが可能です。
ノードの「自動処理」設定画面の「自動処理タイプ」で「転送」を指定し「転送者」を指定したくださ
２８
い。
「転送者」として以下の指定が可能です。
ユーザーID
転送先をユーザーID で決定したい場合に指定します。
上司（１）
転送先を他の処理者ノードの第１上司（正の上司）にしたい場合に指定します。「上
司（１）」を指定した場合、ドロップダウン・リストとして表示される処理者一覧
から対象となる処理者を選択してください。
上司（２）
転送先を他の処理者ノードの第２上司（副の上司）にしたい場合に指定します。「上
司（２）」を指定した場合、ドロップダウン・リストとして表示される処理者一覧
から対象となる処理者を選択してください。
グループ ID
転送先をグループ ID で決定したい場合に指定します。
組織 ID
転送先を組織 ID で決定したい場合に指定します。
フィールド参照
転送先を実行時にフィールドに入っている値で決定したい場合に指定します。「フ
ィールド参照」を指定した場合、［参照］ボタンを押すと表示される「フィールド
選択」ダイアログのフィールド一覧から対象となるフィールドを選択するか、直接
フィールド名、またはフィールド式を入力します。指定できるフィールドは、「テ
キスト」タイプの「標準」コンテナータイプのフィールドのみです。
転送機能の操作
「転送」機能が可能となっている伝票では、次のユーザーが「転送」機能を実行可能です。
伝票の現在の処理者(ユーザー、グループ、組織の管理者)およびその代行者
「転送」機能が伝票定義およびノードごとの定義の両方で可能となっている場合、処理者が伝票を開く
と、通常の処理ボタン以外に「転送」ボタンが画面に表示されます。
２９
「転送」ボタンを押すと以下の画面に遷移しますので、その画面で転送先の処理者を指定後に画面内の
「転送」ボタン押すと転送処理が実行されます。
転送先の処理者としては、起票前の伝票(新規伝票およびドラフト伝票)ではユーザーID のみが、起票
後の伝票ではユーザーID あるいはグループ ID が指定可能です。
伝票の管理者
伝票の管理者が伝票の状況表示画面を開くと、以下のように「転送」ボタンが表示されます。
３０
「転送」ボタンを押すと以下の画面に遷移しますの
で、この画面で転送先の処理者を指定してください。伝票が分岐によって現在の処理者が複数いる場合
には「伝票の選択」で転送対象の伝票を選択してください。転送先の処理者および転送対象の伝票を指
定後に画面内の「転送」ボタン押すと転送処理が実行されます。
転送先の処理者としては、起票前の伝票(新規伝票およびドラフト伝票)ではユーザーID のみが、起票
後の伝票ではユーザーID あるいはグループ ID が指定可能です。
３１
商標
本書中、以下の用語は、International Business Machines Corporation の米国およびその他の国における商標です。
IBM、FormWave、DB2、WebSphere、Rational、AIX
本書中、International Business Machines Corporation 以外の商標または登録商標は以下の通りです。
"Java" およびすべての Java 関連の商標およびロゴは Sun Microsystems, Inc.の米国およびその他の国における商標です。
“Microsoft”, “Windows”, “Windows NT”, および”Windows”ロゴは Microsoft Corporation の米国およびその他の国における商標
です。
“Linux”は Linus Torvalds の米国及びその他の国における商標です。
他の会社名、製品名およびサービス名等はそれぞれ各社の商標または登録商標です。
３２