CSV 形式でリストを作成

コンマ区切り値(.csv)形式でレコードをアップロードしてリストを作成します。準拠したいデータをフォーマットする .csv構文 リストにアップロードまたは追加する前に、UTF-8でエンコードされています。

  • 各レコードは、改行または復帰/改行のペアで終了する1行です。
  • 列名に円記号などの特殊文字を含めることはできません。
  • データ項目（フィールドと呼ばれる）を区切るにはコンマを使用します。
  • 最初の行は、コンマで区切られたフィールド名のヘッダー行でなければなりません。
  • スペースまたはカンマを含むフィールドは二重引用符で囲みます。
  • 先頭または末尾のスペースを含む文字列を二重引用符で囲みます。
  • フィールドが空の場合は、レコード内のその位置にコンマを挿入します。
  • コンマを含むフィールドは、二重引用符で囲んでください。
  • フィールドに二重引用符が含まれる場合は、フィールド全体を二重引用符で囲み、各二重引用符を2つの二重引用符に変換します。
  • .CSVファイルでは、データの末尾に空白行が含まれていてはいけません。インポートが失敗する可能性があります。。

必須の列

.csvファイルには、少なくとも1列の電話番号を含める必要があります。たとえば、単一の列は「連絡先なし」リストに適しています。

電話
317-123-4567
…

注意：先頭のプラス記号(+)と E.164 フォーマットされた数値。

ほとんどの連絡先リストには、連絡先名やアカウントコードなど、さらに多くの列が必要です。.csv ファイルで必要なすべての列を定義するようにしてください。

ファイルをアップロードして新しいリストを作成すると、システムはクラウド内に一致する列を持つテーブルを作成します。その後、異なる列のセットを含むデータを追加することはできません。

50列を超えないでください

連絡先リストで許可される列の最大数は 50. この新しい連絡先リストがその制限を超えた場合、エラーメッセージが表示されますが、イベントビューアーにエントリが表示されません。

列名は一意である必要があります

最初の行のすべての列名は一意でなければなりません。列名を複製すると、ファイルはインポートされません。

一意の識別子列を含める

各行を一意に識別する列を.csvに含めます。これを行うことで、今後、新規データまたは更新データを正確に追加できます。一般的な固有 ID はカスタマー ID やアカウント番号などです。後で、あなたが レコードを追加する 連絡先リストで、[一意の識別子]列を選択します。その列を使用することで、レコードを追加する際に、既存の連絡先と今後のデータが最も正確に一致します。

一意の識別子がないと、行全体が主キーになります。変更されたレコードを付加している場合、後続のアップロード既存の行は、同じ識別子を持つ場合でも、そのレコードが新しい行として追加します。これは、リストをエクスポートし、変更して、データを追加 (またはアップロード) するときに期待される動作ではありません。

一意の識別子を使用すると、代わりに既存のレコードが置き換えられます。

一意の識別子に特殊文字を使用しない

英数字から一意の識別子を構成できます。スペース、 バックスラッシュこれらの特殊文字はURLでは機能しません。

- 。_〜：/？＃[] @！ $＆ ’（）* +、 ; =

ゾーン列を使用する

連絡先リストレコードには、職場、携帯、自宅の番号など、連絡先ごとに複数の電話番号が格納されていることがよくあります。を使用するには、 コール可能な時間 各電話番号列には、 Tz データベース フォーマット。例えば、[自宅タイムゾーン] という名前の列には、[自宅の電話] 列の各電話番号に対応するタイムゾーンが含まれています。連絡先リストでは、ゾーン列は使用しません。

  • ベストプラクティスとして、連絡先リストを作成するときに、各電話番号の列（自宅や職場など）に対応する一意のIDとゾーンの列の両方を指定します。

  • 後でゾーン列を追加することはできませんが、同じ一意のIDを持つレコードを追加（アップロード）することで既存のゾーン列を作成または更新できます。Genesys Cloudが一致する行を見つけると、追加ファイルのデータを使用して列を更新します。例えば、.csv ファイルから読み取られたタイムゾーン データを含むレコードのゾーン列が更新されます。ゾーン列は必須です。

  • 各タイムゾーン列を連絡先番号列に関連付けます。これは通常、リストを作成するときに行います。関連付けることを忘れても、連絡先リストを後で編集し、ゾーン列ドロップ リストで項目を選択して、タイムゾーン列と電話番号列をマッピングすることができます。

    図は、電話番号列とタイムゾーンを特定する列を関連付ける方法を示しています

テキストエディタの代わりにスプレッドシートを使用して.csvファイルを編集する

スプレッドシートエディタから.csvとして保存することをお勧めします。スプレッドシートで .csv ファイルを保存すると、必要な引用符とコンマが自動的に挿入されます。スプレッドシートを使用して、以下のエラーが生じやすい手動でレコードのフォーマットよりもです。

spreadsheet_data

たとえば、 ファイル > ; 名前を付けて保存 > ; CSV（カンマ区切り） Microsoft Excelのコマンドは、次の.csvレコードを生成します。

Last Name, First Name,Home Phone, Home Time Zone,Cell Phone,Cell Time Zone,Balance Due,Account Code,HomeAddress
Doe,"James ""Big John""",317-123-4567,America/Indiana/Indianapolis,317-987-6543,America/Indiana/Indianapolis,175,1003,"123 Anystreet, Indianapolis, IN"
Downing,Mary,424-999-2334,America/Los_Angeles,,,234,3799,"724 Bel Air Drive, Los Angeles, CA"