jp.co.intra_mart.foundation.workflow.application.process

クラス CnfmActvMatterManager

java.lang.Object

jp.co.intra_mart.system.workflow.common.AbstractBase

jp.co.intra_mart.foundation.workflow.application.process.CnfmActvMatterManager

public class CnfmActvMatterManager
extends jp.co.intra_mart.system.workflow.common.AbstractBase

確認（未完了）マネージャ。

コンストラクタに指定したシステム案件IDとノードIDで取得した、ある案件の確認ノードに対して、
あるユーザが処理権限があるかのチェックや、処理できる組織情報の取得、また指定した確認ノードの確認処理を行うことができます。

本クラスでは、未完了状態の案件に対しての確認処理を行います。
未完了案件の確認処理に関連する情報は、データベーステーブルとXMLファイルに格納されています。
データベーステーブルでは下記の情報を保存します。
・「imw_t_confirm」：確認した処理情報。
・「imw_t_confirm_user」：確認できるユーザの情報。
・「imw_t_confirm_orgz」：確認できるユーザの組織情報。
XMLファイルでは、下記の情報を保存します。
※ファイルの格納場所は標準設定の場合です。
※各ファイルは、確認処理を行った時のトランザクションファイルレベル設定が「[2]：全てのファイル情報を作成」の場合に作成されます。
※未完了・完了案件共に、同じファイルを利用します。
「operation_history/confirm.xml」→ 確認した処理情報。
「operation_history/confirmEnableUser.xml」→ 確認できるユーザの情報と組織情報。

コンストラクタに指定したロケールIDは「getAuthUserOrgz(String)」で利用されます。他のメソッドでは利用されません。

完了案件に対して、確認関連処理を行うには「CnfmCplMatterManager」を利用してください。

導入されたバージョン:

7.2

バージョン:

8.0.26

関連項目:

CnfmCplMatterManager

フィールドのサマリー

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

localeId, loginGroupId

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

コンストラクタ

コンストラクタと説明
CnfmActvMatterManager(String systemMatterId, String nodeId) コンストラクタ 引数で指定したシステム案件ID、ノードIDで確認（未完了）マネージャを 新しく生成します。
CnfmActvMatterManager(String localeId, String systemMatterId, String nodeId) コンストラクタ 引数で指定したロケールID、システム案件ID、ノードIDで確認（未完了）マネージャを 新しく生成します。
CnfmActvMatterManager(String loginGroupId, String localeId, String systemMatterId, String nodeId) 非推奨です。 CnfmActvMatterManager(String, String, String) を使用してください。

メソッドのサマリー

修飾子とタイプ	メソッドと説明
void	confirm(ConfirmParam confirmParam) 確認処理を実行します。
AuthUserOrgzModel[]	getAuthUserOrgz(String authUserCd) 未完了案件に対する確認処理権限者の所属組織情報を取得します。
Boolean	isPossibleToConfirm(String execUserCd) 指定したユーザが未完了案件の確認処理を実行できるか判定します。

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

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

コンストラクタの詳細

CnfmActvMatterManager

public CnfmActvMatterManager(String systemMatterId,
                             String nodeId)

コンストラクタ
引数で指定したシステム案件ID、ノードIDで確認（未完了）マネージャを
新しく生成します。

パラメータ:

systemMatterId - システム案件ID

nodeId - ノードID

CnfmActvMatterManager

public CnfmActvMatterManager(String localeId,
                             String systemMatterId,
                             String nodeId)

コンストラクタ
引数で指定したロケールID、システム案件ID、ノードIDで確認（未完了）マネージャを
新しく生成します。

パラメータ:

localeId - ロケールID

systemMatterId - システム案件ID

nodeId - ノードID

CnfmActvMatterManager

@Deprecated
public CnfmActvMatterManager(String loginGroupId,
                                         String localeId,
                                         String systemMatterId,
                                         String nodeId)

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

コンストラクタ
引数で指定したログイングループID、ロケールID、システム案件ID、ノードIDで確認（未完了）マネージャを
新しく生成します。

パラメータ:

loginGroupId - ログイングループID

localeId - ロケールID

systemMatterId - システム案件ID

nodeId - ノードID

メソッドの詳細

confirm

