jp.co.intra_mart.foundation.workflow.application.general

クラス ArcMatterNode

java.lang.Object

jp.co.intra_mart.system.workflow.engine.database.WorkflowDAOBase

jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase

jp.co.intra_mart.foundation.workflow.application.general.ArcMatterNode

public class ArcMatterNode
extends jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase

過去案件ノードマネージャ。

アーカイブ処理で退避させた過去案件に対して、案件のノードに関連している情報を取得する際に使用します。
ノードの処理履歴、ノードの設定情報等の特定ノードに関連する情報を取得します。

本クラスでは主に「imw_ayyyymm_」で始まるトランザクション系の過去案件のデータベースのデータを取得します。
テーブル名に含まれる「yyyymm」はコンストラクタで指定する「archiveMonth アーカイブ年月（yyyyMM）」です。

過去案件に対して、案件関連情報を取得するには「ArcMatter」を使用します。
過去案件以外に、処理中の案件や完了案件のノード関連情報取得には「ActvMatterNode」、「CplMatterNode」を利用してください。

導入されたバージョン:

7.2

バージョン:

8.0.24

関連項目:

ArcMatter, ActvMatterNode, CplMatterNode

ネストされたクラスのサマリー

クラスから継承されたネストされたクラス/インタフェース jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase

jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase.SubSearchSql

フィールドのサマリー

クラスから継承されたフィールド jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase

localeId, userCd

クラスから継承されたフィールド jp.co.intra_mart.system.workflow.engine.database.WorkflowDAOBase

COMBINE_AND, COMMA, INVALID_FIELD, LEFT_PARENTHESIS, loginGroupId, manager, PREPARESTMT_BIND_LIST_KEY, PREPARESTMT_SQL_KEY, QUESTION, RIGHT_PARENTHESIS, SINGLE_QUOTE, SPACE, VALID_FIELD_NOT_REQUIRED, VALID_FIELD_REQUIRED, VALID_PRIMARY_FIELD

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
ArcMatterNode(String systemMatterId, String archiveMonth) コンストラクタ。
ArcMatterNode(String localeId, String systemMatterId, String archiveMonth) コンストラクタ。
ArcMatterNode(String loginGroupId, String localeId, String systemMatterId, String archiveMonth) 非推奨です。 ArcMatterNode(String, String, String) を使用してください。

メソッドのサマリー

修飾子とタイプ	メソッドと説明
MatterNodeConfigModel	getExecNodeConfig(String nodeId) 実行フローのノード設定情報を取得します。
MatterNodeModel	getMatterNode(String nodeId) ノード情報を取得します。
MatterProcessHistoryModel	getProcessHistoryLatest(String nodeId) 対象ノードにおける最新の処理履歴を取得します。
MatterProcessHistoryModel[]	getProcessHistoryList(String nodeId) 対象ノードの処理履歴をすべて取得します。
int	getProcessHistoryListCount(String nodeId) 対象ノードの処理履歴の件数を取得します。
protected jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase.SubSearchSql	getPropertyTable() 案件プロパティ（ユーザデータ）テーブルを取得します。
protected jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase.SubSearchSql	getSearchMainTable() 検索メイン用テーブルを取得します。

クラスから継承されたメソッド jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase

appendOrderCondition, checkJoinFlowGrpQuery, checkJoinFlowGrpQueryNoMatterProp, createPreSQL, executeCount, executeCount, executeCount, executeCount, executeCountForEachFlow, executeSearch, executeSearch, executeSearch, executeSearch, isDistinctSearch, modifyFinalCompleteSQL, modifyFinalSearchSQL

クラスから継承されたメソッド jp.co.intra_mart.system.workflow.engine.database.WorkflowDAOBase

addOptionClause, bindingPreStatement, checkField, checkWorkflowDaoMappingClass, closeConnection, closeResultSet, closeStatement, convertLimitSql, createResultObject, createResultObject, createResultObject, getColumnName, getConnection, getDbType, getEscapedValue, getFieldType, getSQLString

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

ArcMatterNode

public ArcMatterNode(String systemMatterId,
                     String archiveMonth)

コンストラクタ。
引数で指定したシステム案件ID、アーカイブ年月（yyyyMM）で
過去案件ノードマネージャを新しく生成します。

パラメータ:

systemMatterId - システム案件ID

