jssitemstore（案件保存）
機能
案件管理DBに登録されている案件のうち，指定された期間の「クローズ」の案件を保存案件として，案件保存DBのアクティブな保存エリアに保存します。案件保存DBに保存された案件は，案件管理DBに登録されている案件と同様に画面から参照できますが，編集や削除はできません。また，保存案件として案件保存DBに保存した案件は，元の管理案件として案件管理DBに戻せません。
形式
jssitemstore -ct 開始年月日-終了年月日 [-ch] [-q]
実行権限
Administrators権限
格納先フォルダ
JP1/SSパス\bin\
引数
-ct 開始年月日-終了年月日
特定の期間内に登録された案件のうち「クローズ」の案件を案件保存DBに保存するために，登録日の範囲をYYYY/MM/DD形式の文字列で指定します。開始年月日と終了年月日の間には「-」を挿入します。
開始年月日，および終了年月日には1970/01/01〜2107/01/01の値を指定できます。開始年月日には，終了年月日より前の値を指定してください。
開始年月日，および終了年月日について次に説明します。
- 開始年月日
-
この値で指定した日付以降に登録された案件のうち，「クローズ」の案件を案件保存DBに保存します。指定範囲内の値で存在しない日付が指定された場合は，エラーとなります。
- 終了年月日
-
この値で指定した日付以前に登録された案件のうち，「クローズ」の案件を案件保存DBに保存します。指定範囲内の値で存在しない日付が指定された場合は，エラーとなります。
例えば，「2013/01/01-2013/12/31」を指定した場合，案件の登録日時が「2013/01/01 00:00:00(.000)」から「2013/12/31 23:59:59(.999)」の範囲の案件が，案件保存DBへの保存対象となります。
-ch
指定した期間に登録された案件が，案件保存DBに保存できるかどうかを確認する場合に指定します。
-q
応答メッセージを表示しないで，案件の保存処理を続行する場合に指定します。-qオプションを指定しない場合は，処理を続行するかどうかを選択するメッセージが表示されます。
戻り値
|
戻り値 |
意味 |
|---|---|
|
0 |
正常終了 |
|
1 |
異常終了 |
案件の保存条件
案件保存DBに案件を保存する際，指定した期間に登録された案件の中にクローズしていない案件や削除待ちの案件が存在する場合は，案件保存DBに保存できません。また，案件が登録されているシステムやプロセスワークボードの状態によっても，案件保存DBに保存できません。案件の状態と案件保存DBへの保存可否を，次の表に示します。
|
項番 |
案件が登録されているシステムの状態 |
案件が登録されているプロセスワークボードの状態 |
案件の状態 |
案件のステータス |
案件保存DBへの保存可否 |
|---|---|---|---|---|---|
|
1 |
削除待ち |
削除待ち |
− |
− |
×※1 |
|
2 |
運用中 |
削除待ち |
− |
− |
×※1 |
|
3 |
準備中 |
− |
− |
×※2 |
|
|
4 |
停止中 |
削除待ち |
− |
×※1 |
|
|
5 |
− |
クローズ以外 |
×※1 |
||
|
6 |
削除待ち以外 |
クローズ |
○※3 |
||
|
7 |
運用中 |
削除待ち |
− |
×※1 |
|
|
8 |
− |
クローズ以外 |
×※1 |
||
|
9 |
削除待ち以外 |
クローズ |
○※3 |
- （凡例）
-
○：案件保存DBに保存する
×：案件保存DBに保存しない
−：状態に依存しない
- 注※1
-
jssitemstoreコマンドが，エラーで終了します。
- 注※2
-
案件が登録されていないため，案件を保存できません。
- 注※3
-
案件の編集状態に関係なく，案件DBに保存します。案件保存DBに保存するすると，編集できなくなります。
実行時の前提条件
-
コマンド実行時のサービスの状態については，「12. コマンド」の「コマンド実行時のサービスの状態」を参照してください。
-
jssitemstoreコマンドを実行する前に，案件保存DBをセットアップしてください。案件保存DBのセットアップについては，「11.2.10 案件保存DBの構築」を参照してください。
注意事項
-
jssitemstoreコマンドの実行前にバックアップを取得してください。バックアップについては，「11.2.13 案件保存DBに案件を保存」を参照してください。
-
案件保存DBに保存した案件は，管理案件に戻せません。このため，編集が完了した案件を保存対象にしてください。保存案件を編集したい場合は，該当する案件を流用して新規案件として再度作成してください。
-
jssitemstoreコマンドを実行すると，案件管理DBから対象の案件が削除されるため，案件管理DBの空き領域が断片化されます。このため，案件管理DBを再編成することをお勧めします。案件管理DBの再編成については，「12. コマンド」の「jssdbrorg.bat（案件管理DB再編成）」を参照してください。
-
jssitemstoreコマンドの実行時にKNAB24002-Eのエラーメッセージ（詳細コード：-756）が出力され，データベース容量不足で異常終了した場合，案件保存DBを拡張したあと，同じ引数を指定してコマンドを再実行してください。案件保存DBの拡張が上限に達している場合は，案件保存DBの保存エリアを切り替えてください。
案件保存DBの拡張については，「11.2.12 案件保存DBの拡張」を，案件保存DBの保存エリアの切り替えについては，「11.2.11 案件保存DBの保存先の切り替え」を参照してください。
-
jssitemstoreコマンドの実行に失敗した場合，保存に失敗した案件については，履歴情報と最新情報が分かれて保存されるため，このあとに保存案件を一括で削除すると，履歴情報だけが削除されるおそれがあります。この場合，同じ引数を指定してjssitemstoreコマンドを再実行することをお勧めします。
-
jssitemstoreコマンドとjssdbbackup.batコマンドの実行が重ならないようにしてください。コマンドの実行が重なった場合，あとから実行したコマンドがエラー終了します。
-
jssitemstoreコマンドの実行中に［Ctrl］+［C］キーなどでコマンドの実行を打ち切った場合，コマンドの処理に失敗するおそれがあります。このため，コマンドの実行中に［Ctrl］+［C］キーなどで実行を打ち切らないでください。
-
jssitemstoreコマンドの実行中に，保存対象の案件，および保存対象の案件が登録されているシステムやプロセスワークボードの状態を変更しないでください。案件を保存できない状態に変更した場合，コマンドがエラー終了します。
-
jssitemstoreコマンドの実行中に，JP1/Service Supportサービスを操作しないでください。操作した場合，コマンドの処理に失敗するおそれがあります。
-
jssitemstoreコマンドは，二つ以上同時に実行できません。
-
jssitemstoreコマンドの実行結果は，ログファイルに出力して確認できます。詳細については，「13. 定義ファイル」の「ユーザーログ定義ファイル（jp1itemstore.conf）」を参照してください。
使用例
- 使用例1
-
登録日が「2013/01/01〜2013/12/31」の案件を案件保存DBに保存する場合：
jssitemstore -ct 2013/01/01-2013/12/31
- 使用例2
-
登録日が「2013/01/01〜2013/12/31」の案件を案件保存DBに保存できるかどうか確認する場合：
jssitemstore -ct 2013/01/01-2013/12/31 -ch