public void confirm(ConfirmParam confirmParam)
             throws WorkflowException

確認処理を実行します。
内部でトランザクションの制御処理を行います。 メソッドの実行前に、ユーザトランザクションを終了状態にして置く必要があります。

指定した「確認用パラメータ情報」で、確認処理情報の登録処理を行います。
確認処理は、確認用パラメータ情報に指定した「権限者コード」のユーザが処理対象確認ノードに対して
確認処理対象者に設定されてない場合には処理ができません。「WorkflowException」が発生します。
同じく、コンストラクタに指定したノードIDが確認ノードIDではない場合、又は確認ノードでまだ未到達の場合にも
確認権限者情報が取得できないので、「WorkflowException」が発生します。

確認処理の履歴情報は「imw_t_confirm」テーブルに保存されます。
確認処理の履歴情報はコンストラクタに指定したロケールとは関係なく、システムで指定されている全ロケール分作成します。
確認処理を行ったユーザに対しては、「imw_t_confirm_user」テーブルの確認済みフラグ「CONFIRM_CPL_FLAG」を「１」に更新します。
確認処理情報はXMLファイルにも保存します。トランザクションファイルレベル設定が「[2]：全てのファイル情報を作成」の場合に

確認処理内のトランザクション処理は、データベースへのデータ登録や、XMLファイルへの書き込み処理が全て終了した後のコミット処理になります。
データの登録順は、データベース処理後にファイル処理を行なっています。
ファイルの処理でエラーが発生した場合には、データベースのデータは全てロールバックされますが、
場合によっては、XMLファイルのデータには処理時のデータが残る場合もあります。

完了案件に対して、確認処理を行うには「CnfmCplMatterManager.confirm(ConfirmParam)」を利用してください。

パラメータ:

confirmParam - 確認用パラメータ情報

例外:

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

導入されたバージョン:

7.2

getAuthUserOrgz

public AuthUserOrgzModel[] getAuthUserOrgz(String authUserCd)
                                    throws WorkflowException

未完了案件に対する確認処理権限者の所属組織情報を取得します。
コンストラクタに指定したシステム案件IDに該当する案件で、
確認処理ができるあるユーザに対して、確認処理時に選択できる所属組織情報を取得します。

このメソッドでは、確認ができるユーザ情報を保存しているデータベーステーブル
「imw_t_confirm_user」、「imw_t_confirm_orgz」からパラメータで指定したユーザ情報を取得します。
指定したユーザがシステム案件IDの該当案件に対して、確認処理ができない人の場合は、 サイズ０の空のオブジェクトを返却します。
同じく、該当案件の確認ノードがまだ未到達の状態の場合でも、サイズ０の空のオブジェクトを返却します。
該当案件に確認ノードが複数ある場合には、各確認ノードで処理できる組織情報を全て取得します。

結果モデルである「処理権限者所属組織情報の配列」には、「imw_t_confirm_user」と「imw_t_confirm_orgz」のデータが設定されます。
複数のデータを返却する際には、結果は「権限者会社コード」、「権限者組織セットコード」、「権限者組織コード」の順で、
各値の昇順でソートされます。

データベースへの検索処理が失敗した場合には「WorkflowException」が発生します。

一括確認処理時に確認処理権限者が選択できる所属組織情報を取得するには、「LumpAuthUserOrgzManager.getCnfmAuthUserOrgzForActvMtr(String)」を利用してください。

完了案件に対して、確認処理権限者の所属組織情報を取得するには「CnfmCplMatterManager.getAuthUserOrgz(String)」を利用してください。

パラメータ:

authUserCd - 権限者コード

戻り値:

AuthUserOrgzModel[] 処理権限者所属組織情報の配列

例外:

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

isPossibleToConfirm

public Boolean isPossibleToConfirm(String execUserCd)
                            throws WorkflowException

指定したユーザが未完了案件の確認処理を実行できるか判定します。

以下の２つの要件を満たす時、確認可能（true）を返却します。
・確認ノードが処理可能な状態か
・指定したユーザが確認ノードの処理対象者として設定されているか

パラメータ:

execUserCd - 実行者コード

戻り値:

Boolean 確認可否判定結果(true:確認可能 / false:確認不可能)

例外:

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