12.4.32 getCallActivityParentPI(対象案件の親案件を取得)
構文
CIWProcessInstance getCallActivityParentPI( java.sql.Connection aDBConnection, CIWServer aCIWServer, java.lang.Integer aProcessInstanceID, java.util.Set<CIWProcessInstance.AttributeName> aAttributeNames ) throws CIWFatalException, CIWTransientException, CIWEntityNotExistException
機能
案件IDで指定した案件の親案件を取得します。
引数
getCallActivityParentPIの引数を次の表に示します。
項番 |
仮引数名 |
名称 |
I/O |
説明 |
---|---|---|---|---|
1 |
aDBConnection |
JDBCコネクション |
in |
CIWServerオブジェクトに関連づけられたJDBCコネクションを指定します。 |
2 |
aCIWServer |
CIWServerオブジェクト |
in |
CIWServerオブジェクトを指定します。 |
3 |
aProcessInstanceID |
案件ID |
in |
取得したい案件から呼ばれている子案件の案件IDを指定します。 nullは指定できません。 |
4 |
aAttributeNames |
属性名のセット |
in |
取得したい案件の属性名のセットを指定します。 取得したい案件の属性名を指定しない場合は,サイズ0の属性名のセットまたはnullを指定します。取得したい属性名としてnullは指定できません。 取得したい属性名として指定されていない場合でも,案件のIDは必ず取得します。 取得できる属性は,CIWProcessInstance.AttributeName列挙型で指定できる属性です。 |
戻り値
対象となる案件IDの親案件の案件オブジェクトを返します。親案件がいない案件IDを指定した場合,nullを返します。
例外
getCallActivityParentPIで発生する例外を次の表に示します。
項番 |
発生する例外 |
説明 |
---|---|---|
1 |
CIWFatalException |
処理を続行できない障害が発生した場合 |
2 |
CIWTransientException |
一時的なエラーが発生した場合 |
3 |
CIWEntityNotExistException |
処理しようとしたオブジェクトが存在しない場合 |
注意事項
-
JDBCコネクションおよびCIWServerオブジェクトにnullを指定した場合は,例外(java.lang.IllegalArgumentException)が発生します。
-
JDBCコネクションとCIWServerオブジェクトが関連づけられていない場合の動作は保証しません。
-
案件IDにnullを指定した場合は,例外(java.lang.IllegalArgumentException)が発生します。
-
指定した案件IDの案件が存在しない場合は,例外(CIWEntityNotExistException)が発生します。