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