archiveMonth - String アーカイブ年月（yyyyMM）

ArcMatterNode

public ArcMatterNode(String localeId,
                     String systemMatterId,
                     String archiveMonth)

コンストラクタ。
引数で指定したロケールID、システム案件ID、アーカイブ年月（yyyyMM）で
過去案件ノードマネージャを新しく生成します。

パラメータ:

localeId - ロケールID

systemMatterId - システム案件ID

archiveMonth - String アーカイブ年月（yyyyMM）

ArcMatterNode

@Deprecated
public ArcMatterNode(String loginGroupId,
                                 String localeId,
                                 String systemMatterId,
                                 String archiveMonth)

非推奨です。 ArcMatterNode(String, String, String) を使用してください。

コンストラクタ。
引数で指定したログイングループID、ロケールID、システム案件ID、アーカイブ年月（yyyyMM）で
過去案件ノードマネージャを新しく生成します。

パラメータ:

loginGroupId - ログイングループID

localeId - ロケールID

systemMatterId - システム案件ID

archiveMonth - String アーカイブ年月（yyyyMM）

メソッドの詳細

getSearchMainTable

protected jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase.SubSearchSql getSearchMainTable()
                                                                                                     throws jp.co.intra_mart.system.workflow.engine.database.WorkflowDAOException

検索メイン用テーブルを取得します。

定義:

getSearchMainTable クラス内 jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase

戻り値:

SubSearchSql テーブル

例外:

jp.co.intra_mart.system.workflow.engine.database.WorkflowDAOException - DAO例外クラス

getPropertyTable

protected jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase.SubSearchSql getPropertyTable()
                                                                                                   throws jp.co.intra_mart.system.workflow.engine.database.WorkflowDAOException

案件プロパティ（ユーザデータ）テーブルを取得します。

定義:

getPropertyTable クラス内 jp.co.intra_mart.system.workflow.api.database.AbstractListDaoBase

戻り値:

SubSearchSql 案件プロパティ（ユーザデータ）テーブル

例外:

jp.co.intra_mart.system.workflow.engine.database.WorkflowDAOException - DAO例外クラス

getMatterNode

public MatterNodeModel getMatterNode(String nodeId)
                              throws WorkflowException

ノード情報を取得します。

コンストラクタに指定した「systemMatterId システム案件ID」、「localeId ロケールID」、「archiveMonth アーカイブ年月（yyyyMM）」、
パラメータで指定したノードIDで取得したフローXMLファイル「flow.xml」から案件のノード情報を取得します。

検索結果を保存する「案件ノード情報」には過去案件のXMLファイルの中で、最終結果の「flow.xml」の値が設定されます。
最終結果の「flow.xml」を取得するには、案件テーブル「imw_ayyyymm_matter」の最終処理ID「last_process_id」に保存されている
値を用いて、過去案件ファイルディレクトリから取得します。
テーブル名に含まれる「yyyymm」はコンストラクタで指定する「archiveMonth アーカイブ年月（yyyyMM）」です。
コンストラクタで指定する「archiveMonth アーカイブ年月（yyyyMM）」に対して、過去案件テーブルが存在しない場合には「null」が返却されます。

パラメータで指定したノードIDに対して、存在有無のチェックは行なっていません。
指定したノードIDがフロー情報に存在しない場合には「NullPointerException」が発生します。

最終処理IDのデータベース検索で失敗した場合や、案件情報取得でコンストラクタに指定したシステム案件IDで検索結果が存在しない場合等、
ノード情報を取得する為のフローXML情報取得に失敗した場合には「WorkflowException」が発生します。

本メソッドでは、ノードに設定されている基本情報や親情報、画面関連情報等が取得できます。
詳細な設定情報をすべて取得するには「getExecNodeConfig(String)」を利用してください。

全てのノードに関して情報を取得するには、「ArcMatter.getExecFlow()」や「ArcMatter.getExecNodeListWithProcessType()」を利用してください。
２つのメソッドで取得できるノード情報は少し差異がありますので、詳細は各メソッドを参照してください。

処理中の未完了案件のノード情報を取得するには「ActvMatterNode.getMatterNode(String)」を利用してください。
完了案件情報を取得するには「CplMatterNode.getMatterNode(String)」を利用してください。

パラメータ:

nodeId - ノードID

戻り値:

