メインコンテンツへスキップ

インポート前の検証

ファイルをアップロードしてフィールドをマッピングした後、Twenty はインポートするにデータを検証します。 これにより、既存のデータに影響を与えることなく、エラーを検出して修正できます。

仕組み

  1. CSV ファイルをアップロード
  2. 列を Twenty のフィールドにマッピング
  3. 黄色で強調表示された潜在的なエラーを確認
  4. UI で直接エラーを修正
  5. インポートを確定

エラーの表示

問題のある行は 黄色 で強調表示されます。 次のことができます:
  • セルを直接編集してエラーを修正
  • 行を削除して完全にスキップ
このインライン編集により時間を節約できます—スプレッドシートに戻ってエラーを修正し、再アップロードする必要はありません。

よくあるエラーの種類

重複した値

原因: 一意のフィールド(メール、ドメイン)が Twenty に既に存在するか、ファイル内で 2 回出現しています。 対処:
  • インポート UI で重複値を編集
  • 重複行のいずれかを削除
一意性の適用方法の詳細は一意性制約を参照してください。

無効な形式

原因: データが期待される形式に一致していません(例: 無効なメールアドレス、日付形式の誤り)。 対処: セルを編集して正しい形式にする。 各フィールドタイプの期待される形式はフィールドマッピングを参照してください。

必須フィールドの欠落

原因: 必須フィールドが空です。 対処: 必須フィールドに値を入力するか、その行を削除する。

リレーションが見つかりません

原因: 参照しているレコードが存在しません(例: インポートされていない会社のドメイン)。 対処:
  • まず親レコードをインポートする
  • または参照値を修正する
正しいインポート順序とレコードの関連付け方法はリレーションのインポートを参照してください。

エラーを減らすためのヒント

  1. テンプレートをダウンロードして、ファイルをインポートする前に期待される形式を確認
  2. まずスプレッドシートでデータをクリーンアップ
  3. 正しい順序でファイルをインポートしてリレーションを取り込む(会社 → 人 → 商談)
  4. 小さなバッチでテストしてから全量インポート
  5. アップロード前に重複を確認
  6. ファイルあたりのレコード数を 10,000 に制限