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

Documentation Index

Fetch the complete documentation index at: https://docs.twenty.com/llms.txt

Use this file to discover all available pages before exploring further.

インポート前の検証

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

仕組み

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

エラーの表示

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

よくあるエラーの種類

重複した値

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

無効な形式

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

必須フィールドの欠落

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

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

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

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

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