jssitemexportEx(案件情報拡張エクスポート)
- 〈このページの構成〉
機能
JP1/Service Supportに登録されている案件情報および履歴情報を,CSVファイルで出力します。また,案件に任意のファイルを添付している場合は,添付ファイルも併せて出力します。なお,コマンドの実行中に処理を中止すると,中止する直前までの案件情報を出力します。このコマンドには,jssitemlist(案件一覧出力)コマンドおよびjssitemhistory(案件履歴出力)コマンドの機能が含まれています。
形式
jssitemexportEx -o 出力先フォルダ名 {-ALL | -s -id システムID | -p -id プロセスワークボードID [-pi プロセスワークボード内通し番号]} {-ct 開始年月日-終了年月日 | -et 開始年月日-終了年月日} [-a] [-f] [-m CSVカラム名マッピングファイル名]
実行権限
Administrators権限
格納先フォルダ
JP1/SSパス\bin\
引数
-o 出力先フォルダ名
出力先フォルダ名には,案件情報を出力するフォルダ名を80バイト以下で指定します。このとき,半角文字を1バイト,全角文字を2バイトとして換算します。フォルダ名は,絶対パスまたは相対パスで指定できますが,相対パスで指定した場合も,絶対パスに変換したあとの文字列が80バイト以下になるように指定してください。また,指定したフォルダ名が存在しない場合は,指定したフォルダ名のフォルダを作成します。
指定した出力先フォルダには,次に示すファイルが出力されます。
-
Item_PWB_プロセスワークボードID.csv
案件情報を出力したCSVファイル(案件情報CSVファイル)です。
プロセスワークボード単位に,履歴情報を含めた案件情報が出力されます。対象となる案件が0件の場合でも,ファイルが出力されます。なお,-s -idオプションでシステムを選択した場合でも,プロセスワークボード単位にファイルが出力されます。
-
ItemRefInfo_PWB_プロセスワークボードID.csv
関連情報を出力したCSVファイル(関連情報CSVファイル)です。
プロセスワークボード単位に,関連情報が出力されます。対象となる案件が0件の場合でも,ファイルが出力されます。なお,-s -idオプションでシステムを選択した場合でも,プロセスワークボード単位にファイルが出力されます。
-
添付ファイル
案件に添付されているファイルです。
プロセスワークボードのプロセスワークボード内通し番号単位に出力されます。
添付ファイル名の先頭には,添付ファイルIDが付与されます。案件情報CSVファイルには,出力された添付ファイルの添付ファイルIDと添付ファイル名が出力されるため,添付ファイルIDを基に,添付ファイルを特定できます。なお,添付ファイルが出力されるプロセスワークボード内通し番号フォルダ名は,プロセスワークボード内通し番号が5けた未満の場合はゼロパディングされます。
案件情報CSVファイル,関連情報CSVファイル,および添付ファイルの出力先の例を,次に示します。
出力先フォルダ名 ├ system01 システムID │ ├ Item_PWB_pwb001.csv 案件情報CSVファイル │ ├ ItemRefInfo_PWB_pwb001.csv 関連情報CSVファイル │ └ pwb001 プロセスワークボードID │ └ 000001 プロセスワークボード内通し番号 │ ├ 000001_添付ファイル01.txt 添付ファイル1 │ ├ 000002_添付ファイル02.txt 添付ファイル2 │ └ 000003_添付ファイル03.txt 添付ファイル3 ├ system02 システムID │ ├ Item_PWB_pwb002.csv │ ├ ItemRefInfo_PWB_pwb002.csv : :
-ALL
すべてのシステムを対象として,案件情報を出力する場合に指定します。この場合,マスターシステムも対象になります。
-s id システムID
システムを選択して,案件情報を出力する場合に指定します。システムIDは,1バイト以上64バイト以下の半角英数字で指定します。
-p -id プロセスワークボードID
プロセスワークボードを選択して,案件情報を出力する場合に指定します。プロセスワークボードIDは,1バイト以上64バイト以下の半角英数字で指定します。
-pi プロセスワークボード内通し番号
選択したプロセスワークボードから一つの案件を選択して,案件情報を出力する場合に指定します。プロセスワークボード内通し番号については,「3.2.2(1) 案件一覧」を参照してください。
-ct 開始年月日-終了年月日
特定の期間内に作成された案件情報を出力するために,作成日の範囲をYYYY/MM/DD形式の文字列で指定します。開始年月日と終了年月日の間には,「-」を指定します。
開始年月日および終了年月日には,1970/01/01〜2107/01/01の値を指定できます。開始年月日には,終了年月日より前の値を指定してください。
開始年月日および終了年月日について,次に説明します。
- 開始年月日
-
この値で指定した日付以降に作成された案件情報を出力します。指定範囲内の値で存在しない日付が指定された場合は,エラーとなります。
- 終了年月日
-
この値で指定した日付以前に作成された案件情報を出力します。指定範囲内の値で存在しない日付が指定された場合は,エラーとなります。
例えば,「2013/04/01-2013/04/07」を指定した場合,案件の登録日時が「2013/04/01 00:00:00(.000)」から「2013/04/07 23:59:59(.999)」の範囲の案件が,出力の対象になります。
-et 開始年月日-終了年月日
特定の期間内に更新された案件情報を出力するために,更新日の範囲をYYYY/MM/DD形式の文字列で指定します。開始年月日と終了年月日の間には,「-」を指定します。
開始年月日および終了年月日には,1970/01/01〜2107/01/01の値を指定できます。開始年月日には,終了年月日より前の値を指定してください。
開始年月日および終了年月日について,次に説明します。
- 開始年月日
-
この値で指定した日付以降に更新された案件情報を出力します。指定範囲内の値で存在しない日付が指定された場合は,エラーとなります。
- 終了年月日
-
この値で指定した日付以前に更新された案件情報を出力します。指定範囲内の値で存在しない日付が指定された場合は,エラーとなります。
例えば,「2013/04/01-2013/04/07」を指定した場合,案件の更新日時が「2013/04/01 00:00:00(.000)」から「2013/04/07 23:59:59(.999)」の範囲の案件が,出力の対象になります。
-a
すべてのステータスの案件情報を出力する場合に指定します。-aオプションを省略した場合は,ステータスが「クローズ」の案件情報が出力されます。
-f
ファイルを上書きする場合に指定します。出力先フォルダにファイルがないときは,ファイルが作成されます。
-m CSVカラム名マッピングファイル名
ユーザーが定義したCSVカラム名マッピングファイルを使用する場合,CSVカラム名マッピングファイル名を255バイト以下の文字列で指定します。このとき,半角文字を1バイト,全角文字を2バイトで換算します。CSVカラム名マッピングファイル名は,絶対パスまたは相対パスで指定できますが,相対パスで指定した場合も,絶対パスに変換したあとの文字列が255バイト以下になるように指定してください。CSVカラム名マッピングファイルについては,「13. 定義ファイル」の「CSVカラム名マッピングファイル(jp1imss_itemcsv_columnmap.conf)」を参照してください。
戻り値
戻り値 |
意味 |
---|---|
0 |
正常終了 |
1 |
不完全なCSVファイルを出力した。 |
2 |
異常終了 |
案件情報CSVファイルの内容
案件情報CSVファイルには,次のような形式でデータが出力されます。
なお,案件情報CSVファイルに出力されるボディ部の1行目には,属性名が出力されます。
出力される内容について説明します。
- ヘッダー部
-
出力順
項目の内容
出力する値
1
製品名
JP1/Service Support
2
出力されるファイルのバージョン
出力されるファイルのバージョンを6けたの文字列で表す
3
案件情報CSVファイルの文字コード
出力されるファイルの文字コード
4
出力データの種別
ITEMEXPORTEX_ITEM
- ボディ部
-
出力順
項目名※1
説明
案件フォームとの対応
1
対象システムのシステムID
案件が登録されているシステムのID
−
2
対象システムのシステム名
案件が登録されているシステムの名称
JIMSD_FORM_SYSTEM
3
プロセス名
案件が登録されているプロセスワークボードのプロセス表示名
JIMSD_FORM_PROCESS
4
プロセスワークボードID
案件が登録されているプロセスワークボードのID
JIMSD_FORM_ITEMID※2
5
プロセスワークボード内通し番号
案件のプロセスワークボード内通し番号
6
バージョン番号
案件の履歴を表す番号
−
7
関連案件通し番号
案件の関連案件通し番号
JIMSD_FORM_PROCESSITEMID※2
8
エスカレーション番号
案件のエスカレーション回数を表す番号
9
案件フォームID
案件が使用している案件フォームを表すID
−
10
案件フォームのバージョン番号
案件が使用している案件フォームの履歴を表す番号
−
11
案件ステータスID
案件のステータスを表すID
−
12
案件ステータス名
案件のステータスの名称
JIMSD_FORM_ITEMSTATUSID
13
編集状態
jssitemexportExコマンド実行時に該当する案件が編集中であるかを表す項目
−
14
データ種別
案件の状態を表す項目
−
15
エスカレーション元プロセスワークボードID
エスカレーションされた案件の場合,エスカレーション元となったプロセスワークボードのID
−
16
エスカレーション元関連案件通し番号
エスカレーションされた案件の場合,エスカレーション元となった案件の関連案件通し番号
−
17
エスカレーション元エスカレーション番号
エスカレーションされた案件の場合,エスカレーション元となった案件のエスカレーション番号
−
18
エスカレーション先関連案件通し番号
エスカレーションされた案件の場合,エスカレーション先の案件の関連案件通し番号
−
19
エスカレーション先エスカレーション番号
エスカレーションされた案件の場合,エスカレーション先の案件のエスカレーション番号
−
20
エスカレーション先プロセスワークボードID
エスカレーションされた案件の場合,エスカレーション先の案件が登録されているプロセスワークボードのID
−
21
エスカレーション先システムID
エスカレーションされた案件の場合,エスカレーション先の案件が登録されているシステムのID
−
22
エスカレーション先システム名
エスカレーションされた案件の場合,エスカレーション先の案件が登録されているシステムの名称
−
23
エスカレーション先プロセス名
エスカレーションされた案件の場合,エスカレーション先の案件が登録されているプロセスワークボードのプロセス表示名
−
24
連動元イベントDB内通し番号
自動登録された案件と関連するJP1イベントのイベントDB内通し番号
JIMSD_FORM_IMEVENTNO
25
JP1/IM - Managerのホスト名
自動登録された案件と関連するJP1イベントのJP1/IM - Managerのホスト名
JIMSD_FORM_IMHOSTNAME
26
重大度
案件の重大度
JIMSD_FORM_SEVERITYCODE
27
影響度
案件の影響度
JIMSD_FORM_IMPACTCODE
28
優先度
案件の優先度
JIMSD_FORM_PRIORITYCODE
29
案件種別
案件の種別
JIMSD_FORM_ITEMCATEGORYCODE
30
問題分野
案件の問題分野
JIMSD_FORM_ISSUECATEGORYCODE
31
現象種別
案件の現象種別
JIMSD_FORM_PHENOMENONCODE
32
要因
案件の要因
JIMSD_FORM_CAUSECODE
33
結果
案件の結果
JIMSD_FORM_RESULTCODE
34
解決区分コード
案件の解決区分コード
JIMSD_FORM_SOLUTIONCODE
35
回避策種別
案件の回避策種別
JIMSD_FORM_AVOIDANCECODE
36
変更の規模
案件の変更規模
JIMSD_FORM_CHANGESCALECODE
37
リリースタイプ
案件のリリースタイプ
JIMSD_FORM_RELEASETYPECODE
38
発生日時
案件の発生日時
JIMSD_FORM_ACCRUALDATE
39
作業期限
案件の作業期限
JIMSD_FORM_DEADLINE
40
開始日時
案件の開始日時
JIMSD_FORM_STARTDATE
41
完了日時
案件の完了日時
JIMSD_FORM_COMPDATE
42
タイトル
案件のタイトル
JIMSD_FORM_TITLE
43
概要
案件の概要
JIMSD_FORM_SUMMARY
44
影響業務
案件が影響する業務
JIMSD_FORM_EFFECTSERVICE
45
重大度の理由
案件の重大度の設定理由
JIMSD_FORM_SEVERITYREASON
46
影響度の理由
案件の影響度の設定理由
JIMSD_FORM_IMPACTREASON
47
優先度の理由
案件の優先度の設定理由
JIMSD_FORM_PRIORITYREASON
48
回避策
案件の回避策
JIMSD_FORM_AVOIDANCE
49
作業状況
案件の作業状況
JIMSD_FORM_SITUATION
50
根本原因
案件の根本原因
JIMSD_FORM_ROOTCAUSE
51
解決策
案件の解決策
JIMSD_FORM_SOLUTION
52
問題個所とバージョン
案件の問題個所とバージョン
JIMSD_FORM_FAILURELOCATION
53
スケジュール,手順概要
案件のスケジュール,手順概要
JIMSD_FORM_SCHEDULE
54
変更の影響評価
変更の影響評価
JIMSD_FORM_IMPACTEVAL
55
審議結果
案件の審議結果
JIMSD_FORM_DELIBERATIONRST
56
再発防止のための考察
再発防止策のための考察
JIMSD_FORM_MEASURES
57
フリー記入欄
フリー記入欄
JIMSD_FORM_FREEDESCRIPTION
58
プロダクト名
JP1イベントを発行したプロダクト名
JIMSD_FORM_JP1PRODUCTNAME
59
ジョブネット名
JP1/AJSのジョブネット名
JIMSD_FORM_JP1JOBNETNAME
60
ジョブ名
JP1/AJSのジョブ名
JIMSD_FORM_JP1JOBNAME
61
SNMPソース
JP1/BaseのSNMPトラップ変換機能で発行されたJP1イベントのSNMPトラップの発生ソース名
JIMSD_FORM_JP1SNMPSRC
62
監視ノード名
JP1/IM - Managerの統合スコープ機能で定義した監視ノード名
JIMSD_FORM_JP1NODENAME
63
アラーム名
JP1/PFM Web Consoleが発行したJP1イベントのアラーム名
JIMSD_FORM_JP1ALARMNAME
64
顧客名
顧客名
JIMSD_FORM_CUSTOMERNAME
65
費用(予算)
費用(予算)
JIMSD_FORM_ESTIMATEDCOST
66
費用(実績)
費用(実績)
JIMSD_FORM_ACTUALCOST
67
問い合わせ者名
問い合わせ者名
JIMSD_FORM_INQUIRYNAME
68
登録者ID
案件を登録したユーザーのID
−
69
登録者名
案件を登録したユーザーの名称
JIMSD_FORM_REGISTRANT
70
登録者(英語)
案件を登録したユーザーの名称(英語)
−
71
担当者種別
案件担当者の種別(ユーザーまたはロール)
−
72
担当者ID
案件担当者のユーザーID
−
73
担当者名
案件担当者の名称
JIMSD_FORM_ASSIGNED
74
担当者名(英語)
案件担当者の名称(英語)
−
75
回答責任者種別
案件回答責任者の種別(ユーザーまたはロール)
−
76
回答責任者ID
案件回答責任者のユーザーID
−
77
回答責任者名
案件回答責任者の名称
JIMSD_FORM_RESPONDENT
78
回答責任者名(英語)
案件回答責任者の名称(英語)
−
79
拡張テキストデータ1
ユーザーが案件フォームで定義したテキストデータの追加項目(1〜20個)
JIMSD_FORM_USERTEXT01〜JIMSD_FORM_USERTEXT20
80
拡張テキストデータ2
81
拡張テキストデータ3
82
拡張テキストデータ4
83
拡張テキストデータ5
84
拡張テキストデータ6
85
拡張テキストデータ7
86
拡張テキストデータ8
87
拡張テキストデータ9
88
拡張テキストデータ10
89
拡張テキストデータ11
90
拡張テキストデータ12
91
拡張テキストデータ13
92
拡張テキストデータ14
93
拡張テキストデータ15
94
拡張テキストデータ16
95
拡張テキストデータ17
96
拡張テキストデータ18
97
拡張テキストデータ19
98
拡張テキストデータ20
99
拡張時刻データ1
ユーザーが案件フォームで定義した時刻データの追加項目(1〜5個)
JIMSD_FORM_USERTIME01〜JIMSD_FORM_USERTIME05
100
拡張時刻データ2
101
拡張時刻データ3
102
拡張時刻データ4
103
拡張時刻データ5
104
拡張コードデータ1
ユーザーが案件フォームで定義したコードデータの追加項目(1〜5個)
JIMSD_FORM_USERCODE01〜JIMSD_FORM_USERCODE05
105
拡張コードデータ2
106
拡張コードデータ3
107
拡張コードデータ4
108
拡張コードデータ5
109
拡張数値データ1
ユーザーが案件フォームで定義した数値データの追加項目(1〜5個)
JIMSD_FORM_USERINT01〜JIMSD_FORM_USERINT05
110
拡張数値データ2
111
拡張数値データ3
112
拡張数値データ4
113
拡張数値データ5
114
拡張ユーザー情報種別1
ユーザーが案件フォームで定義したユーザーデータの追加項目(1〜5個)
- 拡張ユーザー情報種別
-
ユーザー種別(ユーザーまたはロール)
- 拡張ユーザー情報
-
ユーザーのID
- 拡張ユーザー名
-
ユーザーの名称
JIMSD_FORM_USEREXTTYPE01〜JIMSD_FORM_USEREXTTYPE05
115
拡張ユーザー情報1
116
拡張ユーザー名1
117
拡張ユーザー情報種別2
118
拡張ユーザー情報2
119
拡張ユーザー名2
120
拡張ユーザー情報種別3
121
拡張ユーザー情報3
122
拡張ユーザー名3
123
拡張ユーザー情報種別4
124
拡張ユーザー情報4
125
拡張ユーザー名4
126
拡張ユーザー情報種別5
127
拡張ユーザー情報5
128
拡張ユーザー名5
129
編集者ID
案件を作成,更新したユーザーのID
−
130
編集者名
案件を作成,更新したユーザーの名称
−
131
編集者名(英語)
案件を作成,更新したユーザーの名称(英語)
−
132
登録日時
案件を登録した日時
JIMSD_FORM_REGISTDATE
133
更新日時
案件を最後に更新した日時
JIMSD_FORM_LASTUPDATE
134
メッセージID
jssitementrybymailコマンドを使用して登録した案件の場合に設定される項目(案件の二重登録を防ぐための項目)
−
135
関連情報ID
案件の関連情報を表すID
−
136
添付ファイルID
添付ファイルのID
−
137
添付ファイル
添付ファイルの名称
JIMSD_FORM_ATTACHED
138
操作履歴
案件に対して行われた操作(登録,編集,引き戻し,差し戻し)を表す項目
−
- (凡例)
-
−:該当なし
- 注※1
-
案件の内容が改行を含む場合,改行文字はCSV設定ファイルに設定したhptl_jp1_imss_replace_linefeed_stringの値に基づき変換されます。CSV設定ファイルについては,「13. 定義ファイル」の「CSV設定ファイル(hptl_jp1_imss_csv_setting.properties)」を参照してください。
- 注※2
-
2つの案件フォームの項目IDで構成されています。詳細を,次の図に示します。
- フッター部
-
出力順
項目の内容
出力する値
1
ステータスが「クローズ」の案件数
Closed Item Number : 件数※
2
ステータスが「クローズ」以外の案件数
Unclosed Item Number : 件数※
- 注※
-
データ種別が「最新」の案件の合計数です。
関連情報CSVファイルの内容
関連情報CSVファイルには,次のような形式でデータが出力されます。
なお,関連情報CSVファイルに出力されるボディ部の1行目には,属性名が出力されます。
出力される内容について説明します。
- ヘッダー部
-
出力順
項目の内容
出力する値
1
製品名
JP1/Service Support
2
出力されるファイルのバージョン
出力されるファイルのバージョンを6けたの文字列で表す
3
関連情報CSVファイルの文字コード
出力されるファイルの文字コード
4
出力データの種別
ITEMEXPORTEX_ITEMREF
- ボディ部
-
出力順
項目名※
説明
1
プロセスワークボードID
関連元の案件が登録されているプロセスワークボードのID
2
プロセスワークボード内通し番号
関連元の案件のプロセスワークボード内通し番号
3
バージョン番号
関連元の案件の履歴を表す番号
4
関連情報ID
関連情報を識別するためのID
5
案件フォーム項目ID
案件フォームの項目を識別するためのID
6
関連情報種別
関連情報の種別を表す項目
7
関連情報詳細
関連情報の詳細を表す項目
8
関連情報1
登録した関連情報の値
9
関連情報2
登録した関連情報の値
- 注※
-
案件の内容に改行文字が含まれる場合,改行文字はCSV設定ファイルに設定したhptl_jp1_imss_replace_linefeed_stringの値に基づき変換されます。CSV設定ファイルについては,「13. 定義ファイル」の「CSV設定ファイル(hptl_jp1_imss_csv_setting.properties)」を参照してください。
添付ファイルの内容
案件の添付ファイルをそのまま出力します。
なお,添付ファイルのパスが255バイトを超えている場合,次に示す順序でファイル名が変更されます。
-
拡張子を削除する。
-
出力ファイルのパスが255バイトになるように,末尾からファイル名を1文字ずつ削除する。
その際,半角文字を1バイト,全角文字を2バイトとして計算します。
システムおよびプロセスワークボードの状態に応じたコマンドの実行結果
jssitemexportExコマンドは,実行する際のシステムおよびプロセスワークボードの状態によって動作が異なります。システムおよびプロセスワークボードの状態に応じたjssitemexportExコマンドの実行結果を,次の表に示します。
項番 |
システムの状態 |
プロセスワークボードの状態 |
実行結果 |
---|---|---|---|
1 |
削除待ち |
− |
システム内の案件は出力しない。 |
2 |
運用中 |
準備中 |
プロセスワークボード内の案件は出力しない。 |
3 |
運用中 |
プロセスワークボード内の案件を出力する。ただし,削除待ちの案件は出力しない。※ |
|
4 |
停止中 |
||
5 |
削除待ち |
プロセスワークボード内の案件は出力しない。 |
- (凡例)
-
−:該当なし
- 注※
-
プロセスワークボードの状態が運用中の場合,jssitemexportExコマンドの実行中に案件を操作できます。そのため,ステータスが「クローズ」(処理が完了している)の案件を,jssitemexportExコマンドの対象にすることを推奨します。
実行時の前提条件
コマンド実行時のサービスの状態については,「12. コマンド」の「コマンド実行時のサービスの状態」を参照してください。
注意事項
-
jssitemexportExコマンドの実行中に[Ctrl]+[C]キーなどでコマンドの実行を打ち切った場合,案件情報の出力に失敗するおそれがあります。このため,コマンドの実行中に[Ctrl]+[C]キーなどで実行を打ち切らないでください。もし実行を打ち切った場合は,しばらく時間を置いてからコマンドを再実行してください。
-
エラーなどによってjssitemexportExコマンドの実行が中断した場合,出力ファイルの内容が不完全になるおそれがあります。
-
jssitemexportExコマンドの実行中に対象となるプロセスワークボードの案件を操作した場合,出力対象に含まれないおそれがあります。そのため,プロセスワークボードの状態を停止中にしてから実行することを推奨します。
-
jssitemexportExコマンドの実行中に入力元フォルダ配下のフォルダおよびファイルを操作しないでください。操作した場合,コマンドが異常終了します。なお,入力元フォルダを指定して,jssitemimportExコマンドを実行しないでください。
使用例
- 使用例1
-
案件を格納するデータベースの容量を削減する目的で案件を削除する前に,案件情報を退避したい場合:
2012年1月1日〜2013年1月1日の期間に更新された案件のうち,プロセスワークボードIDが「pwb001」でステータスが「クローズ」の案件情報を出力し,そのあと,案件一括削除コマンド(jssitemdeletion)を実行する場合の指定例を,次に示します。
jssitemexportEx -o C:\export -p -id pwb001 -et 2012/01/01-2013/01/01 jssitemdeletion -p -id pwb001 -n 2012/01/01-2013/01/01
- 使用例2
-
監査用のログとして,すべての案件の情報を定期的に退避したい場合:
2012年1月1日〜2013年1月1日の期間に作成された案件のうち,すべてのシステムを対象に,すべてのステータスの案件を出力する場合の指定例を,次に示します。
jssitemexportEx -o C:\export -ALL -et 2012/12/01-2013/01/01 -a
この場合,プロセスワークボードの状態を「停止中」にしてから実行してください。
- 使用例3
-
管理していたプロセスワークボードの運用を終了する場合:
運用開始日が2012年1月1日で,運用終了日が2013年1月1日であるプロセスワークボードIDが「pwb001」の案件をすべて出力する場合の指定例を,次に示します。
jssitemexportEx -o C:\export -p -id pwb001 -ct 2012/01/01-2013/01/01 -a
この場合,プロセスワークボードの状態を「停止中」にしてから実行してください。