組織の一括インポート

注意：データインポーターは現在オープンベータ版で提供されています。管理センターの「組織のインポート」ページは、このベータ期間中も利用可能です。

組織を1回に1つずつ追加するのではなく、CSV（カンマ区切り値）ファイルをインポートするやり方で、一度に複数の組織をまとめて追加できます。一括インポートを使用して、組織の追加や組織の更新ができます。組織を一括インポートできるのは管理者だけです。複数のユーザーを一括で追加または更新することもできます（「ユーザーの一括インポート」を参照）。

メモ：組織とユーザーの両方を一括インポートする場合は、組織を先に一括インポートする必要があります。ユーザーの一括インポートの詳細については、「ユーザーの一括インポート」を参照してください。

組織の一括インポートは元に戻せません。すべての組織の情報を含むCSVファイルをインポートする場合は、まず、1つの組織レコードを使用して同じCSVファイルのアップロードを試してみて、アップロードが意図したとおりに動作することを確認してください。

この記事では、次のトピックについて説明します。

• ユーザーおよび組織の一括インポートに伴う制限
• CSVファイルの組織データを作成する
• 組織データのCSVファイルをインポートする

ユーザーおよび組織の一括インポートに伴う制限

ユーザーと組織に関する主要なデータセットをインポートできます。たとえば、一括インポートを使用して、後述の表に示すデータをインポートできます。ただし、タイムゾーン、写真、言語設定などはインポートできません。後述の表にないデータをインポートするには、代わりにZendesk REST APIを使用する必要があります。「Importing users with the Zendesk API（Zendesk APIを使用したユーザーのインポート）」または「Importing organizations with the Zendesk API（Zendesk APIを使用した組織のインポート）」を参照してください

また、一括インポートには、以下の制限もあります。

• 最大行数はインポート方法によって異なります。
  • ユーザーデータおよび既存の組織データの更新の場合、インポートCSVデータファイルには最大2,000行まで含めることができます。つまり、ヘッダー1行とデータ1,999行までです。
  • データインポーター（ベータ版）を使用して新しい組織データを作成する場合、インポートCSVファイルのサイズは1GBを超えることはできません。最大500,000行を推奨します。つまり、1行のヘッダーと最大499,999行のデータです。さらに、各行のサイズは128 KBを超えることはできません。
• データインポーターを使用する場合は、次の制限も適用されます。
  • インポートCSVファイルに含める列は、最大で200列です。
  • インポートCSVファイルでは、行のインポート順序は保証されません。
• 一度にインポートできるCSVファイルは1つだけです。そのため、CSVファイルでサポートされている最大行数を超えるデータがある場合は、バッチごとに別々のファイルを作成し、順次インポートする必要があります。データインポーターを使用していない場合は、最大2つのバッチがキューに入れられ、バックグラウンドで実行されます。2つ以上のバッチをインポートしたい場合は、最初のバッチのインポートが完了するまで待ってから追加する必要があります。
• FacebookまたはX（旧Twitter）アカウントからの連絡先情報のインポートに、一括インポートを使用することはできません。代わりに、Zendesk REST APIを使用してください。「Importing users with the Zendesk API（Zendesk APIを使用したユーザーのインポート）」を参照してください。

CSVファイルの組織データを作成する

組織を一括インポートする場合、CSV形式の組織データファイルを使用します。このセクションでは、CSVデータファイルの設定方法について説明します。

ファイルを作成する際に注意すべき重要事項を以下に示します。

• このファイルは、適切なCSV形式であること、UTF-8エンコーディングを使用して保存されていることが必要です。
• CSVファイルの最初の行はヘッダー行です。
• ヘッダー行には、以下の表内の必須フィールドを必ず含めます。さらに、必須フィールド以外のフィールドも任意に選んで追加することができます。
• データをインポートしないフィールドがある場合は、そのフィールドをヘッダー行に含めないでください。
• ファイル内に空のデータ列があると、組織の既存のデータが、空のデータで上書きされます。
• notes欄または複数行のカスタムフィールドに改行を追加するには、Alt + Enterキーを押すか（Windowsの場合）、Ctrl + Option + Returnキーを押します（macOSの場合）。

以下の表に、ファイルに含めることにできるフィールドを示します。

表1. 組織のインポート用データ

