• 使用を開始する
  • 関連ドキュメント

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

Jira Service Managementアセットは、Premium と Enterprise のみの機能です。アセットの詳細についてご確認ください

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

はじめる前に

Jira Service Managementアセットにインポートするデータを準備する必要があります。

インポート構造を作成するには、次の手順に従います。

  1. サービス プロジェクトから、[アセット] > [オブジェクト スキーマ] の順に移動します。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      6. 日付形式 - 日付をアセットに変換する形式を選択します。何も指定されていない場合は、アセットが正しい形式を自動で検索します。

      7. 日時の形式 - 日時をアセットに変換するための日時形式。何も指定されていない場合は、アセットが正しい形式を自動で検索します。

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

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

アセットにデータをインポートする方法

  1. アセットにデータをインポートするには、次の 5 つのステップに従います。

    1. データを準備します

    2. インポート構造を作成します。インポートには 4 つのタイプがあります。

      1. Discovery。Discovery のデータをアセットに取り込む方法の詳細をご確認ください。

      2. CSV。インポート用に CSV を設定する方法の詳細をご確認ください。

      3. JSON インポート。JSON ファイルからのデータのインポートに関する詳細をご確認ください。

      4. 外部インポート。アセットにデータをインポートするアプリの開発方法に関する詳細をご確認ください

    3. データをマッピングします。次の 2 つのオプションがあります。

      1. オブジェクト タイプと属性を自動で作成することで、データを自動でマッピングするか、

      2. 次の方法でデータを手動でマッピングします。

        1. オブジェクト タイプ マッピングによってアセット オブジェクト タイプを作成する

        2. オブジェクト タイプ属性マッピングによってアセット属性と参照を作成する

        3. 子オブジェクト タイプ マッピングによって階層的な親と子の構造を作成する。

    4. オブジェクト タイプ マッピングを作成したら、それらを有効にする必要があります。すべてのオブジェクト タイプ マッピン