CSV インポート

このページの内容

お困りですか?

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

コミュニティに質問

データは CSV ファイルからインポートされます。これは、スプレッドシートを使用している、またはすべてのアセットに CSV ファイルがある場合に役立ちます。インポートの詳細についてご確認ください。

インポートを作成、設定、有効化するには、ユーザーがオブジェクト スキーマのアセット マネージャーである必要があります。

はじめる前に

CSV ファイルの要件を次に示します。

CSV ヘッダー

CSV ファイルには、インポート用のデータ ロケーターの作成に使用されるヘッダーが必要です。ヘッダー値は空にできません。

複数の値

複数の値を除算するには (複数のカーディナリティを持つアセット属性の場合)、「||」(2 つのパイプ文字) を使用します。

インポート フィールド

インポート タイプを選択したら、その詳細を入力する必要があります。アセットに表示されるフィールドの説明は次のとおりです。

一般フィールド

次は、すべてのインポート タイプに共通する一般的なフィールドです。

名前

説明

名前インポートの名前。
説明 参考用の説明。
連結子

既定の連結子を指定できます。複数のデータ ロケーターを 1 つの Insight 属性に結合する際は、これが既定の連結子になります。たとえば、"姓" と "名" のような 2 つの列を 1 つの属性に結合できます。したがって、"Mathias" (名) と "Edblom" (姓) は、連結子として \s によって "Mathias Edblom" として連結されます。

スペースの連結には \s を入力してください。連結文字を含めるには、その値を二重引用符で囲みます ("\s")。

空の値データ ロケーターが空の際の処理を定義します。インポート時に属性値を削除するか、無視して現在の値をそのままに保持します。
Insight では、データ ロケーターが不明な場合の処理を定義します。これは、"Status" や "Select" などの属性タイプで発生する可能性があります。この値は、オプションとして追加も無視もできます。

インポート ソースの日付フィールドを Insight の日付に変換する際の形式。空のままにすると、Insight で正しい形式が自動で検索されます。
この形式は、Java の SimpleDateFormat のガイドラインに従って指定する必要があります。

インポート ソースの日付/時刻フィールドを Insight の日付に変換する際の形式。空のままにすると、Insight で正しい形式が自動で検索されます。
この形式は、Java の SimpleDateFormat のガイドラインに従って指定する必要があります。

モジュール フィールド

これらのフィールドはインポート タイプ (モジュール) に固有です。

設定

説明

インポート元

ファイルまたは URL を選択します。

  • URL

外部 CSV ファイルの検索場所のプロトコル、ホスト名、ポート。

例: http(s)://example.com/file.csv または file:///opt/csv/example.csv

  • ファイル
アップロードするファイルを選択します。

ユーザ名

基本認証のオプション ユーザー名。

パスワード

基本認証で使用するオプションのパスワード。

区切り文字

ファイルで使用されている区切り文字。タブ区切りの場合は \t を入力します。区切り文字を含めるには、値を二重引用符で囲みます。区切り文字または二重引用符を含めるには、それぞれの値を二重引用符で囲みます。


スケジュール フィールド

スケジュール フィールドは、データの同期を維持する役割を果たします。

名前説明
同期アカウント

データをアセットに同期する際に使用する Jira ユーザー。

LDAP およびデータベースのインポートでは、同期に使用するアカウントに Jira 管理者権限が必要です。

cron 式自動同期の間隔。
自動同期インポートを自動で同期するようにスケジュールするかどうか。
通知インポートが失敗したときにすべてのオブジェクト スキーマ マネージャーに通知するには、チェックボックスを選択してください。 

事前定義済みの構造と設定

必須フィールドに入力した後に、次のステップでアセットから定義済みの構造 (オブジェクト タイプ マッピング) と設定 (属性マッピング) を作成するかどうかを尋ねられます。この詳細はインポート タイプによって異なります。

ここでは CSV インポートの詳細について説明します。

  • CSV ファイルの各列は既定のテキスト タイプのアセット属性として作成され、設定はそれに応じてマッピングされます。 
  • 作成されるオブジェクト タイプは常に同じです。
  • 一部のオブジェクト タイプ マッピングは、初期設定で無効になっています。関連するものを必ずご選択ください。

CSV ファイルからインポートしたデータで異なる属性タイプを作成する場合は、定義済みの構造を作成してから属性タイプを変更します。

作成されたインポート設定

これでインポート設定を表示できるようになりましたが、まだ準備が完了していません。引き続き、オブジェクト タイプと属性のマッピングを作成または確認して、インポート設定に問題がないことを確実にする必要があります。

準備ができたら「2 オブジェクト タイプと属性マッピングを作成する」に進みます。

最後に一言

オブジェクト タイプ マッピングの設定

次のステップでは、オブジェクト マッピングの設定を作成します。CSV インポート タイプに固有の設定をいくつか紹介します。

名前

説明

セレクターCSV インポートのセレクターは使用されません。AQL によって 任意のデータを CSV ファイルから絞り込みます。
最終更新日 2024 年 7 月 26 日

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

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.