- CSVはサービス変更時の「出口」として重要
- 出力できる列と文字コードを確認する
- CSVがあっても画像・設定まで復元できるとは限らない
- CSV出力とCRM直接同期は別機能
CSVを書き出せると何ができる？
CSVは、表形式のデータをテキストファイルとして持ち出すための一般的な形式です。名刺管理では、氏名、会社名、電話番号、メールアドレスなどを行と列にして保存できます。
Excel・スプレッドシートで確認
名刺一覧を自分で並び替えたり、フィルターしたり、追加の列を付けたりできます。
別サービスへの移行準備
移行先がCSVインポートに対応していれば、中間ファイルとして使える場合があります。
独立した一覧コピー
アプリ内だけに名刺情報を閉じず、主要フィールドのコピーを別に保持できます。
データ内容の監査
どの項目が保存されているかを一覧で確認し、表記ゆれや欠損を見つける材料にできます。
導入前にCSV出力を確認した方がいい理由
名刺管理アプリは、使い始めた直後より、数百枚溜まってから変更する方が難しくなります。将来サービスを変える可能性が少しでもあるなら、データの出口は先に確認しておく方が安全です。
特に「無料で保存できるがCSV出力は有料」「一部の列しか出ない」「画像は別途保存されない」といった条件があると、移行時の作業量が変わります。
CSVで確認したい7項目
1. どの列が出力されるか
氏名・会社・メールだけなのか、部署、役職、電話、住所、URL、タグ、メモ、日時まで含まれるかを確認します。
2. 文字コード
日本語をExcelで扱う場合、文字コードの違いで文字化けすることがあります。UTF-8を使う場合も、Excelとの相性を考えてBOM付きかどうかが重要になるケースがあります。
3. カンマ・改行・ダブルクォートの処理
メモ欄にカンマや改行が入ると、CSVの列がずれないよう適切なエスケープが必要です。アプリ側で正しく引用符処理されるかを確認します。
4. 複数タグの表現
1件の名刺に複数タグがある場合、1セル内でどの区切り文字を使うか、別列になるかで移行のしやすさが変わります。
5. 日付・ID
作成日、更新日、内部IDが出ると、重複整理や移行時の追跡に役立つことがあります。一方、移行先で不要な内部情報は削る判断も必要です。
6. 画像は含まれるか
CSV自体は画像ファイルを内包する形式ではありません。画像パスやURLが列にあっても、その画像が別環境で参照できるとは限りません。
7. 再インポートできるか
「CSVを書き出せる」と「同じアプリにCSVを戻せる」は別機能です。復元目的なら、インポートまたはバックアップ/リストア機能まで確認します。
CSV出力・直接同期・バックアップは別物
| 機能 | 意味 |
|---|---|
| CSVエクスポート | 名刺の表形式データをファイルとして外へ出す |
| CSVインポート | CSVファイルをアプリへ読み込んでレコードを作る |
| CRM直接同期 | API等を使い、別サービスと自動/半自動でデータを連携する |
| 完全バックアップ | 名刺データだけでなく、画像・設定・関連状態等を含めて復元できる仕組み |
CardHubのCSV出力はどうなっている？
2026年8月22日に確認したCardHubの現行実装では、CSV出力はStandard向けの機能です。UTF-8 BOM付きのCSVファイルをキャッシュ領域へ作成し、OSの共有シートを開く処理があります。
現在のCSV列
コード上では、次の列が定義されています。
- id
- name（氏名）
- company（会社）
- department（部署）
- position（役職）
- phone / mobile
- postal_code / address
- website
- note
- category
- is_favorite
- tags
- contact_count / last_contact_date
- image_path / thumbnail_path
- created_at / updated_at
タグは現在のCSV実装では | で連結されます。値にカンマ、ダブルクォート、改行がある場合はCSV用にエスケープする処理があります。
CardHubのCSVで注意したいこと
CSVインポートは確認していない
現行コードでCSVを書き出す機能は確認していますが、任意のCSVをCardHubへ読み込むユーザー向け機能は確認していません。CSVを「CardHubへ戻す完全バックアップ」とは案内できません。
JSON export/importの内部関数はあるがUI未確認
ストレージサービスにはJSON export/import関数があります。しかし、設定画面等から一般ユーザーが利用する導線は今回確認できていないため、公開機能としては扱っていません。
image_pathは画像そのものではない
CSVには画像パス列がありますが、別端末や別アプリで同じパスが使える保証はありません。画像を含めた移行要件がある場合、CSV以外の仕組みが必要です。
CRM直接同期ではない
CardHubからSalesforce、kintone等へAPIで直接同期する実装は現在確認していません。CSVを書き出し、移行先が対応していれば手動インポートに使える可能性がある、という範囲です。
Excelで開く前に確認する
CSVをダブルクリックしたときの挙動は、OSやExcelのバージョン、地域設定によって変わることがあります。列が崩れる、文字化けする場合は、Excelの「データからテキスト/CSV」を使い、文字コードや区切り文字を指定して取り込む方法を確認します。
CardHubはUTF-8 BOMを付ける実装ですが、すべての表計算ソフトで同じ表示になることを保証するものではありません。
名刺管理アプリを選ぶ前の「出口」チェック
- CSV出力がある
- 自分に必要な列が出る
- 日本語を扱える文字コードになっている
- タグやメモが失われない
- 画像の扱いを理解している
- 出力が無料/有料のどちらか確認した
- 移行先がCSVインポートに対応するか確認した
- 直接同期が必要なら、CSVとは別に連携機能を確認した
- 完全復元が必要なら、専用バックアップ機能まで確認した
まとめ
CSV出力は、名刺管理アプリを長く使うほど重要になる「データの出口」です。Excelで確認できる、別サービスへ移すための材料になる、独立した一覧コピーを持てるという利点があります。
一方、CSV出力だけで直接CRM同期や完全バックアップができるわけではありません。出力列、文字コード、タグ、画像、再インポート可否まで確認して、目的に合った出口か判断してください。
実装確認
CardHub部分は2026年8月22日に確認した `src/services/csvExport.ts`、`src/screens/SettingsScreen.tsx`、`src/monetization/policy.ts`、`src/services/storage.ts` の現行実装に基づきます。