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

You can import your customers' details and the details of their entitlements through an API or from a CSV file. This will update values into fields that already exist, but it will not add new fields, new customers, or new organizations. Before starting your import, make sure the customers and organizations you want to update already exist in your service project.

To add new customers before importing:
Use the bulk add feature to add new customers to your service project first. Add customers in bulk to your service space | Jira Service Management Cloud | Atlassian Support

To add new organizations before importing:
Use the REST API to create new organizations first.The Customer Service Management REST API

If you want to import details for fields that don't exist, you need to create these fields before starting your import. You must be a Jira admin to import customer and organization details.

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 です

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