CnfmCplMatterManager (javadoc-all-dev 8.0.0 API)

java.lang.Object
- jp.co.intra_mart.system.workflow.common.AbstractBase
- - jp.co.intra_mart.foundation.workflow.application.process.CnfmCplMatterManager

```
public class CnfmCplMatterManager
extends jp.co.intra_mart.system.workflow.common.AbstractBase
```
確認（完了）マネージャ。

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

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

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

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

導入されたバージョン:

7.2

バージョン:

8.0.26

関連項目:

CnfmActvMatterManager

フィールドのサマリー
- クラスから継承されたフィールド jp.co.intra_mart.system.workflow.common.AbstractBase
  localeId, loginGroupId

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

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

メソッドのサマリー

すべてのメソッドインスタンス・メソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`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

- コンストラクタの詳細
  - CnfmCplMatterManager
```
public CnfmCplMatterManager(String systemMatterId,
                            String nodeId)
```
    コンストラクタ
    引数で指定したシステム案件ID、ノードIDで確認（完了）マネージャを
    新しく生成します。
    
    パラメータ:
    
    systemMatterId - システム案件ID
    
    nodeId - ノードID
  - CnfmCplMatterManager
```
public CnfmCplMatterManager(String localeId,
                            String systemMatterId,
                            String nodeId)
```
    コンストラクタ
    引数で指定したロケールID、システム案件ID、ノードIDで確認（完了）マネージャを
    新しく生成します。
    
    パラメータ:
    
    localeId - ロケールID
    
    systemMatterId - システム案件ID
    
    nodeId - ノードID
  - CnfmCplMatterManager
```
@Deprecated
public CnfmCplMatterManager(String loginGroupId,
                                        String localeId,
                                        String systemMatterId,
                                        String nodeId)
```
    非推奨です。 CnfmCplMatterManager(String, String, String) を使用してください。
    
    コンストラクタ
    引数で指定したログイングループID、ロケールID、システム案件ID、ノードIDで確認（完了）マネージャを
    新しく生成します。
    
    パラメータ:
    
    loginGroupId - ログイングループID
    
    localeId - ロケールID
    
    systemMatterId - システム案件ID
    
    nodeId - ノードID
- メソッドの詳細
  - confirm
```
public void confirm(ConfirmParam confirmParam)
             throws WorkflowException
```
    完了案件の確認処理を実行します。
    
    このメソッドでは内部でトランザクションの制御処理を行なっています。
    メソッドの実行前に、ユーザトランザクションを終了状態にして置く必要があります。
    
    指定した「確認用パラメータ情報」で、確認処理情報の登録処理を行います。
    完了案件に対して確認処理を行うには、フローの設定で、事前に完了案件の確認処理を可能に設定して置く必要があります。
    完了案件に対して確認処理ができない設定の場合は「WorkflowException」が発生します。
    確認用パラメータ情報に指定した「権限者コード」のユーザが処理対象確認ノードに対して
    確認処理対象者に設定されてない場合には処理ができません。「WorkflowException」が発生します。
    同じく、コンストラクタに指定したノードIDが確認ノードIDではない場合、又は確認ノードでまだ未到達の場合にも
    確認権限者情報が取得できないので、「WorkflowException」が発生します。
    
    確認処理の履歴情報は「imw_t_cpl_matter_confirm」テーブルに保存されます。
    確認処理の履歴情報はコンストラクタに指定したロケールとは関係なく、システムで指定されている全ロケール分作成します。
    確認処理を行ったユーザに対しては、「imw_t_cpl_matter_confirm_user」テーブルの確認済みフラグ「CONFIRM_CPL_FLAG」を「１」に更新します。
    確認処理情報はXMLファイルにも保存します。トランザクションファイルレベル設定が「[2]：全てのファイル情報を作成」の場合に
    
    確認処理内のトランザクション処理は、データベースへのデータ登録や、XMLファイルへの書き込み処理が全て終了した後のコミット処理になります。
    データの登録順は、データベース処理後にファイル処理を行なっています。
    ファイルの処理でエラーが発生した場合には、データベースのデータは全てロールバックされますが、
    場合によっては、XMLファイルのデータには処理時のデータが残る場合もあります。
    
    処理中の未完了案件に対して、確認処理を行うには「CnfmActvMatterManager.confirm(ConfirmParam)」を利用してください。
    
    パラメータ:
    
    confirmParam - 確認用パラメータ情報
    
    例外:
    
    WorkflowException - ワークフロー例外の親クラス
    
    導入されたバージョン:
    
    7.2
  - getAuthUserOrgz
```
public AuthUserOrgzModel[] getAuthUserOrgz(String authUserCd)
                                    throws WorkflowException
