12.4.27 getFlowNodeInstancesListByPIID(案件IDを指定してフローノードのリストを取得)
構文
java.util.List<CIWBPMNFlowNodeInstance> getFlowNodeInstancesListByPIID( java.sql.Connection aDBConnection, CIWServer aCIWServer, java.lang.Integer aProcessInstanceID, java.lang.String aFlowNodeID, java.lang.String aFlowNodeName, java.util.Set<CIWWorkItem.State> aStates, java.lang.Integer aMIIndex, java.util.Set<CIWBPMNFlowNodeInstance.AttributeName> aAttributeNames ) throws CIWFatalException, CIWTransientException
機能
指定したフィルター条件(案件ID,フローノードID,フローノード名,作業の状態,マルチインスタンスインデクス)を満たすフローノードのリストを取得します。
指定した案件IDの案件に所属する,フローノードのリストを取得します。子案件を含めてフローノードを取得する場合,「12.4.28 getFlowNodeInstancesListWithChildPIByPIID(案件IDを指定して子案件を含めたフローノードのリストを取得)」を参照してください。
引数
getFlowNodeInstancesListByPIIDの引数を次の表に示します。
項番 |
仮引数名 |
名称 |
I/O |
説明 |
---|---|---|---|---|
1 |
aDBConnection |
JDBCコネクション |
in |
CIWServerオブジェクトに関連づけられたJDBCコネクションを指定します。 |
2 |
aCIWServer |
CIWServerオブジェクト |
in |
CIWServerオブジェクトを指定します。 |
3 |
aProcessInstanceID |
案件ID |
in |
取得したいフローノードが所属する案件IDを指定します。 nullは指定できません。 |
4 |
aFlowNodeID |
フローノードID(BPMN要素のid属性値) |
in |
取得したいフローノードのフローノードIDを指定します。フローノードIDをフィルター条件に指定しない場合は,nullを指定します。 空文字列は指定できません。 |
5 |
aFlowNodeName |
フローノード名(BPMN要素のname属性値) |
in |
取得したいフローノードのフローノード名を指定します。フローノード名をフィルター条件に指定しない場合は,nullを指定します。 |
6 |
aStates |
作業の状態のセット |
in |
取得したいフローノードに対応する作業の状態のセットを指定します。 指定できる作業の状態については,マニュアルuCosminexus Service Coordinator Interactive Workflow AP開発ガイドの「付録B.2 指定できる属性値」を参照してください。指定できない作業の状態は,フィルター条件に指定されません。 作業の状態をフィルター条件に指定しない場合は,サイズ0の作業の状態のセットまたはnullを指定します。作業の状態にnullは指定できません。 |
7 |
aMIIndex |
マルチインスタンスインデクス |
in |
取得したいフローノードのマルチインスタンスインデクスを指定します。マルチインスタンスインデクスをフィルター条件に指定しない場合は,nullを指定します。 |
8 |
aAttributeNames |
属性名のセット |
in |
取得するフローノード属性名のセットを指定します。 取得属性名を指定しない場合は,サイズ0の属性名のセットまたはnullを指定します。取得属性名にnullは指定できません。取得属性名に指定されていない場合でも,フローノードID,フローノード名,フローノードの種類,作業ID,作業が所属する案件のIDは必ず取得します。取得できる属性は,CIWBPMNFlowNodeInstance.AttributeName列挙型で指定できる属性です。 |
戻り値
取得したフローノードのリストを返します。
例外
getFlowNodeInstancesListByPIIDで発生する例外を次の表に示します。
項番 |
発生する例外 |
説明 |
---|---|---|
1 |
CIWFatalException |
処理を続行できない障害が発生した場合 |
2 |
CIWTransientException |
一時的なエラーが発生した場合 |
注意事項
-
JDBCコネクションおよびCIWServerオブジェクトにnullを指定した場合は,例外(java.lang.IllegalArgumentException)が発生します。
-
JDBCコネクションおよびCIWServerオブジェクトが関連づけられていない場合の動作は保証しません。
-
案件IDにnullを指定した場合は,例外(java.lang.IllegalArgumentException)が発生します。
-
フローノードIDに空文字列を指定した場合は,例外(java.lang.IllegalArgumentException)が発生します。
-
指定したフィルター条件を満たすフローノードが存在しない場合は,空のリストを返します。
-
検索対象となるフローノードは,「1.3.1 BPMN連携機能で使用できるBPMN要素」のアクティビティ,イベント,およびアドホック・サブプロセスとなります。ただし,次に示すBPMN要素は検索対象外です。
-
開始(タイプなし)
-
スロー(リンク)
-
キャッチ(リンク)
-
-
すでに登録されたビジネスプロセス定義を変更する際に次の操作をした場合,操作前に生成されたフローノードインスタンスは検索対象外になります。
-
フローノード(BPMN要素)を削除した場合
-
フローノード(BPMN要素)のid属性値またはname属性値を変更した場合
-