インポート方法
Twenty では、データのインポート方法として主に次の2つをサポートしています。| メソッド | 最適用途 | 件数上限 |
|---|---|---|
| CSVインポート | 標準的な移行や定期的な更新 | 1ファイルあたり10,000件 |
| APIインポート | 大規模な移行や自動化 | 無制限 |
非常に大きなデータセット（数十万件のレコード）の場合は、API を使用してください。 必要に応じて、当社の実装パートナーがこれらのスクリプトの実行を支援できます。
CSVインポートの基本
CSV、XLSX、または XLS ファイルを使用して、任意のオブジェクトのデータをインポートできます。 各ファイルには、1種類のオブジェクトのみを含めてください（例：People レコードのみ）。インポート前にフィールドが存在している必要があります。 CSV をアップロードするとレコードは作成されますが、フィールドは作成されません。 カスタムフィールドが必要な場合は、まずSettings → Data Modelで作成してください。
手順
- データをインポートする対象のオブジェクトに移動します。
- 右上の**⋮**アイコン（コマンドメニュー）をクリックし、Import recordsをクリックします。
- テンプレートファイルをダウンロードし、データが想定された形式になっていることを確認します。
- フォーマット済みのCSVファイルをアップロードします。
- 列を Twenty のフィールドにマッピングします。
- エラー（黄色でハイライト）を確認し、UI 上で直接編集して修正します。
- インポートを確定します。
オブジェクト間の関係をインポート
CSV インポート機能を使用して、オブジェクト間の関係をインポートできます。 関連オブジェクトは、一意のフィールドを使って参照します。使用できる例：id、People と Workspace Members では email、Companies では domain、そのほかのオブジェクトではデータモデルで一意に設定した任意のフィールド。
削除済みレコードも一意性に含まれます。 ソフト削除されたレコード（Command Menu → See deleted records で表示可能）も一意性チェックに含まれます。 削除済みレコードと同じ一意値のレコードをインポートすると、その削除済みレコードが復元されます。
データをエクスポート
バックアップ、レポーティング、または移行のためにワークスペースのデータをエクスポートします。手順
- エクスポートしたいオブジェクトに移動します。
- 必要な列を含むようにビューを設定します。
- ⋮ → Export view をクリックします。
- CSV ファイルを保存します。
表示されている列のみがエクスポートされます。 CSV ファイルには、現在のビューに表示されている列だけが含まれます。 どのデータを含めるかを制御するために、エクスポート前に列を追加または非表示にしてください。
エクスポートの上限: 1回のエクスポートにつき最大20,000件。
権限
データのインポートとエクスポートには特定の権限が必要です。- Import: “Import CSV” 権限が必要
- Export: “Export CSV” 権限が必要