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/export-your-data.mdx

@@ -0,0 +1,209 @@
+---
+title: データをエクスポート
+description: Twenty からデータをエクスポートするための完全なステップバイステップガイド。
+---
+
+import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
+
+## 概要
+
+バックアップ、レポート作成、または移行のために、ワークスペースのデータを CSV にエクスポートします。
+
+**ユースケース：**
+
+* **定期的なバックアップ** — データのコピーを保持
+* **外部レポーティング** — Excel、Google スプレッドシート、BI ツールでデータを分析
+* **移行** — データを別のシステムに移す
+* **一括更新** — エクスポートして編集し、再インポートしてレコードを更新
+
+## 知っておくべきこと
+
+### エクスポートの制限
+
+* 1 回のエクスポートにつき **最大 20,000 件のレコード**
+* **表示されている列**のみがエクスポートされます
+* **フィルターで絞り込まれたレコード**のみがエクスポートされます（現在のビューに基づきます）
+
+<Note>大規模なエクスポート（20,000 件超）では、フィルターを使ってバッチに分けてエクスポートするか、[API](/l/ja/developers/extend/api) を使用してください。</Note>
+
+### 権限
+
+データをエクスポートするには **"Export CSV"** 権限が必要です。 このオプションがない場合は、ワークスペース管理者に連絡してください。
+
+## ステップ 1：対象オブジェクトに移動
+
+エクスポートしたいオブジェクトに移動します：
+
+* **People** — 連絡先
+* **Companies** — 組織
+* **Opportunities** — 商談
+* **カスタムオブジェクト** — 作成した任意のオブジェクト
+
+## ステップ 2：ビューを設定
+
+**重要:** エクスポートには現在のビューで表示されているもののみが含まれます。
+
+### 列の追加/削除
+
+1. **Options → Fields** をクリックします（または列の末尾の **+** をクリックします）
+2. エクスポートしたいフィールドにチェックを入れる
+3. 不要なフィールドのチェックを外す
+
+### レコードをフィルター（任意）
+
+データの一部だけが必要な場合：
+
+1. **Filter** をクリックします
+2. フィルター条件を追加します（例："Created date > January 1, 2024"）
+3. 条件に一致するレコードのみがエクスポートされます
+
+### レコードを並べ替え（任意）
+
+1. 列ヘッダーをクリックして並べ替えます
+2. エクスポートは並べ替え順に従います
+
+<Note>**エクスポート専用のビューを作成しましょう。** エクスポート用に設定したビューを保存しておくと、毎回再設定する必要がありません。</Note>
+
+## ステップ 3：データをエクスポート
+
+1. テーブル右上の **⋮** アイコンをクリックします
+2. **Export view** を選択します
+3. CSV ファイルの保存場所を選択します
+4. ダウンロードの完了を待ちます
+
+## エクスポートされる内容
+
+| 含まれるもの            | 含まれないもの          |
+| ----------------- | ---------------- |
+| 表示されているすべての列      | 非表示の列            |
+| 現在のフィルターに一致するレコード | フィルターで除外されたレコード  |
+| カスタムフィールドの値       | ビューに含まれていないフィールド |
+| レコード ID           | 添付ファイル           |
+| リレーション ID         | 画像               |
+
+### リレーションフィールド
+
+リレーション ID はリレーションシップの **"many" 側** でのみエクスポートされます：
+
+* **People のエクスポート** には `companyId` 列が含まれます（People → Company のリレーション）
+* **Companies のエクスポート** には `peopleIds` は含まれません（Companies は "one" 側です）
+
+つまり、People のエクスポートを使用して再インポートすれば Company とのリンクを維持できますが、関係を再作成するには Companies の後に People を再インポートする必要があります。
+
+## 目的別のエクスポート
+
+### バックアップの場合
+
+1. **すべてのフィールド** を表示したビューを作成
+2. すべてのフィルターを解除して全レコードを含める
+3. 各オブジェクトタイプを個別にエクスポート
+4. エクスポートファイルを安全な場所に保管
+5. 定期的なリマインダーを設定（毎週/毎月）
+
+### 外部レポーティングの場合
+
+1. 分析に必要なフィールドのみを含める
+2. フィルターを適用して関連データに絞り込む
+3. 分析対象のフィールドで並べ替えることを検討
+
+### 一括更新の場合
+
+1. 更新したいレコードをエクスポート
+2. 一意の識別子（`email`、`domain`、または `id`）を含める
+3. エクスポートしたファイルを編集
+4. 再インポートしてレコードを更新します
+   参照：[既存レコードを更新する方法](/l/ja/user-guide/data-migration/how-tos/update-existing-records-via-import)
+
+### マイグレーションの場合
+
+別のシステムへマイグレーションするためにエクスポートする場合：
+
+1. **各オブジェクトを個別にエクスポート** — People、Companies、Opportunities など
+2. **ID フィールドを含める** — 関係の維持に役立ちます
+3. **フィールドのマッピングを文書化** — Twenty のフィールドが対象システムにどのように対応するかを記録
+
+## 大規模データセットの扱い（20,000 件超）
+
+エクスポートの上限は 20,000 件です。 より大きなデータセットの場合：
+
+### オプション 1：バッチでエクスポート
+
+1. フィルターを追加（例："Created date" の範囲）
+2. 最初のバッチをエクスポート
+3. フィルターを変更
+4. 次のバッチをエクスポート
+5. スプレッドシートでファイルを結合
+
+**バッチ分割の例となるフィルター：**
+
+* 日付範囲別（1月、2月、3月...）
+* 担当者別（チームメンバー A、チームメンバー B...）
+* ステータス別（Active、Inactive...）
+
+### オプション 2：API を使用
+
+API にはレコード数の上限がありません：
+
+1. **Settings → Developers** から API キーを取得
+2. GraphQL API を使用してレコードをクエリします
+3. アプリケーションで結果を処理
+
+参照：[API ドキュメント](/l/ja/developers/extend/api)
+
+## ヒントとベストプラクティス
+
+### エクスポート用ビューを作成
+
+エクスポート用に設定したビューを保存します：
+
+1. 列とフィルターを設定
+2. **View options** → **Save as new view** をクリック
+3. 名前を "Export - [Purpose]" にします
+
+### エクスポートを安全に管理
+
+エクスポートされたファイルには機密データが含まれる場合があります：
+
+* 安全な場所に保管する
+* 不要になった古いエクスポートを削除する
+* エクスポートファイルの共有に注意する
+
+### エクスポート前の確認
+
+<Check>正しい列が表示されている</Check>
+<Check>フィルターが正しく設定されている（または全件エクスポートのために解除済み）</Check>
+<Check>エクスポート権限がある</Check>
+
+## FAQ
+
+<AccordionGroup>
+  <Accordion title="エクスポートに一部の列が含まれていないのはなぜですか？">
+    表示されている列のみがエクスポートされます。 エクスポート前に **Options → Fields** から必要な列を追加してください。
+  </Accordion>
+
+  <Accordion title="エクスポートにすべてのレコードが含まれないのはなぜですか？">
+    フィルターを確認してください。 エクスポートには、現在のビューのフィルターに一致するレコードのみが含まれます。 すべてのレコードをエクスポートするにはフィルターを解除してください。
+  </Accordion>
+
+  <Accordion title="20,000 件を超えるレコードをエクスポートできますか？">
+    1 回のエクスポートではできません。 フィルターを使ってバッチに分けてエクスポートするか、より大きなデータセットには API を使用してください。
+  </Accordion>
+
+  <Accordion title="エクスポートファイルの形式は何ですか？">
+    CSV（カンマ区切り形式）です。 Excel、Google スプレッドシート、その他のスプレッドシートアプリで開けます。
+  </Accordion>
+
+  <Accordion title="リレーション ID は含まれますか？">
+    はい。ただし、リレーションシップの "many" 側のみです。 たとえば、People のエクスポートには `companyId` が含まれますが、Companies のエクスポートには People の ID は含まれません。
+  </Accordion>
+
+  <Accordion title="エクスポートを自動化できますか？">
+    UI から直接はできません。 API を使用して自動エクスポートのワークフローを構築してください。
+  </Accordion>
+</AccordionGroup>
+
+## 次のステップ
+
+* [既存レコードを更新する方法](/l/ja/user-guide/data-migration/how-tos/update-existing-records-via-import) — エクスポートを編集して再インポート
+* [API でデータをインポートする方法](/l/ja/user-guide/data-migration/how-tos/import-data-via-api) — 大規模データセット向け
+* [API ドキュメント](/l/ja/developers/extend/api) — カスタムのエクスポートワークフローを構築