> ## 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.

# インポートで既存のレコードを更新する

> CSV インポートを使用したレコードの一括更新のための完全なステップバイステップガイド。

## 概要

多数のレコードを一度に更新する必要がありますか？ 1 件ずつ編集する代わりに、CSV インポートを使って既存のレコードを一括更新しましょう。

**ユースケース：**

* 複数の連絡先の役職を更新する
* 会社情報を一括で変更する
* 新しいカスタムフィールドにデータを追加する
* 多数のレコードにわたるデータの誤りを修正する

## 仕組み

既存のレコードと一致する**一意の識別子**を含むファイルをインポートすると、Twenty は重複を作成せず、そのレコードを更新します。

| 一意の識別子が...    | Twenty は...              |
| ------------- | ------------------------ |
| 既存のレコードに一致する  | 既存のレコードを**更新**           |
| どのレコードにも一致しない | 新しいレコードを**作成**           |
| ファイルに含まれていない  | 新しいレコードを**作成**（ID は自動生成） |

<Warning>
  **複数選択フィールドはマージではなく上書きされます。**

  あるレコードで `Option A` と `Option B` が選択されている状態で `["Option C"]` をインポートすると、インポート後はそのレコードには `Option C` のみが残ります。 インポートは以前の選択をすべて置き換えます—追加はされません。

  既存の値を保持するには、インポートにすべて含めてください: `["Option A","Option B","Option C"]`
</Warning>

## ステップ 1: 現在のデータをエクスポートする

まず、更新したいレコードをエクスポートします。

1. オブジェクト（連絡先、会社など）に移動します。
2. **必要な列を追加** — 更新したいフィールドを表示するには **Options → Fields** をクリックします
3. **必要に応じてフィルター** — 更新対象のレコードのみに絞り込みます
4. **⋮** → **Export view** をクリック
5. CSV ファイルを保存します

<Note>**なぜ最初にエクスポートするのか？** エクスポートされたファイルは正しい形式で、一意の識別子を含み、インポート時に自動でマッピングされます。</Note>

### エクスポートされる内容

* 現在のビューで表示されているすべての列
* レコードの一意の識別子（`id`、`email`、`domain`）
* 変更可能な現在のフィールド値

## ステップ 2: CSV ファイルを編集する

エクスポートしたファイルを表計算アプリ（Excel、Google スプレッドシートなど）で開きます。

1. **一意の識別子の列は残す** — `id`、`email`、`domain` は削除しないでください
2. 変更したい列の値を**更新**します
3. **更新が不要な列は削除**（任意ですが、その方がすっきりします）
4. **一意の識別子の値は変更しないでください** — 変更すると Twenty が新しいレコードを作成します

### 例：役職の更新

**エクスポートしたファイル：**

```csv theme={null}
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Sales Rep
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Sales Rep
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Sales Rep
```

**編集後：**

```csv theme={null}
id,email,firstName,lastName,jobTitle
550e8400-e29b-41d4-a716-446655440001,john@acme.com,John,Smith,Account Executive
550e8400-e29b-41d4-a716-446655440002,jane@acme.com,Jane,Doe,Senior Account Executive
550e8400-e29b-41d4-a716-446655440003,bob@acme.com,Bob,Johnson,Account Executive
```

<Warning>
  **一意の識別子の値は変更しないでください。**

  `john@acme.com` を `john.smith@acme.com` に変更すると、Twenty は既存のレコードを更新せずに新しいレコードを作成します。
</Warning>

## ステップ 3: 更新したファイルをインポートする

1. 対象のオブジェクトに移動します
2. **⋮** → **Import records** をクリック
3. 編集した CSV ファイルをアップロードします
4. **一意の識別子がマッピングされていることを確認** — `email`、`domain`、または `id` が正しくマッピングされているか検証します
5. フィールドのマッピングを確認します
6. エラーがないか確認します
7. **Confirm** をクリック

Twenty は一意の識別子でレコードを照合し、新しい値で更新します。

## 適切な一意の識別子の選び方

| オブジェクト         | 推奨         | 代替   | ノート               |
| -------------- | ---------- | ---- | ----------------- |
| **連絡先**        | `メール`      | `id` | メールアドレスは人間が読みやすい  |
| **会社**         | `ドメイン`     | `id` | ドメインは人間が読みやすい     |
| **カスタムオブジェクト** | 任意の一意フィールド | `id` | カスタムの一意フィールドを使用する |

<Note>**一意の識別子は 1 つだけ使用してください。** `email` と `id` の両方をマッピングしないでください。 これは混乱やエラーの原因になります。</Note>

