VCF を CSV に変換

連絡先を読むために変換する人はいません。スマートフォンのアドレス帳を CRM へ、退職する同僚の連絡先を共有アカウントへ、Outlook のリストをメール配信ツールへ。何かを移すためにファイルが存在します。

移す先が何を求めているかが重要になります。CRM の取り込み画面は「携帯電話」「勤務先メール」といった決まった列名を求めますが、vCard にはその概念がなく、種類のラベルが付いた電話番号のリストが、順不同でいくつでも入っています。このページの内容は、その食い違いをどう扱うかという話です。

各連絡先は氏名、姓、名、組織、役職、メール、電話、住所、備考という 9 列の行になります。複数を持てる 3 つの列は、種類のラベルを添えてセミコロンで区切って一つのセルにまとめられます。

番号付きの列にする方法も考えられますが、どちらの方向でも問題が起きます。5 列にすれば 6 つ番号を持つ人の一つが消え、最大値に合わせれば大半の行が無意味な空欄だらけになり、四番目の番号が人によって FAX だったり自宅の番号だったりして意味が一定しません。まとめておけば、実際にどんな形かを保ったまま、分割は取り込み先の都合が分かった時点で行えます。

ほとんどの連絡先が同じ形をしているなら、表計算ソフトの「区切り位置」でセミコロンを指定すれば一度で分割できます。その後、種類を示す接頭辞を検索置換で取り除きます。

形がばらばらなら、Power Query の「区切り記号による列の分割 — 行へ」を使うと、番号ごとに一行になり、そこから種類ごとにピボットして列名を付け直せます。CRM に複合セルのまま渡すよりも安全です。多くの CRM はそのまま受け入れて丸ごと保存してしまい、結局誰の番号にも発信できないアドレス帳になります。

vCard の住所は、私書箱、番地補足、番地、市区町村、都道府県、郵便番号、国という 7 つの構成要素を持つ構造化された値です。多くのカードはこのうち複数を空欄にしています。

空の要素は取り除かれ、残った部分がカンマでつながれます。結果として読みやすい一つの住所文字列にはなりますが、どの部分が郵便番号でどの部分が番地なのかを示す情報は失われます。住所を市区町村や郵便番号ごとの別列として扱いたい場合は、手作業での見直しが必要になります。

vCard は氏名を二重に持っています。表示用の一続きの文字列は name 列に入り、姓・名・追加の名・敬称の順に並んだ構造化された値は、姓の列と名の列にそれぞれ振り分けられます。

両方を残しているのは、二つがしばしば食い違うからです。名刺をスキャンして作られたカードは表示用の名前だけが埋まっていることが多く、構造化された値が空のことがあります。姓の列で並べ替えるのは正しいときと、代わりに name 列を使うべきときがあり、両方が見えていることでその判断ができます。

現代の vCard は写真、誕生日、複数のウェブアドレス、インスタントメッセージのハンドル、位置情報、タイムゾーン、カテゴリー、ベンダー独自の X- 拡張フィールドを持てますが、これらはどれも出力に含まれません。

特に写真はファイルの大部分を占めることが多く、五百件のエクスポートが数百キロバイトではなく数メガバイトになる主な理由です。表に収まるものではないため、意図的に対象外としています。誕生日やウェブサイトが必要な場合、元の vCard ファイルの側にはまだ残っています。

この形式とカレンダー用の姉妹形式は、どちらも長い値を 75 オクテットで折り返し、行頭のスペースかタブで継続を示します。この変換ではそれを結合してから解析するため、長い備考や住所が折り返し位置で切れることはありません。

対応していないのは quoted-printable という符号化方式です。vCard 2.1 は ASCII 以外の文字をこの方式で書き、たとえば Müller を M=C3=BCller のように表現します。可能であれば元のソフトで vCard 3.0 か 4.0 として書き出し直し、それが難しければ変換前に別途デコードする必要があります。

電話番号やメールアドレスの前に付くラベルは、カードが持っている種類の指定を小文字にしたものです。一つの番号が複数の種類を持つ場合は最初の一つだけが使われるため、work と voice の両方が指定されていれば work になります。

このラベルはソースによって cell だったり mobile だったり iphone だったりと表記が揃いません。取り込み先の想定に合わせて、列全体を一括で検索置換するのが手間の少ない対処です。

変換はこのブラウザータブの中の JavaScript で行われます。エンジンのダウンロードもアップロードも発生せず、アカウント登録も一日あたりの上限もありません。

アドレス帳は他人の氏名や電話番号、自宅住所といった個人情報の集まりです。これを見知らぬ変換サービスにアップロードすることは、記録が必要になる第三者提供にあたりかねません。ここには送信という行為自体がありません。CSV から VCF へ戻す変換をあえて用意していないのも同じ理由からです。どの列が携帯でどの列が自宅かを推測すると、取り込んだ時に正しく見えて実は誤っているファイルができてしまうためです。