You can import data from a CSV file. This import method useful if you're still using spreadsheets or maintain your assets in CSV files. More about importing

次のセクションにジャンプ:

• はじめる前に
• CSV データのフォーマット
• Step by step tutorial for importing a CSV file
• 事前定義済みの構造と設定
• 作成されたインポート設定
• 最後に一言
  • オブジェクト タイプ マッピングの設定
• 既知の制限事項

はじめる前に

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

• Make sure you have an object structure already defined. If not, check out our Assets tutorial.

• The CSV file needs to have headers, as they're used to create the data locators for the imports.

• To divide multiple values, for the Assets Attributes with multiple cardinality, use || (two pipe characters).

CSV データのフォーマット

If there's a syntax error in your CSV data file, your import might produce unexpected results or not run. Make sure to follow the formatting rules:

• You can use any of the following formats: UTF-8 (default), UTF-16, ISO-8859-1, ISO-8859-15, Windows-1250, or Windows 1252.

• The CSV file must include a single-character delimiter. The default delimiter is the comma ,. You can select a custom delimiter in the Delimiter field when you create an import configuration. To include a delimiter character, use a single character input. You can also enter \t to use a tab-delimiter.

• If you're importing Jira users, you must identify them by their Names, Emails, or User keys.

• If you're importing Jira groups, you must identify them by their Names only.

• If you're importing URLs, they must begin with a protocol, such as http, https, ftp, or file followed by :// to be converted into the URL attribute type. If you don’t include the protocol, the value won’t be imported. Explore attribute types

• If you're importing CSV data from a Google Sheets link, edit the URL so it works properly. Remove /edit#gid=0 from the ending of the URL and replace it with /export?format=csv.

Step by step tutorial for importing a CSV file

For testing purposes, you can use the following CSV file sample. This file includes the information about employees: name, employment start and end date, role, name that Jira uses to display them, and the assigned office location.

Name,Employment start date,Employment End date,Role,Jira User,Office
John Doe,2019-06-15,2023-04-30,Project Manager,John Doe,New York
Jane Smith,2021-03-01,,Developer,Jane Smith,London
Emily Johnson,2018-09-10,2022-12-31,Designer,Emily Johnson,Sydney
Michael Brown,2020-01-20,,QA Tester,Michael Brown,San Francisco
Emma Wilson,2017-11-05,,HR Specialist,Emma Wilson,Berlin
James Davis,2022-01-01,,Data Analyst,James Davis,Tokyo
Olivia Martinez,2016-07-25,2021-08-15,Marketing Coordinator,Olivia Martinez,Toronto
Liam Garcia,2019-11-18,,Sales Executive,Liam Garcia,Singapore
Sophia Lee,2023-05-01,,Customer Success Manager,Sophia Lee,Dublin

After importing and configuring the file, you should see the imported objects (employees, in this case) and objects' values (employee data). This will result in a configuration like this for a single object:

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

1. From your service project, go to Assets, then Object Schemas.

2. From the Object Schemas list, next to the Object Schema you want to use, select Configure.
   
   

3. In the Schema configuration view, open the Import tab.

4. Under the Import tab:

   • If there’s no import structure, you’ll see the message “You don't have any import connections yet”. Select Create Import configuration to create a new import structure.

   • If an import structure has already been created, select Create Configuration.

5. Select CSV import, then select Next.

6. Fill in the General, Module, and Scheduling import fields.
   

   一般フィールド

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

   名前	説明
   名前	インポートの名前。
   説明	参考用の説明。
   連結子	You can specify a default concatenator. When joining multiple data locators into one Assets attribute, this will be the default concatenator. One example could be to join two columns like "First name" and "Last name" into one attribute. So "Mathias" (first name) and "Edblom" (last name) will be concatenated as "Mathias Edblom" if using \s as concatenator. Enter \s for space-concatenated. To include a concatenate character, place the value between double quotes (i.e "\s").
   空の値	Defines what should happen when a Data Locator is empty: Ignore - the existing value in the object will be retained and not overridden by an empty value. Remove - the existing value for the object will be removed, and replaced with an empty field value.
   未知の値	Defines what should happen if a Data Locator is unknown. This could happen with attribute types like "Status" and "Select".  Ignore - the value from CSV will be ignored and the object attribute will be left empty. Add - the value passed in the CSV file will be added to the list and the object attribute will be updated with the new value.
   日付の形式	インポート ソースの日付フィールドを Insight の日付に変換する際の形式。空のままにすると、Insight で正しい形式が自動で検索されます。 この形式は、Java の SimpleDateFormat のガイドラインに従って指定する必要があります。
   日時の形式	インポート ソースの日付/時刻フィールドを Insight の日付に変換する際の形式。空のままにすると、Insight で正しい形式が自動で検索されます。 この形式は、Java の SimpleDateFormat のガイドラインに従って指定する必要があります。

   
   
   モジュール フィールド

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

   設定	説明
   インポート元	ファイルまたは URL を選択します。
   URL	外部 CSV ファイルの検索場所のプロトコル、ホスト名、ポート。 例: http(s)://example.com/file.csv file:///opt/csv/example.csv https://docs.google.com/spreadsheets/d/your-spreadsheet-id If you’re importing a Google Sheet file, you might also see URLs with additional parameters, such as https://docs.google.com/spreadsheets/d/your-spreadsheet-id/edit?usp=sharing. In such situation, remove edit?usp=sharing from the ending of the URL and replace it with /export?format=csv.
   	アップロードするファイルを選択します。
   ユーザ名	基本認証のオプション ユーザー名。
   パスワード	基本認証で使用するオプションのパスワード。
   区切り文字	The delimiter used in the file. The default delimiter is the comma ,. Enter \t for tab-delimited. You can select a custom delimiter in the Delimiter field when you create an import configuration. To include a delimiter character, use a single character input. You can also enter \t to use a tab-delimiter.

   スケジュール フィールド

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

   名前	説明
   同期アカウント	データをアセットに同期する際に使用する Jira ユーザー。 LDAP およびデータベースのインポートでは、同期に使用するアカウントに Jira 管理者権限が必要です。
   cron 式	自動同期の間隔。
   自動同期	インポートを自動で同期するようにスケジュールするかどうか。

7. 作成を選択します。

The Imports tab should now be populated with your new import structure. Next, you’ll need to create a predefined structure and configuration for your CSV file.

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

After you've filled in the required fields, Assets will ask you whether you want to create a predefined structure (object type mappings) and configuration (attribute mappings). Details of this will differ depending on the import type. For the CSV import:

• CSV ファイルの各列は既定のテキスト タイプのアセット属性として作成され、設定はそれに応じてマッピングされます。 

• 作成されるオブジェクト タイプは常に同じです。

• 初期設定では、一部のオブジェクト タイプ マッピングが無効になっています。必ず関連するものを選択してください。

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

After you select Create predefined configuration, Assets will create configurations and mapping from the fields in the CSV file to the attributes in the object type. As these are created based on the default rules, you might need to review the mappings and make necessary changes.

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

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

When you're ready, go to 2. Create object type and attribute mapping.

最後に一言

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

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

既知の制限事項

• The textArea attribute has a hyperlink option. However, this can't be used in the CSV import.

• For the textArea attribute, the value should be enclosed in the wrapper element, such as <div class="created-with-ak-editor content-wrapper"><p></p>. If the wrapper element isn’t present in the source, every sync will rewrite it, adding the wrapper each time and creating a new history event.