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

アセットは、Jira Service Management の Premium プランと Enterprise プランに含まれています。アセットの概要とその仕組みをご確認ください。

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

はじめる前に

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

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

From the app switcher, select Assets
From your sidebar, select Schemas.
オブジェクトスキーマを選択します。
[スキーマ設定] を選択してから、[インポート] タブを選択します。
[インポート] タブで、次の手順に従います。
1. If there is no import structure you will see the message No Import structure created. Select Be the first to create one.
2. If an import structure has already been created, select Create import to add a new import structure.
ポップアップウィンドウから、次のいずれかを選択します。
1. Discovery インポート – Assets Discovery ファイルからデータをインポートします。
2. CSV インポート – CSV (コンテンツ区切り値) ファイルからデータをインポートします。
3. JSON インポート – JSON (JavaScript オブジェクト表記) ファイルからデータをインポートします。
4. 外部インポート – 外部アプリからデータをインポートします。データをアセットにインポートするアプリを開発する方法の詳細については、「Imports REST API ガイド」をご覧ください。または、Forge を使用してサードパーティのデータをアセットにインポートする方法に関するチュートリアルをご覧ください。
次に、[インポート構造を定義] 画面でインポート構造を設定します。外部インポートを作成する場合は、このステップをスキップできます。
1. 名前 (必須) – インポート設定の名前を入力します。
2. 説明 – インポート設定の説明を入力します。
3. ファイルをドラッグ & ドロップするか参照する (必須) – ここにソースデータファイルをドラッグ & ドロップするか参照します。
4. オブジェクトタイプと属性を自動で作成する – このオプションを無効にするには、データのインポート前にデータをスキーマに手動でマッピングする必要があります。データの手動マッピングについて詳しくはこちらをご確認ください。
5. その他のオプション – アセットが区切り文字、エンコード、空または未知の値、連結、日付形式を処理する方法を変更するには、ここで既定値を変更します。
  1. 区切り文字 (必須) – ファイルで使用する区切り文字を選択します。区切り文字は、ある値の終わりと次の値の始まりの場所を示す文字です。「\ t」で示される「タブ」文字を除いて、1 文字の長さの区切り文字のみが許可されます。区切り文字または二重引用符を含めるには、それぞれの値を二重引用符で囲みます。
  2. エンコーディング (必須) – CSV ファイルで使用するエンコーディングを選択します。デフォルトのエンコーディングは UFT-8 です。
  3. 連結子 (必須) – 複数の値を 1 つのアセット属性に結合する場合は、連結子を使用できます。既定ではダッシュ記号「-」が使用されます。データがスペースで連結されている場合は「\s」を入力できます。
  4. 空の値 – オブジェクトが更新される際に、外部ソースからの空の値で既存の値を削除するかどうかを選択します。次の項目から選択します。
    1. 削除 – 現在の値を削除します。属性がステータス、選択、または複数の値を持つ参照タイプ属性である場合、すべての値が削除されます。
    2. 無視 – 該当するオブジェクトタイプに対して現在の値を保持します。属性がステータス、選択、または複数の値を持つ参照タイプ属性である場合、すべての値が保持されます。
  5. 不明な値 (必須) – 空の値を無視するか追加するかを選択します。
  6. 日付形式 – 日付をアセットに変換する形式を選択します。何も指定されていない場合は、アセットが正しい形式を自動で検索します。
  7. 日時の形式 – 日時をアセットに変換するための日時形式。何も指定されていない場合は、アセットが正しい形式を自動で検索します。
[作成] を選択します。
これで、[インポート] タブに新しいインポート構造が入力されます。

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

アセットにデータをインポートするには、次の 5 つのステップに従います。
1. データを準備します。
2. インポート構造を作成します。インポートには 4 つのタイプがあります。
  1. Discovery。Discovery のデータをアセットに取り込む方法の詳細をご確認ください。
  2. CSV。インポート用に CSV を設定する方法の詳細をご確認ください。
  3. JSON インポート。JSON ファイルからのデータのインポートに関する詳細をご確認ください。
  4. 外部インポート。アセットにデータをインポートするアプリの開発方法に関する詳細をご確認ください。
3. データをマッピングします。次の 2 つのオプションがあります。
  1. オブジェクトタイプと属性を自動で作成することで、データを自動でマッピングするか、
  2. 次の方法でデータを手動でマッピングします。
    1. オブジェクトタイプマッピングによってアセットオブジェクトタイプを作成する
    2. オブジェクトタイプ属性マッピングによってアセットの属性と参照を作成する
    3. 子オブジェクトタイプマッピングによって階層的な親と子の構造を作成する。
4. オブジェクトタイプマッピングを作成したら、それらを有効にする必要があります。すべてのオブジェクトタイプマッピングが [有効化] に設定されるまで、インポート構造は実行されません。オブジェクトタイプマッピングが有効にされていない場合は、オブジェクトタイプマッピングを右クリックして [有効化] をクリックして有効にします。
5. インポートを実行します。

この内容はお役に立ちましたか?

正確ではなかった明確ではなかった関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問