8.2.2 トレースレベルの設定方法

トレース情報を採取するには,トレースレベルを設定する必要があります。以下,設定方法及び注意事項を説明します。

<この項の構成>
(1) 設定方法
(2) 注意事項
(3) OCXメソッドとAPI関数の対応表

(1) 設定方法

トレース採取はAPI関数エラーリターン時については常時採取とし,その他のトレースについてはレベル分けし,レベルに応じたトレースのみ採取可能とします。

(a) Windows版
設定方法
以下に示すディレクトリ配下にある,Groupmax Workflow Client(Server)環境設定ツールを起動して設定します。但し,Windows NT/2000をご使用の場合はAdministrator権限のユーザで環境設定ツールを起動して下さい。
<クライアント>
Groupmax Workflowインストールディレクトリ配下のworkflow¥tools¥bwfcecfg.exe
<サーバ>
Groupmax Workflowインストールディレクトリ配下のtools¥bwfsecfg.exe
次の図は,Groupmax Workflow Client環境設定ツールの起動ダイアログの例です。
[図データ]

起動ダイアログから「トレース取得」のタブを選択します。このタブではGroupmax Workflow Client全体としてのトレース取得内容を設定することができます。ここで選択できる「常時取得する」を設定すると,Workflow Client - Library Extensionでは,[全て採取する(トレースレベル:2)]となります。

「エラー時取得する(推奨)」を設定すると,Workflow Client - Library Extensionでは,[エラートレースのみ(トレースレベル:0)] となります。Workflow Client - Library Extensionを個別に設定したい場合は,「詳細に設定」を選択して詳細ボタンを押します。

詳細ボタンを押した場合のダイアログ画面を次に示します。

[図データ]

「詳細ボタン」を押した後,「Clinet - Library Extension」のタブを選択することにより,Workflow Client - Library Extensionの個別設定を行う事ができます。

図で示す"トレース取得"の選択値がトレースレベルとなります。(初期起動時のデフォルトは"エラートレース"だけ)全体設定の画面,及び個別設定の画面で“OK"もしくは"適用"を選択するとトレースレベルをレジストリに書き込みます。(キー名称:AdAPIfcTrace)

(b) HI-UX/WE2版,HP-UX版,及びAIX版

エラートレースだけ常時採取します。

(2) 注意事項

OCXインタフェースでは,OCXメソッドの発行時に呼び出されるAPI関数の関数名でシーケンストレースが出力されます。OCXメソッドと,メソッドの発行時に呼び出されるAPI関数との対応については,「8.2.2(3) OCXメソッドとAPI関数の対応表」を参照してください。

(3) OCXメソッドとAPI関数の対応表

OCXメソッドとAPI関数の対応を表8-5に示します。

表8-5 OCXメソッド使用時に出力されるAPI関数

メソッド区分OCXメソッドAPI関数
セション管理WFadStartUpHwfAdStartUp
WFadCleanUpHwfAdCleanUp
WFadConnectHomeHwfAdConnectHome
ユーザ,組織操作機能WFadConnectUserHwfAdConnectUser
WFadGetOrganizationListHwfAdGetOrganizationList
WFadGetUserListFromOranHwfAdGetUserListFromOran
WFadGetUserHistoryHwfAdGetUserHistory
WFadDeleteUserHistoryHwfAdDeleteUserHistory
WFadGetUserListFromRoleHwfAdGetUserListFromRole
ビジネスプロセス定義操作機能WFadConnectBpHwfAdConnectBp
WFadCreateBpListHwfAdCreateBpList
WFadSelectBpListHwfAdSelectBpList
WFadGetBpListHwfAdGetBpList
WFadGetBpOperationListHwfAdGetBpOperationList
ロール操作機能WFadConnectRoleHwfAdConnectRole
WFadCreateRoleListHwfAdCreateRoleList
WFadSelectRoleListHwfAdSelectRoleList
WFadGetRoleListHwfAdGetRoleList
WFadAddUserToRoleHwfAdAddUserToRole
WFadDeleteUserFromRoleHwfAdDeleteUserFromRole
ワーク操作機能WFadCreateWorkListHwfAdCreateWorkList
WFadSelectWorkListHwfAdSelectWorkList
WFadGetWorkListHwfAdGetWorkList
WFadGetWorkHistoryHwfAdGetWorkHistory
WFadCancelWorkHwfAdCancelWork
WFadSetWorkPriorityHwfAdSetWorkPriority
WFadSetWorkTermHwfAdSetWorkTerm
WFadSuspendWorkHwfAdSuspendWork
WFadResumeWorkHwfAdResumeWork
案件操作機能WFadCreateCaseListHwfAdCreateCaseList
WFadSelectCaseListHwfAdSelectCaseList
WFadGetCaseListHwfAdGetCaseList
WFadSetCaseNextUserHwfAdSetCaseNextUser
WFadCaseNextHwfAdCaseNext
WFadCaseToUserHwfAdCaseToUser
WFadGetCaseAttributeHwfAdGetCaseAttribute
WFadSetCaseAttributeHwfAdSetCaseAttribute
WFadFailedCaseToUserHwfAdFailedCaseToUser
WFadCaseToRoleHwfAdCaseToRole
WFadCaseFromRoleHwfAdCaseFromRole
オブジェクト操作機能WFadGetObjectHwfAdGetObject
WFadSetObjectHwfAdSetObject
リスト操作機能WFadDeleteListHwfAdDeleteList
WFadCreateSortListHwfAdCreateSortList