概要
Twenty は、重複レコードを防ぎデータの整合性を確保するため、特定のフィールドに一意性を強制します。 これらの制約を理解することは、インポートを成功させるうえで不可欠です。デフォルトの一意のフィールド
| オブジェクト | 一意のフィールド |
|---|---|
| 連絡先 | id, email |
| 会社 | id, domain |
| カスタムオブジェクト | id のみ（デフォルト） |
id フィールドは Twenty の内部識別子で、各レコードに対して自動生成されます。 UUID 形式を使用します（例: c776ee49-f608-4a77-8cc8-6fe96ae1e43f）。カスタムの一意フィールド
追加の一意フィールドは 設定 → データモデル で定義できます:- 設定 → データモデル に移動します
- オブジェクトを選択する
- フィールドをクリックする
- フィールド設定で Unique を有効化する
カスタムの一意フィールドのユースケース
- 外部 ID: 他システムの ID を保存（Salesforce ID、HubSpot ID）
- ビジネス識別子: 従業員番号、顧客コード
- 代替連絡先情報: LinkedIn プロフィール、電話番号
フィールド名
id は Twenty の内部 ID 用に予約されています。 外部識別子には externalId や legacyId など別の名前を使用してください。インポート時の動作
新規レコードの作成
一意フィールドの値が存在しない場合は、新しいレコードが作成されます。既存レコードの更新
一意フィールドの値が既存レコードに一致する場合、そのレコードは新しいデータで更新されます。ソフト削除済みレコード
インポート時の重複検出
検証フェーズ中:- ファイル内の重複は黄色でハイライト表示されます
- インポートを開始する前に、UI から重複行を編集または削除できます
ベストプラクティス
- インポート前にファイルから重複を削除してください
- インポート前に Twenty で既存レコードを確認してください
- 他のシステムから移行する場合は、外部 ID を使用してください
- 既存レコードを更新したい場合は、一意フィールドを含めてください