2.6.1 BPMN連携機能を使用する場合のciweditbp
形式
-
形式1(変更したビジネスプロセス定義を登録する場合)
ciweditbp -sid <system_id> -edt -bpf <process_definition_file> -bk <old_process_definition_file> -o <output_file_name> [-encoding <character_set>]
-
形式2(オプションファイルを指定して実行する場合)※
ciweditbp -file <option_file_name> [-encoding <character_set>]
-
形式3(コマンドの形式を表示する場合)※
ciweditbp -h
- 注※
-
すべてのコマンドで同じ形式で指定します。詳細は,「1.5 コマンド共通のオプション」を参照してください。
機能
ビジネスプロセス定義の一部を変更します。すでに案件が存在しているビジネスプロセス定義を,バージョンはそのままで変更できます。ただし,既存の案件,業務ステップおよび作業の情報は変更できません。
変更可能な範囲については,マニュアル「uCosminexus Service Coordinator Interactive Workflow BPMN 連携機能 使用の手引」の,登録済みのビジネスプロセス定義を変更する方法の説明を参照してください。
実行条件
このコマンドを実行できるコンポーネントの稼働状態を次に示します。
コンポーネント |
稼働状態 |
|
---|---|---|
起動中 |
停止中 |
|
CSCIWManagementServer |
×※ |
○ |
案件運用操作 |
○ |
○ |
CSCIWライブラリを使用した業務アプリケーション(J2EEアプリケーション) |
○ |
○ |
CSCIWライブラリを使用した業務アプリケーション(Javaアプリケーション) |
×※ |
○ |
アプリケーション呼び出しサービス |
○ |
○ |
RESTサービス |
○ |
○ |
運用管理RESTサービス |
○ |
○ |
同一マシンでのほかのコマンド |
× |
○ |
異なるマシンでの同一コマンド |
× |
○ |
異なるマシンでのほかのコマンド |
× |
○ |
DBMS |
○ |
× |
- (凡例)
-
○:コマンドを実行できます。
×:コマンドを実行できません。
- 注※
-
定義を登録する場合は,起動中でもコマンドを実行できます。ただし,コマンド実行後は定義を反映するために必ず再起動してください。
使用手順
このコマンドの使用手順は,マニュアル「uCosminexus Service Coordinator Interactive Workflow BPMN 連携機能 使用の手引」の,ビジネスプロセス定義の変更の流れの説明を参照してください。
引数
- -sid <system_id>
-
環境構築時に設定したシステムIDを指定します。指定したシステムIDに対応するワーク管理システム上のビジネスプロセス定義が対象になります。
指定できる値は,半角英大文字と半角数字で5文字以内です。ただし,先頭には半角英大文字を指定してください。
- -edt
-
変更したビジネスプロセス定義を登録する場合に指定します。
登録したビジネスプロセス定義の作成者は,このコマンドを実行したユーザになります。
このため,ユーザ名の長さは,<SYSTEMID>_PROCESS_DEFテーブルのAuthorカラムのバイト数以内にしてください。
- -bpf <process_definition_file>
-
変更後のビジネスプロセス定義ファイル名を指定します。
変更後のビジネスプロセス定義ファイル名には,-updateオプションを指定したciwtransbpmnコマンドを実行して生成したビジネスプロセス定義ファイルの名称を指定してください。
なお,-updateオプションを指定したciwtransbpmnコマンドを実行して生成したビジネスプロセス定義ファイル以外を指定した場合,動作の保証はできません。
- -bk <old_process_definition_file>
-
変更前のビジネスプロセス定義情報を保存するファイルの名称を指定します。
変更前のビジネスプロセス定義ファイル名には,一意な名称を指定してください。
- -o <output_file_name>
-
変更内容を出力するファイルの名称を指定します。
変更内容は,指定したファイルに出力されます。
出力されたファイルの内容を確認したい場合は,サポートに問い合わせてください。
- -file <option_file_name>
-
このオプションは,すべてのコマンドで指定できます。詳細は,「1.5.1 -fileオプション」を参照してください。
- -encoding <character_set>
-
このオプションは,-oオプションまたは-fileオプションを指定した場合だけ指定できます。文字コードには,Javaでサポートされているエンコーディングの正準名を指定してください。また,このオプションを省略した場合は,Javaのデフォルトの文字コードが指定されます。
- -oオプションを指定した場合
-
-oオプションに指定した出力ファイルの文字コードを指定します。
文字コードには,Javaでサポートされているエンコーディングの正準名を指定してください。
- -fileオプションを指定した場合
-
このオプションは,すべてのコマンドで指定できます。詳細は,「1.5.1 -fileオプション」を参照してください。
- -h
-
このオプションは,すべてのコマンドで指定できます。詳細は,「1.5.2 -hオプション」を参照してください。
戻り値
戻り値 |
内容 |
---|---|
0 |
正常終了 |
1 |
致命的なエラー |
9※ |
実行権限エラー |
10 |
ビジネスプロセス定義の変更なし |
51 |
パラメーター不正 |
100 |
ビジネスプロセス定義不正 |
110 |
ビジネスプロセス定義以外のデータ不正 |
150 |
ファイルアクセスエラー |
254 |
異常終了 |
- 注※
-
Windowsの場合だけ発生します。
注意事項
-
オプション引数に,文字列を指定する場合の注意事項については,「1.2 コマンドの入力形式」を参照してください。
-
ビジネスプロセス定義を変更する場合は,このコマンドを実行する前に,CSCIWシステムのバックアップを取得することを推奨します。
-
マルチマシン構成の場合,どれか1つのマシンでこのコマンドを実行してください。
-
このコマンドは,CSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションが起動中でも実行できます。ただし,コマンド実行後に,必ずCSCIWManagementServerおよびCSCIWを使用しているJavaアプリケーションを再起動してください。再起動しないと,ビジネスプロセス定義の変更が反映されません。
-
BPMNビジネスプロセス定義から定義済みのタスクおよびイベントを削除する場合,削除対象に実行中のタスクおよびイベントがあると,ビジネスプロセス定義を変更できません。
-
-updateオプションを指定していないciwtransbpmnコマンドで作成したビジネスプロセス定義ファイルは使用できません。
-
ビジネスプロセス定義の変更によって,変更前に生成されたタスクやイベントなどが持つ情報と,変更後に生成されたタスクやイベントなどが持つ情報が異なることがあります。そのため,必要に応じて業務プログラムや運用手順を見直してください。
-
タスクやイベントを変更した場合でも,生成済みのタスクやイベントの情報は変更されません。
-
マニュアル「uCosminexus Service Coordinator Interactive Workflow BPMN 連携機能 使用の手引」の,登録済みのビジネスプロセス定義を変更する方法の説明に記載されている方法でビジネスプロセス定義を変更してください。それ以外の方法で変更した場合,動作の保証はできません。