CSV 形式でリストを作成

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

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

    必須の列

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

    電話 
    317-123-4567

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

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

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

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

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

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

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

    一意の識別子列を含める

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

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

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

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

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

    - 。 _ ~ : / ? # [ ] @ ! $ & ‘ ( ) * + , ; =

    ゾーン列を使用する

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

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

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

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

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

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

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

    spreadsheet_data

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

    姓、名、自宅の電話番号、自宅のタイムゾーン、携帯電話、携帯電話のタイムゾーン、期限、アカウントコード、自宅の住所
    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"