対応形式
Twenty はインポート用に 3 種類のファイル形式に対応しています:
| 形式 | 拡張子 | ノート |
|---|
| CSV | .csv | 推奨（最も互換性が高い） |
| Excel | .xlsx | 現行の Excel 形式 |
| Excel (レガシー) | .xls | 旧 Excel 形式 |
ファイル要件
| 要件 | 値 |
|---|
| エンコーディング | UTF-8 を推奨 |
| レコード数の上限 | 1 ファイルあたり 10,000 レコード |
| 構造 | 先頭行には列ヘッダーを含める必要があります |
| コンテンツ | 1 ファイルにつき 1 種類のオブジェクト |
CSV ベストプラクティス
- 区切り文字: カンマ (
,) またはセミコロン (;) を使用
- テキスト囲み文字: カンマを含むテキストには二重引用符 (
\") を使用
- 改行コード: Windows (CRLF) または Unix (LF) のどちらにも対応
- 空の値: セルは空のままにし、“NULL” や “N/A” は使用しないでください
Excel ベストプラクティス
Excel からエクスポートする場合:
- 数式を削除 (値のみをエクスポート),
- 末尾の空行を削除
- 結合セルがないことを確認
- 最初のシートのみを使用
大規模データセット
10,000 レコードを超えるデータセットの場合:
非常に大規模な移行 (100,000 レコード以上) の場合、API は CSV インポートよりも大幅に高速で信頼性も高くなります。
