JP1/Integrated Management - Service Support システム構築・運用ガイド

[目次][用語][索引][前へ][次へ]

jssitemlist(案件一覧出力)

機能

案件一覧を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の値を指定できます。開始年月日には,終了年月日より前の値を指定してください。

開始日,および終了日について次に説明します。

開始年月日
この値で指定した日付以降に更新された案件を出力します。指定範囲内の値で存在しない日付が指定された場合は,実際に存在する日付まで進め,それ以降に更新された案件を出力します。例えば,開始日に2006/04/31を指定した場合は,2006/05/01以降に更新された案件を出力します。
終了年月日
この値で指定した日付以前に更新された案件を出力します。指定範囲内の値で存在しない日付が指定された場合は,実際に存在する日付まで戻り,それ以前に更新された案件を出力します。例えば,終了日に2006/06/31を指定した場合は,2006/06/30以前に更新された案件を出力します。

-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 出力データの種別
  • 拡張項目がない場合
    ITEMLIST
  • 拡張項目がある場合
    ITEMLIST△拡張項目あり
    (注 △は半角スペースを示す)
5 出力した案件のうち,ステータスが「クローズ」の案件の件数 Closed Item Number : 件数
(出力例)Closed Item Number : 45
6 出力した案件のうち,ステータスが「クローズ」以外の案件の件数 Unclosed Item Number : 件数
(出力例)Unclosed Item Number : 5
ボディ部
ボディ部では,jssitemhistoryコマンドと同じ内容が出力されます。出力される内容については,「jssitemhistory(案件履歴出力)」を参照してください。

注意事項

使用例

プロセスワークボード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