API または CSV でカスタマーと組織の詳細をインポートする

顧客の詳細とエンタイトルメントの詳細は、API または CSV ファイルからインポートできます。 これにより、すでに存在するフィールドに値がインポートされますが、新しいフィールドが追加されたり、新しい顧客や組織がインポートされたりすることはありません。存在しないフィールドの詳細をインポートする場合は、インポートを開始する前にこれらのフィールドを作成する必要があります。顧客の詳細をインポートできるのは Jira 管理者だけです。

API を介したインポート

カスタマーの詳細を別のデータベースに保存している場合は、REST API を使用してそれらをインポートできます。API を使用して詳細をインポートするためのドキュメンテーションについてはこちらをご確認ください。

CSV ファイルのインポート

インポートにより、他のプロジェクトの顧客を含むすべての顧客または組織の詳細が更新されます。CSV ファイルに他のプロジェクトの顧客や組織を含めると、それらは現在のプロジェクトに追加されます。1 つのプロジェクトの顧客の詳細のみをインポートするには、他のプロジェクトの顧客が CSV ファイルに含まれていないことを確認してください。

CSV ファイルを設定する

CSV ファイルに、インポートするカスタマーの詳細がすべて含まれていることを確認します。インポートごとの最大行数は 1,000 行で、最大ファイル サイズは 1MB です。1,000 を超える行をインポートするには、ファイルを複数のファイルに分割します。

CSV ファイルでは、カスタマーごとに独立した行を作成し、詳細を列としてフォーマットする必要があります。カスタマーや組織を個別にインポートする場合は、必要なフォーマットが少し異なります。

個々のカスタマーの場合:

• 列ヘッダーとして [メール アドレス] が必須です。

• 他のすべての列ヘッダーは、カスタム詳細フィールド名と一致する必要があります。

組織の場合:

• 列ヘッダーとして [組織名] が必須です。

• 他のすべての列ヘッダーは、カスタム詳細フィールド名と一致する必要があります。

ヘッダーがカスタム詳細フィールド名と一致しない列は無視されます。

複数選択ドロップダウン

複数選択ドロップダウン フィールド タイプを使用している場合は、プロジェクトにすべてのオプションが追加されていることを確認してください。オプションを CSV ファイルに追加するときは、コンマ (,) またはパイプ (|) を使用して区切ります。

ファイルの保存

CSV ファイルが UTF-8 エンコードで保存されていることを確認してください。

CSV ファイルをインポートする

1. サービス スペースから [カスタマー] を選択し、個別のカスタマーの詳細をインポートする場合は [カスタマー] タブを、組織の詳細をインポートする場合は [組織] タブを選択します。

2. [詳細を管理] > [CSV からインポート] の順に選択します。

3. インポートする対象を選択し、[続行]を選択します。

4. [参照] で CSV ファイルを選択し、[インポートを開始] を選択します。

インポートはバックグラウンドで行われ、他の作業を続けることができます。インポートのステータスを確認するには、[詳細をインポート] をもう一度選択します。

インポート・エラーの回避

インポート中、CSV ファイルの 1 つ以上の行がインポートされない場合があります。これにはいくつかの理由が考えられます。次にそのいくつかを挙げます。

• 値が空であることを示す ,, が行に含まれている

• ドロップダウン・フィールドを、ドロップダウンのオプションではない値に設定している

• 日付フィールドを間違った形式に設定している正しい形式は YYYY-MM-DD です

行に無効なフィールドが含まれていても、その行の有効な詳細フィールドはインポートされることに注意してください。エラーが発生した場合は、関連するフィールドを修正して、関連する行をもう一度アップロードしてください。