組織の一括インポート

組織を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行はヘッダーとして使用され、残りの行にはユーザーデータまたは組織データが含まれます）。
• 一度にインポートできるCSVファイルは1つだけで、各ファイルのデータは2,000行以内である必要があります。このため、1,999を超えるユーザーまたは組織をインポートする場合は、ファイルをバッチごとに分けて作成し、バッチを1個ずつインポートする必要があります。最大2個のバッチをキューに入れて、バッググラウンドで実行することができます。3個以上のバッチをインポートするには、最初のバッチのインポートが終了してから、3個目のバッチを追加するようにしてください。
• FacebookまたはTwitterアカウントからの連絡先情報のインポートに、一括インポートを使用することはできません。代わりに、Zendesk REST APIを使用してください。「Importing users with the Zendesk API（Zendesk APIを使用したユーザーのインポート）」を参照してください。

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

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

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

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

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

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

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

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

この操作により、新しい組織のデータをインポートするだけでなく、既存の組織の情報も更新することができます。

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

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

   • 組織を新規作成

   • 既存の組織を更新：​このタイプのインポートを使用して、CSVファイルにリストされている組織の既存のデータを置き換えます。ファイルには、更新したいフィールドだけを含めるようにします。空のデータ列がある場合、組織の既存のデータが上書きされ、空白になります。

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

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