12.4.13 allocateWIEx（指定した条件に一致する作業の着手）
構文
CIWWorkItem allocateWIEx (
java.sql.Connection aDBConnection,
CIWServer aCIWServer,
java.lang.String aParticipant,
java.lang.String aFilter,
java.lang.String aSort,
java.util.Set<CIW WorkItemAttributeName> aAttributeNames,
int aFetchCount
)
throws CIWFatalException,
CIWTransientException
機能
フィルター条件に指定した作業者IDを持つユーザタスクの作業を，割り当て先作業者が着手した状態に変更します。作業者IDは，フィルター条件に次のような条件を含めて指定します。
-
Participant = '作業者ID'
-
Participant like '作業者IDの前方の文字列%'
フィルター条件を指定しなくてもエラーにはなりませんが，ユーザタスク以外に実行中の作業がある場合，作業が取得できないことがあります。
動作の詳細は，次のとおりです。
指定したフィルター条件を満たし，指定した条件でソートした作業群に対して，指定した割り当て先の作業者IDへの作業の割り当てを実行します。最初に割り当てに成功した作業オブジェクトを返します。割り当てを実行する時，作業オブジェクトを「実行開始可能」状態から「作業者実行」状態に変更します。指定したフィルター条件を満たす作業がない場合や作業者を再割り当てできる作業がない場合はnullを返します。
フィルター条件には，「StateCodeが"j"（実行開始可能）と一致すること」が自動的に追加されます。
引数
allocateWIExの引数を次の表に示します。
|
項番 |
仮引数名 |
名称 |
I/O |
説明 |
|---|---|---|---|---|
|
1 |
aDBConnection |
JDBCコネクション |
in |
CIWServerオブジェクトに関連づけられたJDBCコネクションを指定します。 nullは指定できません。 |
|
2 |
aCIWServer |
CIWServerオブジェクト |
in |
CIWServerオブジェクトを指定します。 nullは指定できません。 |
|
3 |
aParticipant |
割り当て先の作業者 |
in |
割り当て先作業者を指定します。 空文字列およびnullは指定できません。 |
|
4 |
aFilter |
フィルター条件 |
in |
作業を検索する際のフィルター条件を指定します。ユーザタスクだけが対象になるParticipantを含んだフィルター条件を指定します。 |
|
5 |
aSort |
ソート条件 |
in |
作業を検索する際のソート条件を指定します。ソート条件を指定しない場合は，nullを指定します。 |
|
6 |
aAttributeNames |
属性名のセット |
in |
取得したい作業の属性名のセットを指定します。取得属性名を指定しない場合は，サイズ0の属性名のセットまたはnullを指定します。取得属性名にnullは指定できません。取得属性名を指定していない場合でも，作業のID，作業が所属する案件のID，作業者，作業の状態，作業の開始日時，および作業の作業定義IDは必ず取得します。取得できる属性は，CIWWorkItem.AttributeName列挙型で指定できる属性です。 |
|
7 |
aFetchCount |
フェッチ件数 |
in |
一度に取得する件数を指定します。 |
戻り値
着手した作業オブジェクトを返します。
例外
allocateWIExで発生する例外を次の表に示します。
|
項番 |
発生する例外 |
説明 |
|---|---|---|
|
1 |
CIWFatalException |
処理を続行できない障害が発生した場合 |
|
2 |
CIWTransientException |
一時的なエラーが発生した場合 |
注意事項
-
JDBCコネクションおよびCIWServerオブジェクトにnullを指定した場合は，例外（java.lang.IllegalArgumentException）が発生します。
-
JDBCコネクションおよびCIWServerオブジェクトが関連づけられていない場合の動作は保証しません。
-
不正な引数を指定した場合は，例外（java.lang.IllegalArgumentException）が発生します。
-
このほかの注意事項は，CIWServerクラスのallocateWorkItemExメソッドと共通です。詳細は，マニュアルuCosminexus Service Coordinator Interactive Workflow AP 開発ガイドの「5.6 CIWServer」のallocateWorkItemExメソッドの説明を参照してください。