カスタムオブジェクトレコードを一度に1つずつ追加するのではなく、CSV(カンマ区切り値)ファイルをインポートするやり方で、一度に複数のレコードをまとめて追加して更新できます。カスタムオブジェクトレコードを一括インポートできるのは管理者だけです。
この記事では、次のトピックについて説明します。
要件と制限
一括インポートには、以下の制限が適用されます。
- 1GBを超えるCSVファイルはインポートできません。最大500,000行を推奨します。これは、1つのヘッダー行と最大499,999行のデータです。さらに、各行のサイズは32KBを超えることはできません。
- インポートCSVファイルに含められる列は、最大で102列です。
- CSVファイル内に同じレコードを複数回含めないでください。インポートに失敗する可能性があります。
- CSVファイルに表示された順序でレコードが作成または更新される保証はありません。
- 一度にインポートできるCSVファイルは1つだけです。そのため、CSVファイルでサポートされている最大行数を超えるデータがある場合は、バッチごとに別々のファイルを作成し、順次インポートする必要があります。
- カスタムオブジェクトレコードの一括インポートは元に戻せません。すべての現在のレコード情報を含むCSVファイルをインポートする場合は、1つのレコードを使用して同じCSVファイルをテストし、意図したとおりにレコードがアップロードされることを確認してください。
カスタムオブジェクトレコードのCSVファイルを作成する
カスタムオブジェクトレコードを一括インポートするには、CSVファイルを使用します。ファイルを作成する際に注意すべき重要事項を以下に示します。
- このファイルは、適切なCSV形式であること、UTF-8エンコーディングを使用して保存されていることが必要です。
- CSVファイルの最初の行はヘッダー行です。
- ヘッダー行にはnameフィールドを含める必要があります。オプションとして、将来レコードを一括更新したい場合は、external_idフィールドも含める必要があります。ヘッダー行の他のフィールド名はすべて、カスタムオブジェクトのフィールドキーと完全一致する必要があります。
- ドロップダウンフィールドの値をインポートするには、カスタムドロップダウンフィールドのfield_keyを列見出しとして使用し、ユーザー向けの表示値ではなくオプションタグを指定します。
- ルックアップリレーションフィールドの値をインポートするには、カスタムルックアップリレーションフィールドのfield_keyを列見出しとして使用し、レコードのIDまたは外部IDのいずれかを指定します。レコードのIDを使用する場合は、値を指定します。外部IDを使用する場合は、external_id:valueというフォーマットを使用します。この”value”は関連レコードの外部IDの値に置き換えられます。
- データをインポートしないフィールドがある場合は、そのフィールドをヘッダー行に含めないでください。
- notes欄または複数行のカスタムフィールドに改行を追加するには、Alt + Enterキーを押すか(Windowsの場合)、Ctrl + Option + Returnキーを押します(macOSの場合)。
新しいカスタムオブジェクト用に既存のデータを埋め込むためにレコードの一括アップロードを行う場合は、カスタムオブジェクトのワークフローを計画することをお勧めします。このプロセスでは、カスタムオブジェクトごとにこのデータを含むスプレッドシートを作成することをお勧めします。Zendeskで作成したカスタムオブジェクトと上記のガイドラインに沿うように注意深く構造化すれば、スプレッドシートをCSVファイルとしてエクスポートし、この一括アップロードに使用することができます。この場合、必ずexternal_idの列を追加し、将来的に一括更新するオプションが必要な場合は、各レコードにIDを追加してください。
カスタムオブジェクトレコードのCSVファイルをインポートする
データインポーターを使用してCSVファイルをインポートし、新しいカスタムオブジェクトレコードを作成したり、既存のレコードを更新したりできます。また、「データインポーター」ページを通じて行われたすべてのインポートのログを取り込むことができます。
データインポーターを使用してカスタムオブジェクトレコードを作成または更新するには
- カスタムオブジェクトのレコードを一括アップロードする前に、Zendeskでカスタムオブジェクトを作成する必要があります。
- 管理センターで、サイドバーの「 オブジェクトとルール」をクリックし、「ツール」>「データインポーター」を選択します。
- 「インポート」をクリックします。
- 「インポートタイプ」で、次のいずれかを選択します。
- レコードの作成のみ:カスタムオブジェクトレコードの新規作成のみです。CSVファイル内の既存のレコードに関するデータは無視されます。
- レコードの更新のみ:CSVファイル内の既存のカスタムオブジェクトレコードを更新します。新しいレコードに関するデータはすべて無視されます。
- レコードの作成および更新:カスタムオブジェクトレコードを新規作成し、CSVファイル内の既存のカスタムオブジェクトレコードを更新します。
- 「保存先のターゲット」で、カスタムオブジェクトの名前を選択します。
- 「ファイルのアップロード」で、ファイルをドラッグ&ドロップするか、クリックしてアップロードし、ファイルブラウザからCSVファイルを選択します。
選択したファイルを変更する必要がある場合は、ファイル名の横にある削除アイコン()をクリックします。
- 「次へ」をクリックします。
- 「フィールドのマッピング」リストを確認します。
- フィールドマッピングが正しければ、「次へ」をクリックします。
- フィールドマッピングが正しくない場合は、「戻る」をクリックします。フォーマット要件に準拠するようにCSVファイルを編集し、ファイルを再アップロードします。
- 確認ダイアログでインポートの詳細の概要を確認し、「インポートを開始する」をクリックします。
インポートが開始された後は、インポートされた変更を元に戻すことはできません。インポートのステータスを確認するには、インポート履歴を確認してください。