///////////////////////////////////////////////////////////////////////////////
//  intra-mart Accel Platform 2012 Autumn ～                                 //
//  intra-mart Accel Platform 2015 Winter 対応版                             //
//  過去案件印影リカバリーモジュール                                         //
//                                                                           //
//  セットアップと注意点                                                     //
//                                                               2016/02/01  //
///////////////////////////////////////////////////////////////////////////////

---------------------------------------------
■前提条件
---------------------------------------------
1. 「intra-mart Accel Platform 2012 Autumn」～「intra-mart Accel Platform 2015 Winter」が正常に動作していること。

---------------------------------------------
■注意事項
---------------------------------------------
1. 本モジュールをインストール後、intra-mart Accel Platform 2015 Winter 以降にバージョンアップする際は、
   本モジュールを必ずアンインストールしてください。

2. その他、intra-mart Accel Platform の制限事項に準じます。

---------------------------------------------
■2016/02/01 ... intra-mart Accel Platform 2012 Autumn ～ intra-mart Accel Platform 2015 Winter 対応版  
---------------------------------------------
各項目のステータスは以下のとおりです。
【修正】・・・バグなどの修正
【改善】・・・機能の仕様改善やチューニング等
【変更】・・・仕様変更
【追加】・・・機能追加など

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

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

        上記の不具合に対しては、intra-mart Accel Platform 2015 Winter で修正されたため、
        intra-mart Accel Platform 2015 Winter 以降にアップデートすることで解消することができます。
        ただし、本モジュールを適用前に2015 Winterにアップデートした場合、2015 Winter以前で生成された
        印影データが不正な状態になっている可能性があります。
        2015 Winterで当該の事象を確認した場合は、本モジュールを提供して、リカバリを実施してください。

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

        1. リカバリ対象の過去案件の範囲指定（申請基準日）
           ・[キー]targetArchiveMonthStart（処理開始年月）  [値]アーカイブ年月(yyyyMM) [初期値]201001
           ・[キー]targetArchiveMonthEnd（処理終了年月）    [値]アーカイブ年月(yyyyMM) [初期値]201612

        2. リカバリ処理中にエラーが発生した場合に処理を中止するかどうかの指定
           ・[キー]errorHandlingBreakFlag   [値]true(処理を中止)/false(中止しない)  [初期値]true
           リカバリ処理は案件単位でトランザクションを設定します。そのため、処理中にエラーが発生した場合
           エラーが発生した案件のみロールバックされます。

        処理結果はジョブネットモニタ画面に表示されます。

---------------------------------------------
■インストール方法
---------------------------------------------
1. IM-Jugglingを起動します。

2. 既存のプロジェクト（juggling.im）ファイルを開きます。

3. 「ユーザモジュール」タブを選択し、右上にある「+」アイコンをクリックします。

4. 同梱フォルダの「im_workflow_8.0_mod_archive_stamp_recovery-8.0.0.imm」を追加します。

5. 通常通りWARファイルの出力、およびデプロイを行います。

6. intra-martを起動します。

7. システム管理者でログインします。

8. [システム環境構築]-[テナント環境セットアップ]を選択し、テナント環境セットアップ画面を表示します。

9. 「テナント環境セットアップ」ボタンが表示されている場合、「テナント環境セットアップ」ボタンをクリックし、
   テナント環境セットアップを行います。
   「テナント環境セットアップ」ボタンが表示されていない場合、操作は不要です。

   ※テナントが複数ある場合、すべてのテナントでテナント環境セットアップを行ってください。

10. テナント管理者でログインします。

11. ジョブネット設定のジョブネット一覧から[テナントマスタ]-[インポート]-[ジョブインポート]を選択し、
   実行パラメータに以下を追加し、実行します。

     [キー]file  [値]job-scheduler_archive_stamp_recovery.xml
   
     ジョブインポートにより、ジョブとジョブネットのそれぞれのカテゴリ「IM-Workflow」に以下が追加されます。
     ・ジョブ：過去案件印影リカバリジョブ
     ・ジョブネット：過去案件印影リカバリジョブネット

12. ジョブネット一覧[IM-Workflow]-[過去案件印影リカバリジョブネット]を実行してください。
   リカバリ対象の過去案件の範囲を設定する場合は、パラメータ[キー]targetArchiveMonthStart、
   及び[キー]targetArchiveMonthEndを変更してください。

---------------------------------------------
■アンインストール方法
---------------------------------------------
1. インストール時にインポートしたジョブ設定、ジョブネット設定を削除します。

2. パブリックストレージのルートパス直下に配置されている job-scheduler_archive_stamp_recovery.xml ファイルを削除します。

   ※テナントが複数ある場合、すべてのテナントに対して作業を行ってください。

3. IM-Jugglingを起動します。

4. 既存のプロジェクト（juggling.im）ファイルを開きます。

5. 「ユーザモジュール」タブを選択します。

6. 一覧に表示されている「im_workflow_8.0_mod_archive_stamp_recovery-8.0.0.imm」を選択し、
   右上にある「×」アイコンをクリックします。

7. 以降は、通常通りWARファイルの出力、およびデプロイを行います。


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