12.4.26　getFlowNodeInstancesListByPDName（ビジネスプロセス定義名を指定してフローノードのリストを取得）

構文

java.util.List<CIWBPMNFlowNodeInstance> getFlowNodeInstancesListByPDName(
        java.sql.Connection aDBConnection,
        CIWServer aCIWServer,
        java.lang.String aProcessDefinitionName,
        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，フローノード名，作業の状態，マルチインスタンスインデクス）を満たすフローノードのリストを取得します。

引数

getFlowNodeInstancesListByPDNameの引数を次の表に示します。

戻り値

取得したフローノードのリストを返します。

例外

getFlowNodeInstancesListByPDNameで発生する例外を次の表に示します。

注意事項

• JDBCコネクションおよびCIWServerオブジェクトにnullを指定した場合は，例外（java.lang.IllegalArgumentException）が発生します。

• JDBCコネクションおよびCIWServerオブジェクトが関連づけられていない場合の動作は保証しません。

• ビジネスプロセス定義名に空文字列またはnullを指定した場合は，例外（java.lang.IllegalArgumentException）が発生します。

• フローノードIDに空文字列を指定した場合は，例外（java.lang.IllegalArgumentException）が発生します。

• 作業の状態のセットに空のセットまたはnullを指定した場合は，例外（java.lang.IllegalArgumentException）が発生します。

• 指定したフィルター条件を満たすフローノードが存在しない場合は，空のリストを返します。

• 指定したビジネスプロセス定義名が示すビジネスプロセス定義に複数のバージョンが存在する場合，すべてのバージョンが検索対象となります。

• 検索対象となるフローノードは，「1.3.1　BPMN連携機能で使用できるBPMN要素」のアクティビティ，イベント，およびアドホック・サブプロセスとなります。ただし，次に示すBPMN要素は検索対象外とします。

  • 開始（タイプなし）

  • スロー（リンク）

  • キャッチ（リンク）

• ワーク管理データベース上に同じビジネスプロセス定義名の案件が大量に存在する場合，大量のフローノードが取得される場合があります。取得対象のフローノードだけが検索されるように適切なフィルター条件（フローノードID，フローノード名，作業の状態）を指定してください。

• すでに登録されたビジネスプロセス定義を変更する際に次の操作をした場合，操作前に生成されたフローノードインスタンスは検索対象外になります。

  • フローノード（BPMN要素）を削除した場合

  • フローノード（BPMN要素）のid属性値またはname属性値を変更した場合