jssitemlist(案件一覧出力)
機能
JP1/Service Supportに登録されている案件の一覧をCSVファイルで出力します。コマンドの実行中に処理を中止すると,中止する直前までの案件一覧を出力します。
形式
jssitemlist -o 案件詳細情報ファイル名 [-b プロセスワークボードID [-pi プロセスワークボード内通し番号]] [-ct 開始年月日-終了年月日 | -r 開始年月日-終了年月日] [-e] [-a] [-f] [-d]
実行権限
Administrators権限
格納先フォルダ
JP1/SSパス\bin\
引数
-o 案件詳細情報ファイル名
JP1/Service Supportに登録されている案件の案件一覧を出力する案件詳細情報ファイル名を255バイト以内で指定します。ファイル名は絶対パス,または相対パスで指定できますが,相対パスで指定した場合も,絶対パスに変換したあとの文字列が255バイト以下になるように指定してください。また,ファイル名に「-」で始まる文字列は指定できません。なお,案件詳細情報ファイル名が全角文字を含む場合,全角文字は2バイトに換算されます。
案件詳細情報ファイルには,ステータスが「クローズ」以外の案件一覧が出力されます。ステータスが「クローズ」の案件を含めた案件一覧を出力したい場合は,-aオプションを指定してください。
-b プロセスワークボードID
案件一覧を出力するプロセスワークボードを特定したい場合,プロセスワークボードのIDを64バイト以下の半角英数字で指定します。このオプションを省略すると,案件管理DB内のすべての案件を出力します。
-piプロセスワークボード内通し番号
-bオプションで指定したプロセスワークボードから,出力したい案件のプロセスワークボード内通し番号を指定します。
このオプションを指定する場合は,-bオプションを必ず指定してください。-piオプションを省略した場合は,-bオプションで指定したプロセスワークボードの案件一覧が出力されます。
プロセスワークボード内通し番号については,「3.2.2(1) 案件一覧」を参照してください。
-ct 開始年月日-終了年月日
特定の期間内に登録された案件を出力するために,登録日の範囲をYYYY/MM/DD形式の文字列で指定します。開始年月日と終了年月日の間には「-」を挿入します。
開始年月日,および終了年月日には1970/01/02〜2036/12/31の値を指定できます。開始年月日には,終了年月日より前の値を指定してください。
開始年月日,および終了年月日について次に説明します。
- 開始年月日
-
この値で指定した日付以降に登録された案件を出力します。指定範囲内の値で存在しない日付が指定された場合は,実際に存在する日付まで進め,それ以降に更新された案件を出力します。
- 終了年月日
-
この値で指定した日付以前に登録された案件を出力します。指定範囲内の値で存在しない日付が指定された場合は,実際に存在する日付まで戻り,それ以前に登録された案件を出力します。
例えば,「2013/04/01-2013/04/07」を指定した場合,案件の登録日時が「2013/04/01 00:00:00(.000)」から「2013/04/07 23:59:59(.999)」の範囲の案件が出力対象となります。
-ctおよび-rオプションを省略した場合は,すべての案件が出力対象となります。
-r 開始年月日-終了年月日
特定の期間内に更新された案件を出力するために,更新日の範囲をYYYY/MM/DD形式の文字列で指定します。開始年月日と終了年月日の間には「-」を挿入します。
開始年月日,および終了年月日には1970/01/02〜2036/12/31の値を指定できます。開始年月日には,終了年月日より前の値を指定してください。
開始年月日,および終了年月日について次に説明します。
- 開始年月日
-
この値で指定した日付以降に更新された案件を出力します。指定範囲内の値で存在しない日付が指定された場合は,実際に存在する日付まで進め,それ以降に更新された案件を出力します。
- 終了年月日
-
この値で指定した日付以前に更新された案件を出力します。指定範囲内の値で存在しない日付が指定された場合は,実際に存在する日付まで戻り,それ以前に更新された案件を出力します。
例えば,「2013/04/01-2013/04/07」を指定した場合,案件の更新日時が「2013/04/01 00:00:00(.000)」から「2013/04/07 23:59:59(.999)」の範囲の案件が出力対象となります。
-ctおよび-rオプションを省略した場合は,すべての案件が出力対象となります。
-e
このオプションを指定すると,出力対象にユーザーがカスタマイズした項目が含まれます。このオプションを省略すると,出力対象にはユーザーがカスタマイズした項目が含まれません。
-a
「クローズ」も含めたすべてのステータスの案件を出力する場合に指定します。このオプションを省略すると,ステータスが「クローズ」以外の案件を出力します。
-f
ファイルを上書きする場合に指定します。
-d
削除待ち状態になっている案件だけを出力する場合に指定します。このオプションが指定されたとき,案件詳細情報ファイルボディ部の「編集者」の項目は,「削除者」に変更され,案件を削除待ち状態にしたユーザーが確認できます。同様に,「更新日時」の項目では,案件を削除待ち状態にした日時が確認できます。ただし,削除待ち状態の対象システムやプロセスワークボードに登録されている案件は出力に含まれません。また,ステータスが「クローズ」の案件を含める場合は,-aオプションをあわせて指定してください。
戻り値
戻り値 |
意味 |
---|---|
0 |
正常終了 |
1 |
異常終了 |
案件詳細情報ファイルの内容
案件詳細情報ファイルには次のような形式でデータが出力されます。
出力される内容について説明します。
- ヘッダー部
-
出力順
項目の内容
出力する値
1
製品名
JP1/Service Support
2
出力されるファイルのバージョン
出力されるファイルのバージョンを6けたの文字列で表す
3
案件詳細情報ファイルの文字コード
出力されるファイルの文字コード
4
出力データの種別
-
拡張項目がない場合
ITEMLIST
-
拡張項目がある場合
ITEMLIST△拡張項目あり
(注 △は半角スペースを示す)
5
出力した案件のうち,ステータスが「クローズ」の案件の件数
Closed Item Number : 件数
(出力例)Closed Item Number : 45
6
出力した案件のうち,ステータスが「クローズ」以外の案件の件数
Unclosed Item Number : 件数
(出力例)Unclosed Item Number : 5
-
- ボディ部
-
ボディ部では,jssitemhistoryコマンドと同じ内容が出力されます。出力される内容については,「jssitemhistory(案件履歴出力)」を参照してください。
実行時の前提条件
-
コマンド実行時のサービスの状態については,「12. コマンド」の「コマンド実行時のサービスの状態」を参照してください。
-
jssitemlistコマンドの実行中に次のコマンドを同時実行すると,jssitemlistコマンドの実行に失敗するおそれがあるため,同時実行しないでください。
-
jssformdefコマンド
-
jssdelrecコマンド
-
jssdbinit.batコマンド
-
jssdbrorg.batコマンド
-
jssdbreclaim.batコマンド
-
jssdbbackup.batコマンド
-
jssdbrecovery.batコマンド
-
jssitemstoreコマンド
-
jssitemstoredbexpand.batコマンド
-
jssitemstoredbsetup.batコマンド
-
jssrefaclsetupコマンド
-
jssstoreitemdel.batコマンド
-
-
-fオプションを指定したjssitemlistコマンドを複数実行した場合,出力先ファイルのファイル名にはそれぞれ異なるファイル名を指定してください。同じファイル名を指定した場合,案件詳細情報ファイルの内容が不完全になることがあります。
注意事項
-
jssitemlistコマンドの実行中に[Ctrl]+[C]キーなどでコマンドの実行を打ち切った場合,案件一覧の出力に失敗するおそれがあります。このため,コマンドの実行中に[Ctrl]+[C]キーなどで実行を打ち切らないでください。もし実行を打ち切った場合は,しばらく時間を置いてからコマンドを再実行してください。
-
出力する案件情報の中に,選択肢コードの値に対応した文字列が存在しない場合,ファイルには選択肢コードの値がそのまま出力されます。
-
案件詳細情報ファイルの「1970/01/01 23:59:59」以前,または「2037/01/01 00:00:00」以降の日時データは正しく出力されない場合があります。
-
jssitemlistコマンドで一度に出力できる案件数は最大65,530件です。65,531件以上の案件の情報を出力したい場合は,-bオプションまたは-rオプションで案件数を絞り込み,jssitemlistコマンドを複数回実行してください。
-
削除ユーザーが含まれている案件情報をjssitemlistコマンドで出力した場合,出力した案件情報のユーザーID出力個所には,削除ユーザーは出力されません。
-
jssitemlistコマンドで大量の案件情報を出力しようとすると,データベースの作業領域が不足し,「KNAB24002-E JP1/Service Support のデータベースでエラーが発生しました。(-713)」のメッセージが出力されるおそれがあります。その場合には,開始年月日,終了年月日などを指定し,案件情報を絞り込んで,コマンドを実行してください。
-
出力される情報に,UTF-8にはマッピングされていて,Shift-JISにはマッピングされていない文字を含む場合,出力されるCSVファイルの該当文字は「?」に変換されます。
使用例
プロセスワークボードIDが「honsyasystem」の案件のうち,2007年4月1日〜2007年7月31日に登録された案件の詳細情報を,ファイルを上書きして案件詳細情報ファイル(c:\anken\ankeninfo.csv)に出力する場合の指定例を次に示します。
jssitemlist -o c:\anken\ankeninfo.csv -b honsyasystem -r 2007/04/01-2007/07/31 -a -f