snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/ja/user-guide/data-migration/how-tos/prepare-your-csv-files.mdx

@@ -0,0 +1,267 @@
+---
+title: CSV ファイルを準備する
+description: Twenty へのインポート用にデータをフォーマットするための、完全なステップバイステップガイド。
+---
+
+## 概要
+
+このガイドは、インポートを成功させるための CSV ファイルの準備方法を順を追って説明します。 エラーを避けるために、次の手順に従ってください。
+
+## ステップ 1: ファイル要件を確認する
+
+開始する前に、ファイルが次の要件を満たしていることを確認してください。
+
+| 要件           | 詳細                    |
+| ------------ | --------------------- |
+| **形式**       | CSV、XLSX、または XLS      |
+| **サイズ上限**    | 1 ファイルあたり 10,000 レコード |
+| **エンコーディング** | UTF-8 推奨              |
+| **構造**       | ファイルごとに 1 つのオブジェクトタイプ |
+
+<Note>10,000 レコードを超えるデータセットは、複数のファイルに分割するか、[API インポート](/l/ja/user-guide/data-migration/how-tos/import-data-via-api)を使用してください。</Note>
+
+## ステップ 2: サンプルファイルをダウンロードする
+
+**これは最も重要なステップです。** サンプルファイルには、Twenty が想定する正確な列名と形式が示されています。
+
+1. オブジェクトビュー（People、Companies など）に移動します。
+2. 「**⋮**」→「**Import records**」をクリックします。
+3. 「**Download sample file**」をクリックします。
+4. このファイルをテンプレートとして使用してください。
+
+<Note>**プロのヒント:** 代わりに、既存のレコードを少数エクスポートします。 これにより、データのあるべきフォーマットの実例が得られ、インポート時に列名が自動的にマッピングされます。</Note>
+
+## ステップ 3: 重複値を削除する
+
+Twenty は一部のフィールドに一意性を強制します。 重複はインポートエラーの原因になります。
+
+| オブジェクト         | 一意のフィールド                 |
+| -------------- | ------------------------ |
+| **People**     | `id`, `email`            |
+| **会社**         | `id`, `domain`           |
+| **カスタムオブジェクト** | `id` に加え、一意に設定した任意のフィールド |
+
+**インポート前に:**
+
+1. スプレッドシートを一意フィールド（email または domain）で並べ替えます。
+2. 重複行を削除または統合します。
+3. Twenty に既に存在する重複がないか確認します。
+
+<Warning>**ソフト削除されたレコードも一意性の判定に含まれます。** Command Menu → See deleted records にあるレコードは重複エラーの原因になります。 それらを完全に削除するか、復元して更新してください。</Warning>
+
+## ステップ 4: 各フィールドタイプを正しくフォーマットする
+
+フィールドタイプごとに必要な形式が異なります。 完全なリファレンスは次のとおりです。
+
+### テキストフィールド
+
+* 特別なフォーマットは不要です
+* 先頭/末尾の空白は自動的にトリムされます
+
+### メールフィールド
+
+* 有効なメール形式である必要があります: `name@domain.com`
+* 一意である必要があります（ファイル内および Twenty 内に重複がないこと）
+* 追加のメールについては、**Emails / Additional Emails** 列で次の形式を使用します:
+
+```
+["jane@twenty.com","jane.doe@twenty.com"]
+```
+
+### ドメインフィールド
+
+* **推奨形式**: `https://domain.com`
+* これはメールボックス/カレンダーの同期で使用される形式と一致します（重複を防止）
+* 両方の列を入力してください。
+  * **Domain / Domain Label**: `domain.com`
+  * **Domain / Domain URL**: `https://domain.com`
+* ファイル内および Twenty 内で一意である必要があります
+
+### 電話番号フィールド
+
+電話番号は、複数の列を必要とする**ネストされたフィールド**です:
+
+| 列                                       | 例            |
+| --------------------------------------- | ------------ |
+| **Phones / Primary Phone Number**       | `4159095555` |
+| **Phones / Primary Phone Country Code** | `US`         |
+| **Phones / Primary Phone Calling Code** | `+1`         |
+
+### 住所フィールド
+
+住所は複数列からなる **入れ子のフィールド** です（空欄のままでよい列もあります）:
+
+* **Address / Address 1**: 住所の 1 行目（番地など）
+* **Address / Address 2**: 住所の 2 行目（任意）
+* **Address / City**: 市区町村名
+* **Address / State**: 州または都道府県
+* **Address / Country**: 国名
+* **Address / Post Code**: 郵便番号（ZIP コード）
+
+### 日付フィールド
+
+ファイル全体で形式を統一してください:
+
+* `YYYY-MM-DD`（推奨）: `2024-03-15`
+* ISO 8601: `2024-03-15T10:30:00Z`
+
+### 数値フィールド
+
+* 数値のみ（テキスト不可）
+* 小数点はピリオドを使用: `1234.56`
+* 桁区切りを使用しない（`1,234.56` は不可）
+
+### 通貨フィールド
+
+通貨は **2 列を要する入れ子のフィールド** で、**両方に入力が必要** です:
+
+| 列                     | 例         |
+| --------------------- | --------- |
+| **Amount / Amount**   | `1234.56` |
+| **Amount / Currency** | `USD`     |
+
+### ブール値フィールド
+
+大文字を使用: `TRUE` または `FALSE`
+
+<Warning>小文字の `true` や `false` は動作しません。</Warning>
+
+### 選択フィールド
+
+表示ラベルではなく、オプションの **API 名** を使用してください。
+
+**API 名の見つけ方:**
+
+1. **設定 → データモデル** に移動する
+2. オブジェクトとフィールドを選択
+3. **高度なモード** を有効化（右下のトグル）
+4. API 名をコピー（例: `OPTION_1`。"Option 1" ではありません）
+
+<Note>新しい選択肢は自動的に作成されません。 インポート前に **設定 → データモデル** で追加してください。</Note>
+
+### 複数選択フィールド
+
+API 名を配列形式で記述します:
+
+```
+["VALUE1","VALUE2"]
+```
+
+### 配列フィールド
+
+JSON 配列形式を使用します:
+
+```
+["value1","value2"]
+```
+
+### 評価フィールド
+
+次の形式を使用: `RATING_1`、`RATING_2`、`RATING_3`、`RATING_4`、または `RATING_5`
+
+### リンク/URL フィールド
+
+両方の列を入力:
+
+* **Links / Link Label**: `Twenty`
+* **Links / Link URL**: `https://twenty.com`
+
+二次リンクは **Links / Secondary Links** 列を使用します:
+
+```
+[{"url":"https://twenty.com","label":"Twenty"}]
+```
+
+### JSON フィールド
+
+有効な JSON 形式を使用します:
+
+```
+{"key":"value","key2":"value2"}
+```
+
+### ID フィールド
+
+* **任意**: 指定がない場合、Twenty が ID を自動生成します
+* **形式**: UUID（例: `c776ee49-f608-4a77-8cc8-6fe96ae1e43f`）
+* **用途**: 新規作成ではなく既存レコードを更新する場合は ID を含めます
+
+## 手順5: リレーション列を追加（レコードをリンクする場合）
+
+レコードを他のオブジェクトにリンクするには（例: People を Companies にリンク）、関連レコードの一意の識別子を含む列を追加します。
+
+**例**: People を Companies にリンク
+
+People の CSV に列を追加:
+
+```
+firstName,lastName,email,companyDomain
+John,Smith,john@acme.com,https://acme.com
+Jane,Doe,jane@widgets.co,https://widgets.co
+```
+
+**リレーションに関する重要なルール:**
+
+* 親レコードは事前に Twenty に存在している必要があります
+* ラベルではなく **ドメイン URL** 形式（`https://domain.com`）を使用してください
+* 一意の識別子は 1 つだけマッピングしてください（`companyId` と `companyDomain` を両方含めない）
+* ワークスペースメンバーには **メールアドレス**（氏名ではなく）を使用してください
+
+<Warning>
+**インポート順序は重要です！**
+
+「1」側を「多」側より先にインポートしてください:
+1. **会社** を先に
+2. **People** を 2 番目（会社参照付き）
+3. **商談** を 3 番目に
+
+参照する前に親レコードが存在している必要があります。
+</Warning>
+
+詳細な手順については、[リレーションをインポートする方法](/l/ja/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)を参照してください。
+
+## 手順6: Twenty にフィールドが存在することを確認
+
+インポートで作成されるのはフィールドではなくレコードです。 インポートしたいフィールドはすべて、あらかじめデータモデルに存在している必要があります。
+
+**インポート前に:**
+
+1. **設定 → データモデル** に移動する
+2. 対象オブジェクトを選択する
+3. 必要なカスタムフィールドを作成する
+4. フィールド名の正確な表記を控える（列ヘッダーと一致している必要があります）
+
+## 手順7: 最終チェックリスト
+
+ファイルをアップロードする前に、次を確認してください:
+
+<Check>ファイル形式が CSV、XLSX、または XLS である</Check>
+<Check>ファイルのレコード数が 10,000 未満である</Check>
+<Check>エンコーディングが UTF-8 である</Check>
+<Check>（People）では重複するメールがなく、（Companies）では重複するドメインがない</Check>
+<Check>日付の形式が全体で統一されている</Check>
+<Check>ドメインが `https://domain.com` 形式である</Check>
+<Check>ブール値フィールドは `TRUE` または `FALSE`（大文字）を使用している</Check>
+<Check>選択フィールドは表示ラベルではなく API 名を使用している</Check>
+<Check>すべてのカスタムフィールドが 設定 → データモデル に存在する</Check>
+<Check>子レコードより先に親レコードをインポートしている</Check>
+<Check>リレーション列が既存レコードを参照している</Check>
+
+## 避けるべき一般的なミス
+
+| 誤り                               | 解決策                                     |
+| -------------------------------- | --------------------------------------- |
+| `TRUE` の代わりに `true` を使用している      | ブール値は大文字である必要があります                      |
+| 選択フィールドで表示ラベルを使用している             | 設定で API 名を確認して使用する                      |
+| Companies より先に People をインポートしている | 常に親オブジェクトから先にインポートする                    |
+| 通貨フィールドで通貨コードが欠けている              | Amount と Currency の両方の列を入力する            |
+| ドメインの形式が誤っている                    | `https://domain.com` を一貫して使用する          |
+| リレーションで複数の一意フィールドをマッピングしている      | 1 つだけをマッピングする（domain か id のどちらかで、両方は不可） |
+
+## 次のステップ
+
+ファイルの準備ができました！ 次へ:
+
+* [会社をインポート](/l/ja/user-guide/data-migration/how-tos/import-companies-via-csv)（これを先にインポート）
+* [コンタクトをインポート](/l/ja/user-guide/data-migration/how-tos/import-contacts-via-csv)
+* [インポートエラーを修正](/l/ja/user-guide/data-migration/how-tos/fix-import-errors)