フィールド	説明
name	必須入力。組織の名前。
external_id	オプションだが推奨。将来データインポーターを使用してこれらのレコードを更新する場合に必要です。外部システムの従業員ID番号や顧客ID番号など、一意に識別される値。
notes	組織に関するメモ。メモを見ることができるのはエージェントだけです。エンドユーザーの画面には表示されません。
details	住所など、組織に関する詳しい情報。この情報を見ることができるのはエージェントだけです。エンドユーザーの画面には表示されません。
default	ユーザーと組織との対応付けに使用される情報。1つ以上のメールドメインをスペースで区切って入力してください（例：organization1.com organization2.com）。 詳しくは「メールドメインに基づいて自動的にユーザーを組織に追加する」を参照してください。
shared	TrueまたはFalse。組織で組織で共有を有効にするかどうかを設定します。 「エンドユーザーのために組織で共有機能を設定する」を参照してください。
shared_comments	TrueまたはFalse。組織内のエンドユーザーが互いのチケットにコメントを追加できるようにします。sharedフィールドもtrueに設定する必要があります。 「エンドユーザーのために組織で共有機能を設定する」を参照してください。
group	組織のデフォルトグループを指定します。「グループを組織にマッピングする」を参照してください。
tags	Zendesk Supportでユーザーと組織のタグ付けが有効になっている場合（「ユーザーおよび組織へのタグの追加」を参照）、組織にタグを設定できます。複数のタグを追加する場合は、スペースで区切ります。 組織名を一括インポートすると、既存の組織名タグがCSVファイル内のタグで上書きされます。これを避けるには、Tag APIを使用してタグを更新する方法があります。
custom_fields.<field key>	組織の一括インポートを実行する場合、「custom_fields.」という接頭辞に続いてフィールドキーを指定することで、カスタム組織フィールドをインポートできます。  たとえば、subscription_dateというフィールドキーのフィールド値をインポートするには、次のように指定します。 custom_fields.subscription_date カスタム組織フィールドのキーを見つけるには、管理アイコン（）をクリックして「組織フィールド」を選択し、目的のカスタムフィールドの名前をクリックします。フィールドキーが、右側のプロパティパネルに表示されます。 フィールドの値の形式が正しくないと、インポートは失敗します。そして、保存に失敗したレコードを示すエラーレポートが表示されます。カスタム日付フィールドには、YY/MM/DDまたはYYYY-MM-DDの形式を使用してください。チェックボックスフィールドでは、TrueまたはFalseのいずれかを使用します。ドロップダウンリストオプションの値を設定するには、ドロップダウンリストの作成時に追加したタグを使用します。 メモ：インポートするカスタム組織フィールドがルックアップリレーションシップフィールドの場合、このフィールドの値として、関連オブジェクトのIDを入力します。たとえば、組織の場合は組織のIDを入力し、ユーザーの場合はユーザーのIDを入力します。組織やユーザーのIDを調べるには、アカウントからデータをエクスポートするか、Organizations APIまたはUsers APIを使用します。 「データインポーター」ページで組織をインポートする場合、ルックアップリレーションシップフィールドはサポートされません。 詳しくは「組織プロフィールへのカスタムフィールドの追加」を参照してください。

組織データのCSVファイルをインポートする

一括インポートを使用して、新しい組織を作成したり、既存の組織の情報を更新したりできます。

インポート操作がキューに追加され、組織は、インポート処理が完了したときにZendesk Supportに追加されます。この処理は、ファイルごとに1時間ほどかかりますが、ファイルサイズやキューサイズによって異なります。「ユーザーおよび組織の一括インポートに伴う制限」を参照してください。

データインポーターを使用して新しい組織を作成する（ベータ版）

データインポーターはベータ版リリースです。新しい組織を作成するCSVファイルをインポートしたり、「データインポーター」ページでインポートを試みたすべてのログを取得したりするために使用できます。ベータ期間中は、データインポーターを使用して既存の組織データを更新することはできません。

データインポーターを使用して新しい組織を作成するには

1. 管理センターで、サイドバーの「 オブジェクトとルール」をクリックし、「ツール」>「データインポーター」を選択します。
2. 「インポート」をクリックします。
3. 「保存先のターゲット」で、「組織」を選択します。
4. 「ファイルのアップロード」で、ファイルをドラッグ＆ドロップするか、クリックしてアップロードし、ファイルブラウザからCSVファイルを選択します。

   選択したファイルを変更する必要がある場合は、ファイル名の横にある削除アイコン（）をクリックします。

5. 「次へ」をクリックします。
6. 「フィールドのマッピング」リストを確認します。
   • フィールドマッピングが正しければ、「次へ」をクリックします。
   • フィールドマッピングが正しくない場合は、「戻る」をクリックします。フォーマット要件に準拠するようにCSVファイルを編集し、ファイルを再アップロードします。
7. 確認ダイアログでインポートの詳細の概要を確認し、「インポートを開始する」をクリックします。

   インポートが開始された後は、インポートされた変更を元に戻すことはできません。インポートのステータスを確認するには、インポート履歴を確認してください。

CSVインポートを使用して既存の組織データを更新する

「データインポーター」ページは、ベータ期間中にCSVインポートで新しい組織を作成する場合にのみ使用できます。CSVインポートを使用して既存の組織を更新する必要がある場合は、「管理センター」>「メンバー」>「一括アクション」>「組織のインポート」ページを使用する必要があります。このページを使用して、新しい組織を作成することもできます。インポートが完了すると、その旨を通知するメールが届きます。

CSVインポートで組織を更新するには

1. 管理センターで、サイドバーにある「 メンバー」をクリックし、「一括アクション」>「組織のインポート」を選択します。
2. 実行するインポートのタイプを選択します。

   • 組織を新規作成

   • 既存の組織を更新：​このタイプのインポートを使用して、CSVファイルにリストされている組織の既存のデータを置き換えます。

     組織を識別できるように、組織のexternal_idフィールドかnameフィールドをCSVに含める必要があります。組織の識別子フィールド以外は、ファイルには更新するフィールドのみを含めるようにします。組織の行に空白のフィールドがある場合は、その組織の既存のデータが上書きされます。

3. 「ファイルを選択」または「代わりに自分でデータ内に貼り付ける」リンクをクリックします。
4. 「インポート」をクリックします。

   インポートが開始された後は、インポートされた変更を元に戻すことはできません。

5. （オプション）「管理センター」>「オブジェクトとルール」>「ツール」>「データインポーター」ページで、進行中のインポートのステータスを表示します。インポートが完了すると、そこでインポート履歴ログに記録されます。