インポート構造を作成する

Jira Service Management のアセットは、さまざまなタイプの複数のインポートを保存して実行できます。インポートのタイプごとにインポート構造が必要です。この構造は、データの検索場所とアセットが特定のインポート タスクを管理する方法に関する情報をまとめたものです。

インポート構造を作成するには、サービス プロジェクトから次の手順を実行します。

1. [アセット] に移動してから [オブジェクト スキーマ] に移動します

2. オブジェクト スキーマを選択します。

3. [スキーマ設定] を選択して、次に [インポート] タブを選択します。

4. [インポート] タブで、次の手順に従います。

   1. インポート構造がない場合は、メッセージ「インポート構造が作成されていません」が表示されます。[最初に作成] をクリックします。

   2. インポート構造がすでに作成されている場合は、[インポートを作成] をクリックして新しいインポート構造を追加します。

5. ポップアップ ウィンドウから、次のいずれかを選択します。

   1. Discovery インポート – Assets Discovery ファイルからデータをインポートします。

   2. CSV インポート – CSV (コンテンツ区切り値) ファイルからデータをインポートします。

   3. JSON インポート – JSON (JavaScript オブジェクト表記) ファイルからデータをインポートします。

   4. 外部インポート – 外部アプリからデータをインポートします。データをアセットにインポートするアプリを開発する方法の詳細については、「Imports REST API ガイド」をご覧ください。または、Forge を使用してサードパーティのデータをアセットにインポートする方法に関するチュートリアルをご覧ください。

6. 次に、[インポート構造を定義] 画面でインポート構造を設定します。外部インポートを作成する場合は 、このステップをスキップできます。

   1. 名前 (必須) – インポート設定の名前を入力します。

   2. 説明 – インポート設定の説明を入力します。

   3. ファイルをドラッグ & ドロップするか参照する (必須) – ここにソース データ ファイルをドラッグ & ドロップするか参照します。

   4. オブジェクト タイプと属性を自動で作成する – このオプションを無効にするには、データのインポート前にデータをスキーマに手動でマッピングする必要があります。データの手動マッピングについて詳しくはこちらをご確認ください。

   5. その他のオプション – アセットが区切り文字、エンコード、空または未知の値、連結、日付形式を処理する方法を変更するには、ここで既定値を変更します。

      1. 区切り文字 (必須) – ファイルで使用する区切り文字を選択します。区切り文字は、ある値の終わりと次の値の始まりの場所を示す文字です。「\ t」で示される「タブ」文字を除いて、1 文字の長さの区切り文字のみが許可されます。区切り文字または二重引用符を含めるには、それぞれの値を二重引用符で囲みます。

      2. エンコーディング (必須) – CSV ファイルで使用するエンコーディングを選択します。デフォルトのエンコーディングは UFT-8 です。

      3. 連結子 (必須) – 複数の値を 1 つのアセット属性に結合する場合は、連結子を使用できます。既定ではダッシュ記号「-」が使用されます。データがスペースで連結されている場合は「\s」を入力できます。

      4. 空の値 – オブジェクトが更新される際に、外部ソースからの空の値で既存の値を削除するかどうかを選択します。次の項目から選択します。

         1. 削除 – 現在の値を削除します。属性がステータス、選択、または複数の値を持つ参照タイプ属性である場合、すべての値が削除されます。

         2. 無視 – 該当するオブジェクト タイプに対して現在の値を保持します。属性がステータス、選択、または複数の値を持つ参照タイプ属性である場合、すべての値が保持されます。

      5. 不明な値 (必須) – 空の値を無視するか追加するかを選択します。

      6. Date Format – Select a format to convert dates into Assets. Assets will automatically try to find the correct format if none is provided.

      7. Date/Time format – The date/time format to convert dates with time into Assets. Assets will automatically try to find the correct format if none is provided.

7. [作成] を選択します。

8. これで、[インポート] タブに新しいインポート構造が入力されます。