7.4.3 インポート/エクスポート
構成アイテムの一覧はCSVファイルのエクスポート、インポートができます。
ある時点での構成アイテムの一覧をファイルに保存することや、複数の構成アイテムを一括で作成、編集することが可能です。
ここでは次の項目について説明します。
（1）インポート/エクスポート テンプレートを作成
（2）構成アイテムのエクスポート
（3）構成アイテムのインポート
（1）インポート/エクスポート テンプレートを作成
テンプレートとは、OTOBOのオブジェクトの種類やそのフィールドと入出力ファイルの情報の対応付けや、ファイルの書式などを定めたルールです。以下の方法でテンプレートを作成します。
メインメニューから[管理]を選択し、[管理]-[インポート/エクスポート]をクリックします。[インポート/エクスポートの管理]画面で[テンプレートを追加]ボタンをクリックします。 遷移する表示に従い、以下のフィールドを入力します。
（表）基本情報の設定
| フィールド | 必須 | 説明 |
|---|---|---|
| 名前 | Yes | テンプレートの名前 |
| 対象 | Yes | 「構成アイテム」を選択します。 |
| 書式 | Yes | 「CSV」を選択します。 |
| 有効 | Yes | 「有効」を選択します。 |
| コメント | No | 任意のコメントを入力します。 |
（表）オブジェクト情報の設定
| フィールド | 必須 | 説明 |
|---|---|---|
| クラス | Yes | インポート/エクスポートの対象となる構成アイテムのクラス |
| 一エレメントあたりの最大数 | Yes | 構成アイテムで複数の値を設定できるフィールドについて、その要素数の最大を設定します。 |
| 空欄の項目は現在の値が保持されること意味します | Yes | チェックを外します。 |
（表）フォーマット情報の設定
| フィールド | 必須 | 説明 |
|---|---|---|
| 桁のセパレータ | Yes | CSVファイルの区切り文字 |
| キャラクタセット | Yes | 「UTF-8」を選択します。 |
| ヘッダ情報を含む | Yes | 「はい」を選択します。 |
[マッピング要素の追加]をクリックし、CSVファイルの列に対応するフィールドを追加します。テーブルの各列の意味は以下のとおりです。
（表）マッピング情報の設定
| フィールド | 説明 |
|---|---|
| キー※1 | 構成アイテムのフィールド名 「Number」は構成アイテム全体で一意となる自動で割り振られる番号で、クラス定義に含まれていなくても選択できます。 |
| 識別子※2、※3 | 構成アイテムの識別子として扱う場合、チェックします。識別子は、インポートしたCSVファイルの各行の情報が、OTOBOに保存されているどの構成アイテムのものかの対応づけに使用されます。インポート時に既存の構成アイテムの情報を上書きする場合は識別子をチェックしてください。チェックしない場合、新規の構成アイテムとして登録されます。 |
| 列 | CSVファイルの何列目かを表します。0から自動で付与されます。 |
| 上に移動 | マッピング要素の位置を1つ上にずらします。 |
| 下に移動 | マッピング要素の位置を1つ下にずらします。 |
| 削除 | マッピング要素を削除します。 |
また、テンプレートをインポートに使用する際は、「（表）インポートに必要なマッピング要素」のフィールド（鍵）を必ず登録してください。
エクスポート対象を制限したい場合は、[検索あたりの出力を制限:]をチェックし、残りのフィールドで検索条件を設定します。
（2）構成アイテムのエクスポート
メインメニューから[管理]を選択し、[管理]-[インポート/エクスポート]をクリックすると、[インポート/エクスポートの管理]画面に遷移し、テンプレートの一覧が表示されます。
エクスポート対象のテンプレートの[エクスポート開始]カラムにある[エクスポート]をクリックすると、テンプレートの設定内容に基づいたCSVファイルがダウンロードできます。
注意事項
- エクスポートすると、BOM無しのUTF-8でエンコードしたファイル（CSV形式）がダウンロードされます。このファイルをテキストエディタで開いた場合は正常に表示されます。Excelで開いた場合は文字化けするので、ファイルをBOM付きのUTF-8にエンコードして保存し直してください。
（3）構成アイテムのインポート
メインメニューから[管理]を選択し、[管理]-[インポート/エクスポート]をクリックすると、[インポート/エクスポートの管理]画面に遷移し、テンプレートの一覧が表示されます。
インポート対象のテンプレートの[インポート開始]カラムにある[インポート]をクリックし、インポートするCSVファイルを選択すると、テンプレートの設定内容に基づいてCSVファイルから構成アイテムの情報を取得しインポートします。
CSVファイルで新しい構成アイテムを作成するには、次の事項を記述している必要があります。
- CSVファイルの該当列に適切な値を記述していること
- 新規クラスの作成やクラスの編集によって必須のフィールドが存在する場合、そのフィールドのマッピング要素を含め、CSVファイルに適切な値を記述していること
- マッピング要素に必ず以下を含めること
| フィールド（鍵） | 説明 |
|---|---|
| Name | 構成アイテムの名前 |
| Deployment State | 構成アイテムのデプロイ・ステータス 以下の英語の値のうちから選択します。
|
| Incident State | 構成アイテムのインシデントの状態 以下の英語の値のうちから選択します。
|
注意事項
次の内容はインポート、エクスポートができません。
- 構成アイテム間のリンク
- インポート/エクスポートの定義そのもの
OTOBOでエクスポートしたCSVファイルを別の環境のOTOBOにインポートする場合は、エクスポート時に利用したテンプレートと同等のものをインポートする環境でも作成する必要があります。 - 添付ファイル