4.2.11 ユーザ定義更新ユティリティ

ユーザ定義更新ユティリティは,ユーザに関する情報をファイルから一括で更新します。

このユティリティで更新できるユーザ情報は大きく分けて次の六つです。

ユーザ定義更新ユティリティは,Windows NTのコマンドプロンプトでWFdefusrコマンドを使用して実行します。WFdefusrコマンドにあらかじめ更新情報を設定したファイルを指定して実行すると,ファイルに設定した情報のとおりにユーザ情報が更新されます。

更新情報のファイルは,ユーザ定義情報出力ユティリティで出力されたユーザ定義情報ファイルを利用して作成することもできます。ユーザ定義情報出力ユティリティの詳細は,「4.2.12 ユーザ定義情報出力ユティリティ」を参照してください。

コマンドの形式,終了コード,情報更新失敗と更新処理スキップの要因,及びコマンド実行時の注意事項を次に示します。

<この項の構成>
(1) WFdefusrコマンド
(2) ユーザ定義更新ユティリティの終了コード
(3) 情報更新失敗と更新処理スキップの要因
(4) 注意事項

(1) WFdefusrコマンド

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

WFdefusr

-f ユーザ定義更新情報入力ファイル名

[-v]

[-l ユーザ定義更新ログ取得ファイル名]

[-e エラーメッセージ出力ファイル名]

注※1
半角英小文字で設定します。
注※2
更新値を省略できます。省略した場合,その定義情報はクリアされます。また,設定する値に,タブ,「"」及び「^」は半角文字も全角文字も使用できません。
注※3
02-10以降のバージョンのGroupmax Workflow Definerから登録したビジネスプロセス,ロール,又はロール定義更新ユティリティから登録したロールだけが更新対象となります。
注※4
この更新対象コードは,更新対象ユーザのユーザトレーが存在するサーバ(Workflowホームサーバ)で有効となります。
注※5
この更新対象コードは,Workflow管理サーバで有効となります。
注※6
設定する値に,タブ,「"」及び「^」は半角文字も全角文字も使用できません。
注※7
指定するユーザIDはビジネスプロセス管理者(wfm)以上の権限が必要です。
注※8
指定するユーザIDはワークフロー運用管理者(admi)以上の権限が必要です。
注※9
指定するビジネスプロセス定義バージョンの前に0を指定した場合,その0は無視されます。
注※10
設定できるのは200人までです。
  1. ヘッダレコード第1行
    実行バージョン及び実行ホスト名が表示されます。
  2. ヘッダレコード第2行
    実行日付及び実行時間が表示されます。
  3. ヘッダレコード第3行
    ユーザ定義更新情報入力ファイル名が表示されます。
  4. 区切りレコード
  5. ユーザ情報更新履歴レコード
    ユーザ定義情報の更新が成功したかどうか,及び更新内容が表示されます。
    ○印は「更新成功」,×印は「更新失敗」,無印は「更新処理スキップ」を示します。
    レコード先頭の数字は,ユーザ定義更新情報入力ファイルの何番目のレコードかを示します。また,「更新失敗」の場合,エラーを検知した列番号が続けて表示されます。
    「更新失敗」及び「更新処理スキップ」となる場合の要因については,「4.2.11(3) 情報更新失敗と更新処理スキップの要因」を参照してください。

(2) ユーザ定義更新ユティリティの終了コード

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

0
正常終了
4
異常終了(継続できるエラー)
現在実行中のユーザの処理を中止し,次ユーザ以降の処理を継続できるレベルのエラーが1回以上発生したことを示します。エラーの詳細は,このユティリティのWFdefusrコマンドの-eオプションで指定するエラーメッセージ出力ファイルを参照してください。
255
異常終了
ユティリティの処理を継続できないエラーの発生によって,ユティリティの実行が中断されたことを示します。エラーの詳細は,該当するユティリティ実行中のイベントログを参照してください。

(3) 情報更新失敗と更新処理スキップの要因

コマンドを実行した結果,ユーザ情報更新履歴レコードで「更新失敗」及び「更新処理スキップ」と表示された場合の要因を次に示します。これに従ってユーザ定義更新情報入力ファイルを修正し,再度実行してください。

(a) 更新失敗(×印)の要因

更新失敗の要因として考えられるエラーの内容を,レコードの列ごとに示します。ここでの「列」とは,ユーザ定義更新ログ取得ファイルの,レコード番号(図4-4での「1」及び「2-4」)の右の列を「1列目」として数えます。

(b) 更新処理スキップ(無印)の要因

更新処理スキップの要因として考えられるエラーの内容を,次に示します。

(4) 注意事項

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