```
    完了案件に対する確認処理権限者の所属組織情報を取得します。
    
    コンストラクタに指定したシステム案件IDに該当する案件で、
    確認処理ができるあるユーザに対して、確認処理時に選択できる所属組織情報を取得します。
    
    このメソッドでは、確認ができるユーザ情報を保存しているデータベーステーブル
    「imw_t_cpl_matter_confirm_user」、「imw_t_cpl_matter_confirm_orgz」からパラメータで指定したユーザ情報を取得します。
    指定したユーザがシステム案件IDの該当案件に対して、確認処理ができない人の場合は、サイズ０の空のオブジェクトを返却します。
    同じく、該当案件の確認ノードがまだ未到達の状態の場合でも、サイズ０の空のオブジェクトを返却します。
    該当案件に確認ノードが複数ある場合には、各確認ノードで処理できる組織情報を全て取得します。
    
    結果モデルである「処理権限者所属組織情報の配列」には、「imw_t_cpl_matter_confirm_user」と「imw_t_cpl_matter_confirm_orgz」のデータが設定されます。
    複数のデータを返却する際には、結果は「権限者会社コード」、「権限者組織セットコード」、「権限者組織コード」の順で、
    各値の昇順でソートされます。
    
    データベースへの検索処理が失敗した場合には「WorkflowException」が発生します。
    
    一括確認処理時に確認処理権限者が選択できる所属組織情報を取得するには、「LumpAuthUserOrgzManager.getCnfmAuthUserOrgzForCplMtr(String)」を利用してください。
    
    処理中の未完了案件に対して、確認処理権限者の所属組織情報を取得するには「CnfmActvMatterManager.getAuthUserOrgz(String)」を利用してください。
    
    パラメータ:
    
    authUserCd - 権限者コード
    
    戻り値:
    
    AuthUserOrgzModel[] 処理権限者所属組織情報の配列
    
    例外:
    
    WorkflowException - ワークフロー例外の親クラス
  - isPossibleToConfirm
```
public Boolean isPossibleToConfirm(String execUserCd)
                            throws WorkflowException
```
    指定したユーザが完了案件の確認処理を実行できるか判定します。
    
    以下の３つの要件を満たす時、確認可能（true）を返却します。
    - 確認ノードが処理可能な状態か
    - 指定したユーザが確認ノードの処理対象者として設定されているか
    - 案件申請時のフロー定義にて「完了した案件の確認」が "有効" に設定されているか
    パラメータ:
    
    execUserCd - 実行者コード
    
    戻り値:
    
    Boolean 確認可否判定結果(true:確認可能 / false:確認不可能)
    
    例外:
    
    WorkflowException - ワークフロー例外の親クラス
    
    導入されたバージョン:
    
    7.2

クラス CnfmCplMatterManager

フィールドのサマリー

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

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

メソッドのサマリー

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

コンストラクタの詳細

CnfmCplMatterManager

CnfmCplMatterManager

CnfmCplMatterManager

メソッドの詳細

confirm

getAuthUserOrgz

isPossibleToConfirm