changeState
インタフェース名：CIWProcessInstance
構文
void changeState(
CIWProcessInstance.State aNewState
)
throws CIWFatalException,
CIWEntityNotExistException,
CIWTransientException,
CIWTransitionFailedException,
CIWStateException
機能
対象となる案件の状態を変更します。
引数
changeStateの引数を次の表に示します。
|
仮引数名 |
名称 |
in/out |
説明 |
|---|---|---|---|
|
aNewState |
案件の状態 |
in |
変更後の案件の状態を指定します。 指定する値として，このインタフェースに定義されたCIWProcessInstance.State列挙型の定数を指定できます。 nullは指定できません。 |
aNewStateで指定できる案件の状態を次の表に示します。
|
現在の状態 |
指定できる状態 |
状態遷移の意味 |
||
|---|---|---|---|---|
|
定数 |
意味 |
定数 |
意味 |
|
|
RUNNING |
実行中 |
INTERMITTED |
実行停止 |
中断 |
|
INTERMITTED |
実行停止 |
RUNNING |
実行中 |
再開 |
|
− |
未終了 |
TERMINATED |
強制終了 |
強制終了 |
- （凡例）
-
定数：CIWProcessInstance.State列挙型の定数
状態遷移については，「付録C 状態遷移モデル」を参照してください。
−：定数がないことを表します。
戻り値
ありません。
例外
changeStateで発生する例外を次の表に示します。
|
発生する例外 |
説明 |
|---|---|
|
処理を続行できない障害が発生した場合 |
|
|
処理しようとしたオブジェクトが存在しない場合 |
|
|
一時的なエラーが発生した場合 |
|
|
案件処理中にエラーが発生した場合 |
|
|
状態の遷移に失敗した場合 |
注意事項
-
エラー案件に対して実行した場合は，例外（CIWStateException）が発生します。
-
変更する案件状態にnullを指定した場合は，例外（java.lang.IllegalArgumentException）が発生します。