JP1/Integrated Management - Service Support システム構築・運用ガイド
機能
案件一覧をCSVファイルで出力します。コマンドの実行中に処理を中止すると,中止する直前までの案件一覧を出力します。
このコマンドの実行中は,JP1/Service Support - DB Serverが起動している必要があります。
形式
jssitemlist -o 案件詳細情報ファイル名 [-b プロセスワークボードID] [-r 開始年月日-終了年月日] [-e] [-a] [-f] [-d]
実行権限
Administrators権限
格納先フォルダ
IM-SSパス\bin\
引数
-o 案件詳細情報ファイル名
案件管理DBの案件一覧を出力する案件詳細情報ファイル名を255バイト以内で指定します。ファイル名は絶対パス,または相対パスで指定できますが,相対パスで指定した場合も,絶対パスに変換したあとの文字列が255バイト以下になるように指定してください。また,ファイル名に「‐」で始まる文字列は指定できません。案件詳細情報ファイルには,ステータスが「クローズ」以外の案件一覧が出力されます。
-b プロセスワークボードID
案件一覧を出力するプロセスワークボードを特定したい場合,プロセスワークボードのIDを64バイト以下の半角英数字で指定します。このオプションを省略すると,案件管理DB内のすべての案件を出力します。
-r 開始年月日-終了年月日
特定の期間内に更新された案件を出力するために,更新日の範囲をYYYY/MM/DD形式の文字列で指定します。開始年月日と終了年月日の間には「-」を挿入します。
開始年月日,および終了年月日には1970/01/02〜2036/12/31の値を指定できます。開始年月日には,終了年月日より前の値を指定してください。
開始日,および終了日について次に説明します。
-e
このオプションを指定すると,出力対象にユーザーがカスタマイズした項目が含まれます(JP1/IM - Service Supportのバージョン08-50以降の形式)。このオプションを省略すると,出力対象にはユーザーがカスタマイズした項目が含まれません(JP1/IM - Service Supportのバージョン08-50より以前の形式)。
-a
「クローズ」も含めたすべてのステータスの案件を出力する場合に指定します。このオプションを省略すると,ステータスが「クローズ」以外の案件を出力します。
-f
ファイルを上書きする場合に指定します。
-d
削除待ち状態になっている案件だけを出力する場合に指定します。このオプションが指定されたとき,案件詳細情報ファイルボディ部の「編集者」の項目は,「削除者」に変更され,案件を削除待ち状態にしたユーザーが確認できます。同様に,「更新日時」の項目では,案件を削除待ち状態にした日時が確認できます。ただし,削除待ち状態の対象システムやプロセスワークボードに登録されている案件は出力に含まれません。また,ステータスが「クローズ」の案件を含める場合は,-aオプションをあわせて指定してください。
戻り値
戻り値 | 意味 |
---|---|
0 | 正常終了 |
1 | 異常終了 |
案件詳細情報ファイルの内容
案件詳細情報ファイルには次のような形式でデータが出力されます。
出力される内容について説明します。
出力順 | 項目の内容 | 出力する値 |
---|---|---|
1 | 製品名 | JP1/IM-Service Support |
2 | 出力されるファイルのバージョン | 出力されるファイルのバージョンを6けたの文字列で表す |
3 | 案件詳細情報ファイルの文字コード | MS932 |
4 | 出力データの種別 |
|
5 | 出力した案件のうち,ステータスが「クローズ」の案件の件数 | Closed Item Number : 件数 (出力例)Closed Item Number : 45 |
6 | 出力した案件のうち,ステータスが「クローズ」以外の案件の件数 | Unclosed Item Number : 件数 (出力例)Unclosed Item Number : 5 |
注意事項
使用例
プロセスワークボード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 |
All Rights Reserved. Copyright (C) 2007, 2008, Hitachi, Ltd.