CplMatterNodeオブジェクト
| コンポーネント情報 | |
|---|---|
| version | 8.0.24 |
| since | 7.2 |
案件（完了）ノードマネージャ。
完了した案件に対して、案件のノードに関連している情報を取得する際に使用します。
ノードの処理履歴、ノードの処理対象者や確認権限者、ノードの設定情報等の特定ノードに関連する情報を取得します。
本オブジェクトでは主に「imw_t_cpl」で始まるトランザクション系の完了案件のデータベースのデータを取得します。
完了した案件に対して、案件関連情報を取得するには「CplMatter#」を使用します。
完了した案件以外に、処理中の案件や過去案件のノード関連情報取得には「ActvMatterNode#」、「ArcMatterNode#」を利用してください。
関連オブジェクト:CplMatter#, ActvMatterNode#}, ArcMatterNode#
完了した案件に対して、案件のノードに関連している情報を取得する際に使用します。
ノードの処理履歴、ノードの処理対象者や確認権限者、ノードの設定情報等の特定ノードに関連する情報を取得します。
本オブジェクトでは主に「imw_t_cpl」で始まるトランザクション系の完了案件のデータベースのデータを取得します。
完了した案件に対して、案件関連情報を取得するには「CplMatter#」を使用します。
完了した案件以外に、処理中の案件や過去案件のノード関連情報取得には「ActvMatterNode#」、「ArcMatterNode#」を利用してください。
関連オブジェクト:CplMatter#, ActvMatterNode#}, ArcMatterNode#
定数
| 型 | 定数名 | 定数値 |
|---|---|---|
| Stringstatic | CONFIRM_CPL_FLAG 確認済みフラグ |
|
| Stringstatic | USER_CODE ユーザコード |
|
| Stringstatic | USER_NAME ユーザ名 |
|
コンストラクタの概要
CplMatterNode (String [localeId], String systemMatterId) コンストラクタ。 |
CplMatterNode (String loginGroupId, String localeId, String systemMatterId) 非推奨コンストラクタ。
CplMatterNode(String localeId, String systemMatterId) を使用してください。
|
メソッドの概要
| 返却値の型 | メソッド名 |
|---|---|
| WorkflowResultInfo | getCnfmAuthUserListCount (String nodeId) 完了案件の特定ノード確認処理権限者情報の件数を取得します。 |
| WorkflowResultInfo | getCnfmAuthUserList (String nodeId, SortConditionForAuthUser cond) 完了案件の特定ノード確認処理権限者情報をすべて取得します。 |
| WorkflowResultInfo | getExecNodeConfig (String nodeId) 実行フローのノード設定情報を取得します。 |
| WorkflowResultInfo | getExecProcessTargetList (String nodeId) 結果フローのノードの処理対象をすべて取得します。 |
| WorkflowResultInfo | getMasterProcessTargetList (String nodeId) マスタフローのノードの処理対象をすべて取得します。 |
| WorkflowResultInfo | getMatterNode (String nodeId) ノード情報を取得します。 |
| WorkflowResultInfo | getProcessHistoryLatest (String nodeId) 対象ノードにおける最新の処理履歴を取得します。 |
| WorkflowResultInfo | getProcessHistoryListCount (String nodeId) 対象ノードの処理履歴の件数を取得します。 |
| WorkflowResultInfo | getProcessHistoryList (String nodeId) 対象ノードの処理履歴をすべて取得します。 |
コンストラクタの詳細
CplMatterNode (String [localeId], String systemMatterId)
コンストラクタ。
引数で指定したパラメータで案件（完了）ノードマネージャを新しく生成します。
パラメータ
|
CplMatterNode (String loginGroupId, String localeId, String systemMatterId)
非推奨
CplMatterNode(String localeId, String systemMatterId) を使用してください。
コンストラクタ。
引数で指定したパラメータで案件（完了）ノードマネージャを新しく生成します。
パラメータ
|
メソッドの詳細
WorkflowResultInfo getCnfmAuthUserListCount (String nodeId)
完了案件の特定ノード確認処理権限者情報の件数を取得します。
コンストラクタに指定した「systemMatterId システム案件ID」とパラメータで指定したノードIDで、 その案件の特定ノードで確認ができる権限者の全人数を取得します。 本メソッドの検索対象データベーステーブルは「imw_t_cpl_matter_confirm_user」です。 特定ノードに限らず、案件の全確認権限者情報の件数を取得するには「CplMatter#getCnfmAuthUserListCount()」を利用してください。 処理中の未完了案件の特定ノード確認処理権限者情報の件数を取得するには「ActvMatterNode#getCnfmAuthUserListCount(String)」を利用してください。
パラメータ
返却値
|
WorkflowResultInfo getCnfmAuthUserList (String nodeId, SortConditionForAuthUser cond)
完了案件の特定ノード確認処理権限者情報をすべて取得します。
コンストラクタに指定した「systemMatterId システム案件ID」とパラメータで指定したノードIDで、 その案件の特定確認ノードで確認ができる権限者情報をすべて取得します。 検索条件を設定する為の引数である権限者情報ソート条件オブジェクトの設定は必須です。 特に検索条件を設定する必要がない場合でもインスタンスを作成して設定する必要があります。 検索結果が存在しない場合にはdata属性にサイズ０の空オブジェクトを設定して返却します。 ノードIDに「null」もしくは存在しないノードIDを指定した場合もdata属性にサイズ０の空オブジェクトを設定して返却します。 検索結果を保存する「確認処理権限者情報オブジェクトの配列」はデータベーステーブル「imw_t_cpl_matter_confirm_user」のデータが設定されています。 オブジェクトに定義されている定数値で検索条件を設定できます。詳しい使用方法は「SortConditionForAuthUser#」を参照してください。 パラメータで指定する権限者情報ソート条件オブジェクトはソートの条件のみ指定できます。ユーザを絞り込む為の条件としては使用できません。 特定ノードに限らず、案件の全確認権限者情報を取得するには「CplMatter#getCnfmAuthUserList(SortConditionForAuthUser)」を利用してください。 処理中の未完了案件の特定ノードの確認処理権限者情報を取得するには「ActvMatterNode#getCnfmAuthUserList(String, SortConditionForAuthUser)」を利用してください。
パラメータ
返却値
|
WorkflowResultInfo getExecNodeConfig (String nodeId)
実行フローのノード設定情報を取得します。
コンストラクタに指定した「systemMatterId システム案件ID」と「localeId ロケールID」、 パラメータで指定したノードIDで取得したフローXMLファイル「flow.xml」から案件のノード設定情報を取得します。 検索結果を保存する「案件ノード設定情報オブジェクト」にはトランザクションXMLファイルの中で、最終結果の「flow.xml」からノード設定情報を取得します。 最終結果の「flow.xml」を取得するには、案件テーブル「imw_t_cpl_matter」の最終処理ID「LAST_PROCESS_ID」に保存されている 値を用いて、トランザクションファイルディレクトリから取得します。 パラメータで指定したノードIDに対して、存在有無のチェックは行なっていません。 指定したノードIDがフロー情報に存在しない場合にはdata属性に「null」を設定して返却します。 最終処理IDのデータベース検索で失敗した場合や、案件情報取得でコンストラクタに指定したシステム案件IDで検索結果が存在しない場合等、 ノード情報を取得する為のフローXML情報取得に失敗した場合には処理に失敗し、エラー情報を格納した結果オブジェクトを返却します。 本メソッドでは、ノードの設定関連情報を全て取得します。 ノードの基本情報のみを取得するには「getMatterNode(String)」を利用してください。 処理中の未完了案件のノード設定情報を取得するには「ActvMatterNode#getExecNodeConfig(String)」を利用してください。 過去案件のノード設定設定を取得するには「ArcMatterNode#getExecNodeConfig(String)」を利用してください。
パラメータ
返却値
|
WorkflowResultInfo getExecProcessTargetList (String nodeId)
結果フローのノードの処理対象をすべて取得します。
コンストラクタに指定した「systemMatterId システム案件ID」と「localeId ロケールID」、 パラメータで指定したノードIDで取得したフローXMLファイル「flow.xml」から指定ノード権限者プラグイン情報を取得します。 検索結果を保存する「処理対象者情報オブジェクト」にはトランザクションXMLファイルの中で、最終結果の「flow.xml」からのノード情報が設定されます。 最終結果の「flow.xml」を取得するには、案件テーブル「imw_t_cpl_matter」の最終処理ID「LAST_PROCESS_ID」に保存されている 値を用いて、トランザクションファイルディレクトリから取得します。 パラメータで指定したノードIDに対して、存在有無のチェックは行なっていません。 指定したノードIDがフロー情報に存在しない場合にはdata属性にサイズ０の空オブジェクトを設定して返却します。 最終処理IDのデータベース検索で失敗した場合や、案件情報取得でコンストラクタに指定したシステム案件IDで検索結果が存在しない場合等、 ノード情報を取得する為のフローXML情報取得に失敗した場合には、エラー情報を格納した結果オブジェクトを返却します。 処理中の最新フロー情報ではなく、申請・起票時のマスタフローから情報を取得するには「getMasterProcessTargetList(String)」を利用してください。 処理中の未完了案件の処理対象者プラグイン情報を取得するには「ActvMatterNode#getExecProcessTargetList(String)」を利用してください。
パラメータ
返却値
|
WorkflowResultInfo getMasterProcessTargetList (String nodeId)
マスタフローのノードの処理対象をすべて取得します。
コンストラクタに指定した「systemMatterId システム案件ID」と「localeId ロケールID」、 パラメータで指定したノードIDで取得したマスタフローXMLファイル「masterflow.xml」から指定ノード権限者プラグイン情報を取得します。 検索結果を保存する「処理対象者情報オブジェクト」にはトランザクションXMLファイルの中で、「masterflow.xml」の値が設定されます。 パラメータで指定したノードIDに対して、存在有無のチェックは行なっていません。 指定したノードIDがフロー情報に存在しない場合にはdata属性にサイズ０の空オブジェクトを設定して返却します。 最終処理IDのデータベース検索で失敗した場合や、案件情報取得でコンストラクタに指定したシステム案件IDで検索結果が存在しない場合等、 ノード情報を取得する為のマスタフローXML情報取得に失敗した場合には、エラー情報を格納した結果オブジェクトを返却します。 マスタフローではなく、処理中の最新フロー情報からから情報を取得するには「getExecProcessTargetList(String)」を利用してください。 処理中の未完了案件のマスタ情報からの処理対象者プラグイン情報を取得するには「ActvMatterNode#getMasterProcessTargetList(String)」を利用してください。
パラメータ
返却値
|
WorkflowResultInfo getMatterNode (String nodeId)
ノード情報を取得します。
コンストラクタに指定した「systemMatterId システム案件ID」と「localeId ロケールID」、 パラメータで指定したノードIDで取得したフローXMLファイル「flow.xml」から案件のノード情報を取得します。 検索結果を保存する「案件ノード情報オブジェクト」にはトランザクションXMLファイルの中で、最終結果の「flow.xml」の値が設定されます。 最終結果の「flow.xml」を取得するには、案件テーブル「imw_t_cpl_matter」の最終処理ID「last_process_id」に保存されている 値を用いて、トランザクションファイルディレクトリから取得します。 パラメータで指定したノードIDに対して、存在有無のチェックは行なっていません。 指定したノードIDがフロー情報に存在しない場合は、エラー情報を格納した結果オブジェクトを返却します。 最終処理IDのデータベース検索で失敗した場合や、案件情報取得でコンストラクタに指定したシステム案件IDで検索結果が存在しない場合等、 ノード情報を取得する為のフローXML情報取得に失敗した場合には処理に失敗し、エラー情報を格納した結果オブジェクトを返却します。 本メソッドでは、ノードに設定されている基本情報や親情報、画面関連情報等が取得できます。 詳細な設定情報をすべて取得するには「getExecNodeConfig(String)」を利用してください。 全てのノードに関して情報を取得するには、「CplMatter#getExecFlow()」や「CplMatter#getExecNodeListWithProcessType()」を利用してください。 ２つのメソッドで取得できるノード情報は少し差異がありますので、詳細は各メソッドを参照してください。 処理中の未完了案件のノード情報を取得するには「ActvMatterNode#getMatterNode(String)」を利用してください。 過去案件情報を取得するには「ArcMatterNode#getMatterNode(String)」を利用してください。
パラメータ
返却値
|
WorkflowResultInfo getProcessHistoryLatest (String nodeId)
対象ノードにおける最新の処理履歴を取得します。
コンストラクタに指定した「systemMatterId システム案件ID」とパラメータで指定した「nodeId ノードID」で、 取得した特定ノードの最新履歴を取得します。 検索結果を保存する「案件処理履歴情報オブジェクトの配列」はデータベーステーブル 「imw_t_cpl_matter_task」、「imw_t_cpl_matter_user」のデータが設定されています。 履歴を取得する対象ノードは、ユーザが処理する下記のノード種別を持つノードです。 指定したノードIDの最新の履歴データが複数存在することは通常ありえません。 指定したノードIDが下記の種別ではない場合等、検索結果が存在しない場合と検索結果が複数存在する場合には エラーと判断してdata属性に「null」を設定して返却します。 【ノード種別】 ・申請ノード ・承認ノード ・動的承認ノード ・システムノードデータベースへの検索処理が失敗した場合には、エラー情報を格納した結果オブジェクトを返却します。 本メソッドは差戻しや引戻し等によって、複数回処理された場合でも、 「imw_t_cpl_matter_task」テーブルの「end_date」を基準で、最後に処理された最新データのみを取得します。 最新履歴（最後に処理された履歴）のみではなく、全ての履歴を取得する場合には「getProcessHistoryList(String)」を利用してください。 特定のノードではなく、全ノードに対して最新履歴を取得する場合には、「CplMatter#getProcessHistoryLatestList()」を利用してください。 処理中の未完了案件のノード処理履歴を取得するには「ActvMatterNode#getProcessHistoryLatest(String)」を利用してください。 過去案件のノード処理履歴を取得するには「ArcMatterNode#getProcessHistoryLatest(String)」を利用してください。
パラメータ
返却値
|
WorkflowResultInfo getProcessHistoryListCount (String nodeId)
対象ノードの処理履歴の件数を取得します。
コンストラクタに指定した「systemMatterId システム案件ID」とパラメータで指定した「nodeId ノードID」で、 取得した特定ノードの処理履歴の全件数を取得します。 本メソッドの検索対象データベーステーブルは「imw_t_cpl_matter_task」、「imw_t_cpl_matter_user」です。 差戻しや引戻し等によって、複数回処理された場合には、複数履歴件数が取得されます。 履歴を取得する対象ノードは、ユーザが処理する下記のノード種別を持つノードです。 指定したノードIDが下記の種別ではない場合等、検索結果が存在しない場合はdata属性にサイズ０の空オブジェクトを設定して返却します。 【ノード種別】 ・申請ノード ・承認ノード ・動的承認ノード ・システムノードデータベースへの検索処理が失敗した場合には、エラー情報を格納した結果オブジェクトを返却します。 特定ノードではなく、全ノードに対して履歴件数を取得する場合には、「CplMatter#getProcessHistoryListCount()」を利用してください。 処理中の未完了案件の処理履歴を取得するには「ActvMatterNode#getProcessHistoryListCount(String)」を利用してください。 過去案件の処理履歴を取得するには「ArcMatterNode#getProcessHistoryListCount(String)」を利用してください。
パラメータ
返却値
|
WorkflowResultInfo getProcessHistoryList (String nodeId)
対象ノードの処理履歴をすべて取得します。
コンストラクタに指定した「systemMatterId システム案件ID」とパラメータで指定した「nodeId ノードID」で、 取得した特定ノードの処理履歴をすべて取得します。 検索結果を保存する「案件処理履歴情報オブジェクトの配列」はデータベーステーブル 「imw_t_cpl_matter_task」、「imw_t_cpl_matter_user」のデータが設定されています。 取得した結果が複数存在する場合は、処理時間順に返却します。 処理時間順のソートは「imw_t_cpl_matter_task」テーブルの「end_date」カラムで行なっています。 履歴を取得する対象ノードは、ユーザが処理する下記のノード種別を持つノードです。 指定したノードIDが下記の種別ではない場合等、検索結果が存在しない場合にはdata属性にサイズ０の空オブジェクトを設定して返却します。 【ノード種別】 ・申請ノード ・承認ノード ・動的承認ノード ・システムノードデータベースへの検索処理が失敗した場合には、エラー情報を格納した結果オブジェクトを返却します。 本メソッドは差戻しや引戻し等によって、ノードが複数回処理された場合には、複数履歴が取得されます。 最新履歴（最後に処理された履歴）のみ取得する場合には「getProcessHistoryLatest(String)」を利用してください。 特定のノードではなく、全ノードに対して履歴を取得する場合には、「CplMatter#getProcessHistoryList()」を利用してください。 処理中の未完了案件のノード処理履歴を取得するには「ActvMatterNode#getProcessHistoryList(String)」を利用してください。 過去案件のノード処理履歴を取得するには「ArcMatterNode#getProcessHistoryList(String)」を利用してください。
パラメータ
返却値
|