12.4.25 getFlowNodeDefinitionsList(フローノード定義のリストを取得)
構文
java.util.List<CIWBPMNFlowNodeDefinition> getFlowNodeDefinitionsList( java.sql.Connection aDBConnection, CIWServer aCIWServer, java.lang.String aProcessDefinitionName, java.lang.String aFlowNodeID, java.lang.String aFlowNodeName, java.util.Set<CIWBPMNFlowNodeDefinition.AttributeName> aAttributeNames ) throws CIWFatalException, CIWTransientException
機能
指定したフィルター条件(ビジネスプロセス定義名,フローノードID,フローノード名)を満たすフローノード定義のリストを取得します。
引数
getFlowNodeDefinitionsListの引数を次の表に示します。
項番 |
仮引数名 |
名称 |
I/O |
説明 |
---|---|---|---|---|
1 |
aDBConnection |
JDBCコネクション |
in |
CIWServerオブジェクトに関連づけられたJDBCコネクションを指定します。 |
2 |
aCIWServer |
CIWServerオブジェクト |
in |
CIWServerオブジェクトを指定します。 |
3 |
aProcessDefinitionName |
ビジネスプロセス定義名 |
in |
取得したいフローノード定義が所属するビジネスプロセス定義名を指定します。 空文字列およびnullは指定できません。 |
4 |
aFlowNodeID |
フローノードID(BPMN要素のid属性値) |
in |
取得したいフローノード定義のフローノードIDを指定します。フローノードIDをフィルター条件に指定しない場合は,nullを指定します。 空文字列は指定できません。 |
5 |
aFlowNodeName |
フローノード名(BPMN要素のname属性値) |
in |
取得したいフローノード定義のフローノード名を指定します。フローノード名をフィルター条件に指定しない場合は,nullを指定します。 |
6 |
aAttributeNames |
属性名のセット |
in |
取得するフローノード定義属性名のセットを指定します。 取得属性名を指定しない場合は,サイズ0の属性名のセットまたはnullを指定します。取得属性名にnullは指定できません。取得属性名に指定されていない場合でも,フローノードID,フローノード名,フローノードの種類,ref識別子,calledElementは必ず取得します。取得できる属性は,CIWBPMNFlowNodeDefinition.AttributeName列挙型で指定できる属性です。 |
戻り値
取得したフローノード定義のリストを返します。
例外
getFlowNodeDefinitionsListで発生する例外を次の表に示します。
項番 |
発生する例外 |
説明 |
---|---|---|
1 |
CIWFatalException |
処理を続行できない障害が発生した場合 |
2 |
CIWTransientException |
一時的なエラーが発生した場合 |
注意事項
-
JDBCコネクションおよびCIWServerオブジェクトにnullを指定した場合は,例外(java.lang.IllegalArgumentException)が発生します。
-
JDBCコネクションおよびCIWServerオブジェクトが関連づけられていない場合の動作は保証しません。
-
ビジネスプロセス定義名に空文字列またはnullを指定した場合は,例外(java.lang.IllegalArgumentException)が発生します。
-
フローノードIDに空文字列を指定した場合は,例外(java.lang.IllegalArgumentException)が発生します。
-
指定したフィルター条件を満たすフローノード定義が存在しない場合は,空のリストを返します。
-
指定したビジネスプロセス定義名が示すビジネスプロセス定義に複数のバージョンが存在する場合,すべてのバージョンが検索対象となります。
-
検索対象となるフローノードは,「1.3.1 BPMN連携機能で使用できるBPMN要素」のアクティビティ,イベント,およびアドホック・サブプロセスとなります。ただし,次に示すBPMN要素は検索対象外です。
-
開始(タイプなし)
-
スロー(リンク)
-
キャッチ(リンク)
-