4.2.10 ユーザ定義ユティリティ

ユーザ定義ユティリティは,Groupmax Workflow Serverの場合とGroupmax Workflow Server for Active Directoryの場合とで異なります。それぞれについて説明します。

<この項の構成>
(1) Groupmax Workflow Serverの場合
(2) Groupmax Workflow Server for Active Directoryの場合

(1) Groupmax Workflow Serverの場合

ユーザ定義ユティリティは,Groupmax Address Serverと連携して,ワークフローデータベースの情報を更新するユティリティです。

ユーザ定義ユティリティを使用した運用については,「2.4.5 ユーザの設定」を参照してください。

コマンドの形式,終了コード及び注意事項を次に示します。

(a) WFregusrコマンド

コマンドの形式を次に示します。

WFregusr

[-y]

[-v]

[-k|-s[-k]|-c|-f ユーザID一覧ファイル名]

レポート形式例について,図中の番号ごとに説明します。

  1. ヘッダレコード第1行
    実行バージョン及び実行ホスト名が表示されます。
  2. ヘッダレコード第2行
    実行日付及び実行時間が表示されます。
  3. 区切りレコード
  4. 更新予告レコード
    Groupmax Address ServerからWorkflowに通知された変更情報に基づいて,これ以降の行に更新予告が出力されます。
    同一ユーザIDに対する複数の変更情報が存在する場合,変更の効果は累積されないで,それぞれ独立した更新情報として扱われます。
  5. USER句
    USER句の次に,更新するユーザ情報が表示されます。
  6. ユーザ更新情報レコード
    レコードフォーマットを次に示します。
    ユーザID[Tab]更新内容
    更新内容の部分には,ユーザ情報の更新内容が表示されます。
    Add
    ユーザが自ホストに追加されることを示します。
    Move Toホスト名
    表示されたホストに,ユーザが移動することを示します。
    Change Toユーザ名
    表示された名称に,ユーザ名が変更されることを示します。
    Update
    ユーザ名以外の情報が変更されることを示します。
    Delete
    ユーザが削除されることを示します。
    Delete(Only Relation Maintenance)
    他ホストのユーザの削除に伴って,リレーションがメンテナンスされることを示します。
  7. LinkedBpNode句
    削除又は移動対象のユーザが直接リンクされている,旧バージョンの作業机の情報を出力します。この情報が出力されているときは,該当するユーザを削除又は移動できません。レコードフォーマットを次に示します。
    LinkedBpNode BPName:ビジネスプロセス定義名[Tab]Ver:ビジネスプロセス定義バージョン[Tab]NodeName:作業机名
  8. CASE句
    削除又は移動対象のユーザのユーザトレーにある案件の情報を出力します。レコードフォーマットを次に示します。
    CASE BPName:ビジネスプロセス定義名[Tab]Ver:ビジネスプロセス定義バージョン[Tab]WorkID:ワークID[Tab]Reason:移動不可要因
    移動不可要因を次に示します。空白の場合は,移動先のユーザトレーに自動的に転送されることを示します。
    Deleted
    ユーザが削除されたことを示します。
    V1BP
    旧バージョンのビジネスプロセス定義の案件であることを示します。
    NotDistributed
    ユーザの移動先となるサーバに,ビジネスプロセス定義が配布されていないことを示します。
  9. 更新予告レコード
    Groupmax Address Server登録情報とワークフローデータベースとの相違に基づいて,これ以降の行に更新予告が出力されます。
(b) ユーザ定義ユティリティの終了コード

コマンド終了時に返される終了コードを次に示します。

(c) 注意事項

コマンドの実行時の注意事項を次に示します。

(2) Groupmax Workflow Server for Active Directoryの場合

ユーザ定義ユティリティは,Active Directory上のワークフローユーザの情報を基に,ワークフローキャッシュを構築し,Active Directoryとワークフローデータベースとの間のユーザ情報の整合性を確保するユティリティです。Active Directoryとワークフローデータベースとの間でユーザ情報にずれがある場合は,ワークフローデータベースのユーザ情報を更新することで整合性を確保します。ただし,Active Directoryのユーザ情報がワークフローユーザ登録の規則に違反している場合は,ワークフローデータベースへは反映しません。

なお,次の条件を満たしたものがActive Directory上のワークフローユーザとみなされます。

整合性の確保によってユーザトレーが新規に作成される場合,属性のデフォルトは表4-6のようになります。

表4-6 ユーザトレーの属性のデフォルト

属性
ユーザ権限一般ユーザ
案件受付状態受付可能
ユーザヒストリ取得数50※1
コメントNULL
ユーザ属性1NULL
ユーザ属性2NULL
GUIDActive Directory上のGUID※2
注※1
環境設定ユティリティによって,0~1023までの範囲で変更できます。
注※2
GUID:Global Unique ID
(a) WFregusrコマンド

コマンドの形式を次に示します。

WFregusr

[-v]

[ { -s|-u ユーザID|-c } ]

レポート形式例について,図中の番号ごとに説明します。

  1. ヘッダレコード第1行
    実行バージョン及び実行ホスト名が表示されます。
  2. ヘッダレコード第2行
    実行日付及び実行時間が表示されます。
  3. 区切りレコード
  4. USER句
    USER句の次に,更新するユーザ情報が表示されます。
  5. ユーザ更新情報レコード
    レコードフォーマットを次に示します。
    ユーザID[Tab]更新内容
    更新内容の部分には,ユーザ情報の更新内容が表示されます。
    Add
    ユーザがワークフローデータベースに追加されることを示します。
    Delete
    ユーザがワークフローデータベースから削除されることを示します。
  6. Case句
    削除又は移動対象のユーザのユーザトレーにあって再配布の対象となる案件の情報を出力します。レコードフォーマットを次に示します。
    Case BPName:ビジネスプロセス定義名[Tab]Ver:'ビジネスプロセス定義バージョン'[Tab]WorkID:'ワークID'[Tab]reason:案件再配布要因
    案件再配布要因を次に示します。
    Deleted
    ユーザが削除されたことを示します。
(b) ユーザ定義ユティリティの終了コード

コマンド終了時に返される終了コードを次に示します。

0
正常終了
255
異常終了
(c) 注意事項

コマンドの実行時の注意事項を次に示します。