12.4.19 setDeadlineForTimer(タイマーの処理期限を変更)
構文
void setDeadlineForTimer( java.sql.Connection aDBConnection, CIWServer aCIWServer, java.lang.Integer aProcessInstanceID, java.lang.Integer aWorkItemID, java.util.Date aNewDeadline ) throws CIWFatalException, CIWTransientException, CIWStateException, CIWEntityNotExistException
機能
案件IDと作業IDで指定された作業に対し,指定した日時を作業の処理期限の絶対日時として設定します。
対象となる作業は,タイマーイベントから変換された作業です。
引数
setDeadlineForTimerの引数を次の表に示します。
項番 |
仮引数名 |
名称 |
I/O |
説明 |
---|---|---|---|---|
1 |
aDBConnection |
JDBCコネクション |
in |
CIWServerオブジェクトに関連づけられたJDBCコネクションを指定します。 |
2 |
aCIWServer |
CIWServerオブジェクト |
in |
CIWServerオブジェクトを指定します。 |
3 |
aProcessInstanceID |
案件ID |
in |
対象である作業の案件IDを指定します。 nullは指定できません。 |
4 |
aWorkItemID |
作業ID |
in |
対象である作業の作業IDを指定します。 nullは指定できません。 |
5 |
aNewDeadline |
変更後の処理期限 |
in |
変更後の処理期限を指定します。 nullは指定できません。 |
戻り値
なし
例外
setDeadlineForTimerで発生する例外を次の表に示します。
項番 |
発生する例外 |
説明 |
---|---|---|
1 |
CIWFatalException |
処理を続行できない障害が発生した場合 |
2 |
CIWTransientException |
一時的なエラーが発生した場合 |
3 |
CIWStateException |
状態の遷移に失敗した場合 |
4 |
CIWEntityNotExistException |
処理しようとしたオブジェクトが存在しない場合 |
注意事項
-
JDBCコネクションおよびCIWServerオブジェクトにnullを指定した場合は,例外(java.lang.IllegalArgumentException)が発生します。
-
JDBCコネクションおよびCIWServerオブジェクトが関連づけられていない場合の動作は保証しません。
-
案件IDおよび作業IDにnullを指定した場合は,例外(java.lang.IllegalArgumentException)が発生します。
-
対象となる作業はタイマーから変換された作業です。タイマー以外から変換された作業を指定した場合は,例外(CIWStateException)が発生します。
-
指定した条件を満たす作業オブジェクトが存在しない場合は,例外(CIWEntityNotExistException)が発生します。
-
対象となる作業の状態は,「未終了」状態です。そのほかの場合は,例外(CIWStateException)が発生します。