=================================================================================

  PIMSYNC 2.1

                                                  DBItemDeleteTool Patch README


                            Copyright(c) 2015 APPRESSO K.K. All rights reserved.

                                         ドキュメント・リリース日：2015年7月22日

=================================================================================

---------------------------------------------------------------------------------
■ 目次
---------------------------------------------------------------------------------

 0. はじめに
 1. 中間データ削除ツールとは
 2. 中間データ削除ツールの実行方法
 3. ログについて
 4. 削除対象外のアイテム
 5. 仕様制限
 6. ツールの構成
 7. モジュールの構成
 8. お問い合わせ 


---------------------------------------------------------------------------------
■ 0. はじめに
---------------------------------------------------------------------------------

・表記について

  - PIMSYNC の画面に表示されるメニュー名・タグ名・プロパティ項目名および値、
    ボタン名は [] で囲んで表しています。
    また、それ以外の機能名や画面のタイトル、名称のないものは「」で囲んで前者と
    区別しています。 

  - 「$PIMSYNC_HOME」は PIMSYNC をインストールしたディレクトリを表します。
    デフォルトでは、「C:\Program Files\PIMSYNC」となります。

  - < と > で囲まれた名称は、可変であることを表します。
    例：$PIMSYNC_HOME/log/<同期タスク名>/<ユーザー名>/synctask.log


---------------------------------------------------------------------------------
■ 1. 中間データ削除ツールとは
---------------------------------------------------------------------------------

本ツールは 、スケジュールを同期する際に PIMSYNC が保持するデータの削除が
できる「中間データ削除ツール」です。スケジュールの開始時刻が、本ツールの
実行時に指定した日付以前 (指定した日付も含む) の中間データを削除します。

データベース (PostgreSQL) のデータ容量の増加、またはデータベースのプロセス
(postgresql.exe) のメモリ使用量が増加し、システムに負荷がかかっている場合、
本ツールを実行することで解消できます。

中間データ削除ツールをご使用の際には、本ドキュメントをよくお読みの上で、
実行してください。


---------------------------------------------------------------------------------
■ 2. 中間データ削除ツールの実行方法
---------------------------------------------------------------------------------

1. PIMSYNC サーバーを停止します。

2. サーバーモジュールにパッチを適用します。DBItemDeleteTool ディレクトリ以下の
   各ディレクトリを $PIMSYNC_HOME ディレクトリに上書きコピーします。

3. コマンドプロンプトを起動して、$PIMSYNC_HOME\bin ディレクトリに移動します。

4. 以下のように DBItemDeleteTool.bat を実行します。

   例: 2015 年 7 月 2 日以前の同期済みアイテムを削除する場合

       $PIMSYNC_HOME\bin> DBItemDeleteTool.bat 20150702


---------------------------------------------------------------------------------
■ 3. ログについて
---------------------------------------------------------------------------------

中間データ削除ツールのコマンド実行時のログファイル「db_delete.log」は 
$PIMSYNC_HOME\log ディレクトリに出力されます。

ログファイル「db_delete.log」のローテーションファイルサイズまたは
ローテーションファイル数を設定する場合は、以下の対象ファイルにキーを追加し、
値を設定してください。

  【対象ファイル】
    pim.properties

  【配置場所】
    $PIMSYNC_HOME/config

  【キー】
    - pim.db.deletelog.maxfilesize
    - pim.db.deletelog.maxbackupindex

  【キーの説明】
    - pim.db.deletelog.maxfilesize
      ローテーションファイルサイズ
    - pim.db.deletelog.maxbackupindex
      ローテーションファイル数

  【デフォルト値】
    - pim.db.deletelog.maxfilesize    : 2097152
    - pim.db.deletelog.maxbackupindex : 10

標準出力とログファイルには、同期タスクおよびユーザーごとに削除したレコードの
件数が表示されます。


---------------------------------------------------------------------------------
■ 4. 削除対象外のアイテム
---------------------------------------------------------------------------------

以下のアイテムは削除対象外になります。

 - ToDo
 - 繰り返しスケジュール（※）

 （※）繰り返しスケジュールの例外日は、各アダプタの仕様により以下のように
       なります。
       （繰り返しスケジュールの例外日の仕様については、ヘルプの各アダプタの
       「仕様制限」を参照してください。）

       - マスタースケジュールとの紐付けを持つ例外日     → 削除しない
       - マスタースケジュールとの紐付けを持たない例外日 → 削除する


---------------------------------------------------------------------------------
■ 5. 仕様制限
---------------------------------------------------------------------------------

・中間データ削除ツールで削除したスケジュールを同期元で更新して同期した場合、
  同期先でスケジュールの重複が発生します。

・中間データ削除ツールで削除したスケジュールを同期元で削除して同期した場合、
  同期先のスケジュールは削除されません。

・以下の条件をすべて満たすと、スケジュールを新規作成または更新した
  アプリケーションにスケジュールの重複が発生する場合があります。

  - 双方向同期の場合
  - スケジュールを新規作成または更新して同期した後、次回の同期処理前に
    中間データ削除ツールで新規作成または更新したスケジュールの中間データを
    削除した場合

・中間データ削除ツールを実行中に停止しても、内部データの整合性は保たれるため、
  以降の同期処理は正常に実施されます。


---------------------------------------------------------------------------------
■ 6. ツールの構成
---------------------------------------------------------------------------------

└─DBItemDeleteTool
    ├─bin
    │      DBItemDeleteTool.bat
    │      
    └─lib
            dbdelete_tool.jar


---------------------------------------------------------------------------------
■ 7. モジュールの構成
---------------------------------------------------------------------------------

ファイル名                                                       サイズ(byte)
---------------------------------------------------------------------------------
dbdelete_tool.jar                                                      14,669


---------------------------------------------------------------------------------
■ 8. お問い合わせ
---------------------------------------------------------------------------------

〒112-0014 東京都文京区関口1丁目20番10号 住友不動産江戸川橋駅前ビル2階
株式会社アプレッソ
電話：03-4321-1111 (代)
FAX ：03-4321-1112
E-mail：info@appresso.com
