CSV インポート

このページの内容

お困りですか?

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

コミュニティに質問

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

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

はじめる前に

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

CSV ヘッダー

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

複数の値

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

インポート フィールド

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

一般フィールド

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

名前

説明

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

既定の連結子を指定できます。複数のデータ ロケーターを 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 を入力します。区切り文字を含めるには、値を二重引用符で囲みます。区切り文字または二重引用符を含めるには、それぞれの値を二重引用符で囲みます。

スケジュール フィールド

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

名前説明
同期アカウントデータを Insight に同期する際に使用する Jira ユーザー
cron 式自動同期の間隔。
自動同期インポートを自動で同期するようにスケジュールするかどうか。

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

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

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

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

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

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

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

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

最後に一言

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

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

名前

説明

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

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

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