Hitachi

JP1 Version 12 JP1/Service Support 構築・運用ガイド


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

  1. 拡張子を削除する。

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

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

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

jssitemexportExコマンドは,実行する際のシステムおよびプロセスワークボードの状態によって動作が異なります。システムおよびプロセスワークボードの状態に応じたjssitemexportExコマンドの実行結果を,次の表に示します。

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

項番

システムの状態

プロセスワークボードの状態

実行結果

1

削除待ち

システム内の案件は出力しない。

2

運用中

準備中

プロセスワークボード内の案件は出力しない。

3

運用中

プロセスワークボード内の案件を出力する。ただし,削除待ちの案件は出力しない。

4

停止中

5

削除待ち

プロセスワークボード内の案件は出力しない。

(凡例)

−:該当なし

注※

プロセスワークボードの状態が運用中の場合,jssitemexportExコマンドの実行中に案件を操作できます。そのため,ステータスが「クローズ」(処理が完了している)の案件を,jssitemexportExコマンドの対象にすることを推奨します。

実行時の前提条件

コマンド実行時のサービスの状態については,「12. コマンド」の「コマンド実行時のサービスの状態」を参照してください。

注意事項

使用例

使用例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

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