///////////////////////////////////////////////////////////////////////////////
//  intra-mart IM-Workflow Ver7.2.6 以降 対応版                              //
//  過去案件印影リカバリバッチ                                               //
//                                                                           //
//  セットアップと注意点                                                     //
//                                                                2016/02/01 //
///////////////////////////////////////////////////////////////////////////////

---------------------------------------------
■前提条件
---------------------------------------------
1. 「IM-Workflow Ver.7.2.6」以降が正常に動作していること。

---------------------------------------------
■注意事項
---------------------------------------------
1. intra-mart Accel Platform に移行する際は、本モジュールを必ずアンインストールしてください。

2. その他、intra-mart WebPlatform/AppFramework Ver.7.2 および IM-Workflow Ver.7.2 の制限事項に準じます。

※ 本モジュールは classファイル・propertiesファイルでの提供となります。

---------------------------------------------
■2016/02/01 ... Ver7.2.6 以降 対応版 過去案件印影リカバリバッチ
---------------------------------------------
各項目のステータスは以下のとおりです。
【修正】・・・バグなどの修正
【改善】・・・機能の仕様改善やチューニング等
【変更】・・・仕様変更
【追加】・・・機能追加など

【追加】【概要】
        過去案件の印影不正データを修正するリカバリモジュールを提供します。

        【詳細】
        案件退避処理の印影のユーザプログラムには、アーカイブ年月を申請基準日ではなく
        申請日から生成してしまうという不具合が存在します。
        例えば申請基準日＝2015/12/01、申請日＝2016/01/01 の案件をアーカイブした場合、
        印影情報以外の案件情報はアーカイブ年月「201512」として退避されますが、
        印影情報のみアーカイブ年月「201601」として退避されてしまいます。
        その結果、印影情報とそれ以外の案件情報の退避先が異なる状態となり、当該の案件を参照した際に
        印影情報が参照できなくなります。

        上記の不具合に対しては、IM-Workflow 7.2.11 対応版のパッチが提供されているため、
        当該パッチを適用することで解消することができます。

        当パッチでは、上記不具合によって生成された不整合な状態の印影情報をリカバリするバッチを提供します。
        具体的には、過去案件情報が持つ不整合な印影情報に対して、誤った格納先である申請日の年月テーブルから
        正しい格納先である申請基準日の年月テーブルへの移行を行います。
        リカバリバッチに対してワークフローパラメータにより以下のパラメータが設定できます。

        ・[キー]targetArchiveMonthStart  [値]アーカイブ年月(yyyyMM) [初期値]201001
        ・[キー]targetArchiveMonthEnd    [値]アーカイブ年月(yyyyMM) [初期値]201612
        ・[キー]errorHandlingBreakFlag   [値]true/false             [初期値]true


---------------------------------------------
■インストール方法
---------------------------------------------
0. インストールディレクトリに対して、必ずバックアップを行ってください。

1. 同梱フォルダ/「ApplicationRuntime」フォルダ内を、
   ApplicationRuntime Service のインストールディレクトリにコピーしてください。

   ※「ApplicationRuntime」フォルダとして、次の2つをご用意しています。
     ・ApplicationRuntime_x86_jdk1.6.0_45（32bit版の Java SE Development Kit 6u45 でコンパイル済み）
     ・ApplicationRuntime_x86_jdk1.7.0_80（32bit版の Java SE Development Kit 7u80 でコンパイル済み）
     お客様環境の java のバージョンに合わせてご利用ください。

   ※ApplicationRuntime Service を複数のマシンにインストールしている場合は、
     ApplicationRuntime Service をインストールしたすべてのマシンに対してコピーを行ってください。

2. 同梱フォルダ/「Server Manager」フォルダ内のリソースを、
   Server Manager のインストールディレクトリにコピーしてください。

3. intra-martを再起動します。

4. [ワークフロー]-[ワークフローシステム管理者]-[ワークフローパラメータ]より、
   ログイングループ毎の設定ファイル「param_group_%ログイングループID%.xml」
   タブに下記の記述を追加してください。

  -------------------------------------------------------------

<!-- IM-Workflow 過去案件印影リカバリバッチ設定 -->
<!--
    IM-Workflow 過去案件印影リカバリ開始年月(yyyymm)

    ※設定しない場合
      スキーマ内の最も古い年月アーカイブテーブルからリカバリが開始されます。
-->
<param>
    <param-name>targetArchiveMonthStart</param-name>
    <param-value>201001</param-value>
</param>

<!--
    IM-Workflow 過去案件印影リカバリ終了年月(yyyymm)

    ※設定しない場合
      スキーマ内の最も新しい年月のアーカイブテーブルまでリカバリが行われます。
-->
<param>
    <param-name>targetArchiveMonthEnd</param-name>
    <param-value>201612</param-value>
</param>

<!--
    例外制御途中終了フラグ
        true  : バッチ実行中に例外が発生した場合、バッチ処理を終了する(初期値)
        false : バッチ実行中に例外が発生した場合、バッチ処理を続行する

    ※設定しない場合
      trueとして実行されます。
-->
<param>
    <param-name>errorHandlingBreakFlag</param-name>
    <param-value>true</param-value>
</param>

  -------------------------------------------------------------

5. ログイングループ管理者のメニューから、
   [ログイングループ管理]-[バッチ管理]-[バッチ設定]画面を表示します。
   [新規登録]を押下し、以下の設定でバッチを作成してください。

     -------------------------------------------------------------
   
   有効/無効：スケジューリングして実行する場合は「有効」を選択してください。
              手動で実行する場合は「無効」を選択してください。
   バッチID：IMWArcStampRecovery
   バッチ名(日本語)：IM-Workflow 過去案件印影リカバリバッチ
   バッチ名(英語)：IM-Workflow past jobs stamp recovery batch
   バッチ名(中国語)：IM-Workflow 过去案件电子印章恢复批处理
   実行プログラミング言語：JAVA
   実行プログラミングパス：jp.co.intra_mart.system.workflow.batch.ArchiveStampRecoveryBatch
   実行時間：スケジューリングして実行する場合は任意の実行時間を指定してください。
             手動で実行する場合は初期設定から変更する必要はありません。
   
     -------------------------------------------------------------

6. IM-Workflow 過去案件印影リカバリバッチを手動で即時実行したい場合、
   ログイングループ管理者のメニューから、[ログイングループ管理]-[バッチ管理]-[バッチ設定]画面を表示し、
   5. で登録したバッチを実行してください。


---------------------------------------------
■アンインストール方法
---------------------------------------------
1. インストール時に作成したバッチ設定を削除してください。

2. ワークフローパラメータ設定ファイルから本設定情報を削除してください。

3. インストールしたファイルを削除してください。

-------------------------------------------------------------------------------
                                                    (株)NTTデータイントラマート