MatterNodeModel 案件ノード情報

例外:

WorkflowException - ワークフロー例外の親クラス

getExecNodeConfig

public MatterNodeConfigModel getExecNodeConfig(String nodeId)
                                        throws WorkflowException

実行フローのノード設定情報を取得します。

コンストラクタに指定した「systemMatterId システム案件ID」、「localeId ロケールID」、「archiveMonth アーカイブ年月（yyyyMM）」、
パラメータで指定したノードIDで取得したフローXMLファイル「flow.xml」から案件のノード設定情報を取得します。

検索結果を保存する「案件ノード設定情報」には過去案件のXMLファイルの中で、最終結果の「flow.xml」からノード設定情報を取得します。
最終結果の「flow.xml」を取得するには、案件テーブル「imw_ayyyymm_matter」の最終処理ID「last_process_id」に保存されている
値を用いて、過去案件ファイルディレクトリから取得します。
テーブル名に含まれる「yyyymm」はコンストラクタで指定する「archiveMonth アーカイブ年月（yyyyMM）」です。

パラメータで指定したノードIDに対して、存在有無のチェックは行なっていません。
指定したノードIDがフロー情報に存在しない場合には「null」が返却されます。
コンストラクタで指定する「archiveMonth アーカイブ年月（yyyyMM）」に対して、過去案件テーブルが存在しない場合には「null」が返却されます。

最終処理IDのデータベース検索で失敗した場合や、案件情報取得でコンストラクタに指定したシステム案件IDで検索結果が存在しない場合等、
ノード情報を取得する為のフローXML情報取得に失敗した場合には「WorkflowException」が発生します。

本メソッドでは、ノードの設定関連情報を全て取得します。
ノードの基本情報のみを取得するには「getMatterNode(String)」を利用してください。

処理中の未完了案件のノード情報を取得するには「ActvMatterNode.getExecNodeConfig(String)」を利用してください。
完了案件のノード設定情報を取得するには「CplMatterNode.getExecNodeConfig(String)」を利用してください。

パラメータ:

nodeId - ノードID

戻り値:

MatterNodeConfigModel 案件ノード設定情報

例外:

WorkflowException - ワークフロー例外の親クラス

getProcessHistoryList

public MatterProcessHistoryModel[] getProcessHistoryList(String nodeId)
                                                  throws WorkflowException

対象ノードの処理履歴をすべて取得します。

コンストラクタに指定した「systemMatterId システム案件ID」、「archiveMonth アーカイブ年月（yyyyMM）」と
パラメータで指定した「nodeId ノードID」で、取得した特定ノードの処理履歴をすべて取得します。

検索結果を保存する「案件処理履歴情報の配列」はデータベーステーブル
「imw_ayyyymm_matter_task」のデータが設定されています。
テーブル名に含まれる「yyyymm」はコンストラクタで指定する「archiveMonth アーカイブ年月（yyyyMM）」です。

取得した結果が複数存在する場合は、処理時間順に返却します。
処理時間順のソートは「imw_ayyyymm_matter_task」テーブルの「end_date」カラムで行なっています。

履歴を取得する対象ノードは、ユーザが処理する下記のノード種別を持つノードです。
指定したノードIDが下記の種別ではない場合等、検索結果が存在しない場合にはサイズ０の空オブジェクトを返却します。

 【ノード種別】
 　・申請ノード
 　・承認ノード
 　・動的承認ノード
 　・システムノード
 

コンストラクタで指定する「archiveMonth アーカイブ年月（yyyyMM）」に対して、過去案件テーブルが存在しない場合にもサイズ０の空オブジェクトを返却します。
データベースへの検索処理が失敗した場合に「WorkflowException」が発生します。

本メソッドは差戻しや引戻し等によって、ノードが複数回処理された場合には、複数履歴が取得されます。
最新履歴（最後に処理された履歴）のみ取得する場合には「getProcessHistoryLatest(String)」を利用してください。

特定のノードではなく、全ノードに対して履歴を取得する場合には、「ArcMatter.getProcessHistoryList()」を利用してください。

処理中の未完了案件のノード処理履歴を取得するには「ActvMatterNode.getProcessHistoryList(String)」を利用してください。
完了案件のノード処理履歴を取得するには「CplMatterNode.getProcessHistoryList(String)」を利用してください。

パラメータ:

