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\

ページの先頭へ

引数

出力先フォルダ名
 ├ 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
     :
     :

ページの先頭へ

戻り値

ページの先頭へ

案件情報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バイトを超えている場合，次に示す順序でファイル名が変更されます。

1. 拡張子を削除する。

2. 出力ファイルのパスが255バイトになるように，末尾からファイル名を1文字ずつ削除する。

   その際，半角文字を1バイト，全角文字を2バイトとして計算します。

ページの先頭へ

システムおよびプロセスワークボードの状態に応じたコマンドの実行結果

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

この場合，プロセスワークボードの状態を「停止中」にしてから実行してください。

ページの先頭へ