Félix Malfait
882e9fd231
## Summary - Restructures the developer Extend documentation: moves API and Webhooks to top-level pages, creates dedicated Apps section with Getting Started, Building, and Publishing pages - Updates navigation structure (`docs.json`, `base-structure.json`, `navigation.template.json`) - Updates translated docs for all locales and LLMS.md references across app packages ## Test plan - [ ] Run `mintlify dev` locally and verify navigation structure - [ ] Check that all links in the Extend section work correctly - [ ] Verify translated pages render properly Made with [Cursor](https://cursor.com) --------- Co-authored-by: github-actions <github-actions@twenty.com>
210 lines
9.7 KiB
Plaintext
210 lines
9.7 KiB
Plaintext
---
|
||
title: データをエクスポート
|
||
description: Twenty からデータをエクスポートするための完全なステップバイステップガイド。
|
||
---
|
||
|
||
import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';
|
||
|
||
## 概要
|
||
|
||
バックアップ、レポート作成、または移行のために、ワークスペースのデータを CSV にエクスポートします。
|
||
|
||
**ユースケース：**
|
||
|
||
* **定期的なバックアップ** — データのコピーを保持
|
||
* **外部レポーティング** — Excel、Google スプレッドシート、BI ツールでデータを分析
|
||
* **移行** — データを別のシステムに移す
|
||
* **一括更新** — エクスポートして編集し、再インポートしてレコードを更新
|
||
|
||
## 知っておくべきこと
|
||
|
||
### エクスポートの制限
|
||
|
||
* 1 回のエクスポートにつき **最大 20,000 件のレコード**
|
||
* **表示されている列**のみがエクスポートされます
|
||
* **フィルターで絞り込まれたレコード**のみがエクスポートされます（現在のビューに基づきます）
|
||
|
||
<Note>大規模なエクスポート（20,000 件超）では、フィルターを使ってバッチに分けてエクスポートするか、[API](/l/ja/developers/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/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/api) — カスタムのエクスポートワークフローを構築
|