nodeId - ノードID

戻り値:

MatterProcessHistoryModel[] 案件処理履歴情報の配列

例外:

WorkflowException - ワークフロー例外の親クラス

getProcessHistoryListCount

public int getProcessHistoryListCount(String nodeId)
                               throws WorkflowException

対象ノードの処理履歴の件数を取得します。

コンストラクタに指定した「systemMatterId システム案件ID」、「archiveMonth アーカイブ年月（yyyyMM）」と
パラメータで指定した「nodeId ノードID」で、取得した特定ノードの処理履歴の全件数を取得します。

本メソッドの検索対象データベーステーブルは「imw_ayyyymm_matter_task」です。
テーブル名に含まれる「yyyymm」はコンストラクタで指定する「archiveMonth アーカイブ年月（yyyyMM）」です。
差戻しや引戻し等によって、複数回処理された場合には、複数履歴件数が取得されます。

履歴を取得する対象ノードは、ユーザが処理する下記のノード種別を持つノードです。
指定したノードIDが下記の種別ではない場合等、検索結果が存在しない場合は「０」を返却します。

 【ノード種別】
 　・申請ノード
 　・承認ノード
 　・動的承認ノード
 　・システムノード
 

コンストラクタで指定する「archiveMonth アーカイブ年月（yyyyMM）」に対して、過去案件テーブルが存在しない場合にも「０」を返却します。
データベースへの検索処理が失敗した場合に「WorkflowException」が発生します。

特定ノードではなく、全ノードに対して履歴件数を取得する場合には、「ArcMatter.getProcessHistoryListCount()」を利用してください。

処理中の未完了案件の処理履歴を取得するには「ActvMatterNode.getProcessHistoryListCount(String)」を利用してください。
完了案件の処理履歴を取得するには「CplMatterNode.getProcessHistoryListCount(String)」を利用してください。

パラメータ:

nodeId - ノードID

戻り値:

int 案件処理履歴情報件数

例外:

WorkflowException - ワークフロー例外の親クラス

getProcessHistoryLatest

public MatterProcessHistoryModel getProcessHistoryLatest(String nodeId)
                                                  throws WorkflowException

対象ノードにおける最新の処理履歴を取得します。

コンストラクタに指定した「systemMatterId システム案件ID」、「archiveMonth アーカイブ年月（yyyyMM）」と
パラメータで指定した「nodeId ノードID」で、取得した特定ノードの最新履歴を取得します。

検索結果を保存する「案件処理履歴情報の配列」はデータベーステーブル
「imw_ayyyymm_matter_task」のデータが設定されています。
テーブル名に含まれる「yyyymm」はコンストラクタで指定する「archiveMonth アーカイブ年月（yyyyMM）」です。

履歴を取得する対象ノードは、ユーザが処理する下記のノード種別を持つノードです。
指定したノードIDの最新の履歴データが複数存在することは通常ありえません。
指定したノードIDが下記の種別ではない場合等、検索結果が存在しない場合と検索結果が複数存在する場合には
エラーと判断して「null」を返却します。

 【ノード種別】
 　・申請ノード
 　・承認ノード
 　・動的承認ノード
 　・システムノード
 

コンストラクタで指定する「archiveMonth アーカイブ年月（yyyyMM）」に対して、過去案件テーブルが存在しない場合にも「null」を返却します。
データベースへの検索処理が失敗した場合に「WorkflowException」が発生します。

本メソッドは差戻しや引戻し等によって、複数回処理された場合でも、
「imw_ayyyymm_matter_task」テーブルの「end_date」を基準で、最後に処理された最新データのみを取得します。
最新履歴（最後に処理された履歴）のみではなく、全ての履歴を取得する場合には「getProcessHistoryList(String)」を利用してください。

特定のノードではなく、全ノードに対して最新履歴を取得する場合には、「ArcMatter.getProcessHistoryLatestList()」を利用してください。

処理中の未完了案件のノード処理履歴を取得するには「ActvMatterNode.getProcessHistoryLatest(String)」を利用してください。
過去案件のノード処理履歴を取得するには「CplMatterNode.getProcessHistoryLatest(String)」を利用してください。

パラメータ:

nodeId - ノードID

戻り値:

MatterProcessHistoryModel 案件処理履歴情報

例外:

WorkflowException - ワークフロー例外の親クラス