### カスタムの一意フィールドを使用する

一意としてマークされたカスタムフィールド（他システムの外部 ID など）がある場合：

1. そのフィールドをエクスポートとインポートに含めます
2. インポート時にマッピングします
3. Twenty はそのフィールドで照合します

## ステップ 4: 更新内容を確認する

インポート後：

1. 更新されたレコードをいくつか開きます
2. 変更が反映されていることを確認します
3. 重複レコードが作成されていないことを確認します

## ファイルに含まれていないフィールドはどうなりますか？

**インポートファイルに含まれていないフィールドは変更されません。**

| ファイルに含まれている項目...           | 結果                               |
| -------------------------- | -------------------------------- |
| `email`、`jobTitle`         | `jobTitle` のみ更新され、他のフィールドはそのままです |
| `email`、`jobTitle`、`phone` | `jobTitle` と `phone` が更新されます     |

つまり、変更したいフィールド（＋一意の識別子）だけを含めれば十分です。

## 更新と新規レコードの併用

同じインポートで既存レコードの更新と新規作成の両方が可能です。

```csv theme={null}
email,firstName,lastName,jobTitle
john@acme.com,John,Smith,Senior Manager    ← Updates existing (email matches)
newperson@acme.com,New,Person,Analyst      ← Creates new (email doesn't match)
```

## 避けるべき一般的なミス

| ミス             | 問題                                                        | 結果                  | 解決策                              |
| -------------- | --------------------------------------------------------- | ------------------- | -------------------------------- |
| **一意の識別子の変更**  | `john@acme.com` を `john.smith@acme.com` に変更した             | 更新ではなく新しいレコードが作成される | 一意の識別子は変更しない                     |
| **複数の一意フィールド** | `email` と `id` の両方をマッピングしている                              | 照合の競合が発生する可能性       | 一意の識別子は 1 つだけマッピングする             |
| **一意の識別子なし**   | ファイルには `firstName`、`lastName`、`jobTitle` しかない             | すべての行で新しいレコードが作成される | `email`、`domain`、または `id` を必ず含める |
| **大文字小文字の不一致** | ファイルは `John@acme.com` だが、Twenty では `john@acme.com` になっている | 新しいレコードを作成する        | 正確な値を取得するには Twenty からエクスポートする    |

## FAQ

<AccordionGroup>
  <Accordion title="一部のレコードがまだ存在しない場合はどうなりますか？">
    一意の識別子が既存レコードと一致しないレコードは新規レコードとして作成されます。 これにより、同じインポートで更新と新規作成の両方が可能になります。
  </Accordion>

  <Accordion title="フィールドの値をクリア（空に）できますか？">
    はい、CSV のセルを空白のままにしてください。 インポートにより、既存レコードのそのフィールド値がクリアされます。
  </Accordion>

  <Accordion title="インポートに含めなかったフィールドはどうなりますか？">
    インポートファイルにないフィールドは、既存レコード上で変更されません。 含めたフィールドのみが更新されます。
  </Accordion>

  <Accordion title="リレーションフィールド（Company など）を更新できますか？">
    はい! リレーションの一意の識別子（例：`companyDomain`）を含め、リレーションフィールドにマッピングします。 リレーションが更新されます。
  </Accordion>

  <Accordion title="どのレコードが更新され、どれが作成されるかはどのようにわかりますか？">
    インポートの確認ステップで、一意の識別子の一致に基づき、更新と作成の件数を Twenty が表示します。
  </Accordion>

  <Accordion title="一括更新を元に戻せますか？">
    自動で元に戻す機能はありません。 一括更新の前に、バックアップとしてデータをエクスポートすることをお勧めします。
  </Accordion>
</AccordionGroup>

## ベストプラクティス

1. **まずエクスポート** — 正しい形式を確実にするため、必ずエクスポートから始める
2. **更新前にバックアップ** — 大量の変更を行う前にデータをエクスポートする
3. **少数のレコードでテスト** — 大規模に実行する前に、まず 5～10 件で更新を試す
4. **人間が読みやすい識別子を使用** — `id` よりも `email` と `domain` の方が検証しやすい
5. **必要な列のみを含める** — 列が少ないほどエラーの可能性が減ります

## トラブルシューティング

お困りですか？ 次を確認してください:

* [インポートエラーを解決する方法](/l/ja/user-guide/data-migration/how-tos/fix-import-errors)
* [一意性制約](/l/ja/user-guide/data-migration/capabilities/uniqueness-constraints)
* [フィールドマッピングのリファレンス](/l/ja/user-guide/data-migration/capabilities/field-mapping)