VTIGER CRM OSS STANDARD GUIDE

CSVを、ただ取り込むだけでなく、
仕事で使えるデータに整える。

「Excelの顧客一覧をCRMへ移したい」「登録済みの情報をCSVで確認したい」「同じ会社を二重に登録せず、必要な項目だけ更新したい」。CSVは便利ですが、列の対応や更新のルールが合っていないと、取り込んだ後の整理が必要になります。

Vtiger CRM OSSには、対応するモジュールでCSVを取り込むインポートと、CSVへ書き出すエクスポートの標準機能があります。この記事では、顧客情報のような一覧データを中心に、準備から結果確認までの基本を解説します。

この記事でわかること
CSVの準備、出力範囲の選び方、項目の対応付け、重複処理と空欄の扱い、取り込み後の確認、モジュールごとの注意点を図解します。

対象:Vtiger CRM OSS 8.4系の標準インポート・エクスポート。使える機能・項目・権限・手順はモジュールや導入環境により異なります。図・会社名・列名は説明用の架空の例です。

1. インポートとエクスポートの違い

インポートは、外部のデータをCRMへ取り込む操作です。エクスポートは、CRMの情報を外へ書き出す操作です。どちら向きにデータを動かすかと、何のために使うかを分けて考えましょう。

図解|CSVとCRMの間でデータを受け渡す
インポート/取り込み

CSVからCRMへ

CSV→CRM

外部の顧客一覧を登録する。
対応する重複処理で、既存情報を更新する。

エクスポート/書き出し

CRMからCSVへ

CRM→CSV

登録内容を確認・集計する。
別の作業で使う一覧として受け渡す。

データの移動方向を示す概念図です。エクスポートしたCSVを無加工で戻せば、すべての情報を同じ状態へ復元できるという意味ではありません。

取り込む前に、「新しいレコードを追加するのか」「既存のレコードを更新するのか」を決めます。同じCSVでも、照合条件や重複時の処理によって結果は変わります。

また、CSVは文字と値を行・列で持つ形式です。Excelの書式、色、複数シート、数式の仕組みをそのままCRMへ移すものではありません。

2. CSVを準備する

顧客企業のような一覧データでは、1行を1件、1列を一つの項目として整理します。見出し行を付け、取り込む対象だけを一つの表にまとめましょう。

取り込み前に確認すること
確認する点準備の例
文字コード・区切り日本語のCSVはUTF-8を基本に用意し、画面の指定と一致させる。通常のカンマ区切りかも確認する。
見出し行「会社名」「電話」等、各列の意味がわかる見出しを付ける。空の列名や同じ見出しの重複を避ける。
必須項目対象モジュールの必須項目と、各行の値を確認する。画面で既定値を指定できる項目も、意図した値になるか確認する。
電話・番号・コード先頭のゼロ、長い番号、英数字の表記を保つ。表計算ソフトで自動変換されないよう、文字列として扱う。
日付・数値日付の書式、小数点、桁区切り等を揃え、利用者の表示形式や取り込み画面の条件と照合する。
選択肢状態・業種等の値をCRMの選択肢と合わせる。似た表記を混在させない。
関連先・担当者顧客企業・商品・担当者等の参照先を先に整理し、照合する名称や値を揃える。
空欄・対象外の列更新する列と、今回は触れない情報を分ける。空欄を「変更なし」と扱えるかは重複処理で確認する。

カンマや改行を含む文章は、CSVとして適切に引用符で囲まれている必要があります。セルの結合や見た目の段落を使う表よりも、CSVとして書き出した後の列数と値を確認することが大切です。

関連先にも注意しましょう。たとえば顧客担当者を取り込むなら、顧客企業を先に揃え、会社名の表記も合わせます。標準には、参照先を見つけられない場合に権限等の条件に応じて新規作成する処理があるため、表記揺れが別レコードの作成につながることがあります。

参照した標準の文字コード選択肢はUTF-8とISO-8859-1です。Shift_JISのファイルを、そのままUTF-8として指定しないようにします。文字化けや列ずれがある場合は、本番取り込みの前にファイルと指定を揃えます。

3. 必要な範囲をエクスポートする

エクスポートでは、どのモジュールの、どの範囲を出すかを確認します。画面で選択した情報と、出力ファイルの内容を照らし合わせましょう。

  1. 対象の一覧と条件を確認する

    顧客企業や顧客担当者など、対象の一覧を開きます。必要に応じてフィルター・検索で確認し、出力したいレコードを選びます。

  2. エクスポートの操作を開く

    一覧の操作メニュー等から選びます。表示されない場合は、対象モジュールの対応と利用者のエクスポート権限を確認します。

  3. 出力範囲を選ぶ

    「選択したレコード」「現在のページ」「全データ」等、表示される選択肢を確認します。全データの扱いと、フィルター・検索条件の反映も結果で確認します。

  4. CSVを保存し、件数と内容を見る

    日本語、電話番号、日付、参照先、必要な項目が意図した形で出ているかを確認します。表計算ソフトでは文字コードと列の型を指定して読み込むと、自動変換を避けやすくなります。

「現在のページ」と、条件に合う全件は別です。
一覧の先頭ページだけを書き出したのか、選択した対象なのか、全データの操作なのかを確認します。出力件数は、権限やモジュールの処理、適用される条件とも合わせて見直します。

標準の共通エクスポートはUTF-8のCSVを出力する実装です。ダブルクリックで開いて文字化けした場合も、すぐにデータの破損と判断せず、読み込み時の文字コードを確認しましょう。

4. 項目を対応付けてインポートする

取り込みでは、CSVの各列を、CRMのどの項目へ入れるかを指定します。この対応付けを「マッピング」と呼びます。

図解|列名が違っていても、意味を確認して対応付ける
顧客企業への対応付けの例
CSVの列対応CRMの項目
社名青葉製作所→顧客企業名会社を識別する名称
連絡先TEL03-1234-5678→電話電話番号を記録する項目
Webサイト会社のWebサイトURL→WebサイトURLを記録する項目
列名・翻訳は例です。見出しが一致して自動で選択される場合も、サンプルの値を見て確認します。必須項目や、使わない列の扱いも含めて指定します。
  1. 少量の確認用CSVを用意する

    新規・既存、空欄、日付、関連先など、本番で使う代表的なパターンを含めます。更新がある場合は作業前の情報と、必要な復旧方法を用意します。

  2. 対象モジュールのインポートを開く

    CSVファイルを選び、文字コード、区切り文字、見出し行の有無等を指定します。表示された手順と対応形式を確認します。

  3. 重複の照合項目と処理を決める

    既存レコードと何で照合するか、重複した場合にスキップ・更新等のどの処理を使うかを選びます。選べる操作は権限やモジュールで異なります。

  4. CSVの列とCRM項目を対応付ける

    各列のサンプル値を読み、必須項目と既定値を確認します。保存済みマッピングを使う場合も、今回の列構成と一致しているかを見直します。

  5. 取り込みを実行し、結果を確認する

    成功だけでなく、新規作成・更新・スキップ・失敗等の内訳を確認します。対象レコードを開き、関連先や空欄の扱いまで確かめます。

  6. 確認できた条件で、本番分を扱う

    文字コード、列構成、照合項目、重複処理を揃えて進めます。失敗行だけを修正する場合も、再取り込みによる二重登録を確認します。

手順のまとまりや表示順は環境・モジュールにより異なります。ExcelブックをCSVへ変換する場合は、取り込むシートと値を確認してから保存します。拡張子だけを.csvへ変更する方法では変換できません。

5. 重複処理と空欄の扱いを決める

重複処理では、「同じレコードと判断する条件」と「一致した後の処理」を分けて決めます。会社名が同じだけで別拠点を一つにしないか、メールアドレスを共有する担当者がいないかなど、実データで確認しましょう。

図解|一致したデータを、どう扱うか選ぶ
まず、選んだ照合項目で既存レコードとの一致を確認

Skip/スキップ

一致した取り込み行を処理せず、
既存情報を残す。

重複行の取り込みを避けたい場合

Overwrite/上書き

CSV側の値で既存情報を更新。
空欄や既定値の影響も確認する。

既存値が変わる範囲を先に確認

Merge/マージ

CSVの空でない値で更新し、
CSVが空欄の項目は既存値を残す方向。

「既存の空欄だけ補充」とは異なる

一致しない行

必要な項目・条件を満たせば、
新しいレコードとして取り込む。

新規作成の結果も確認する
一般的な顧客データ等の標準処理を整理した図です。既定値・項目型・権限や、既存側の重複状況にも影響されます。帳票系等では同じ重複処理を選べない場合があります。

たとえばCSVの電話欄が空で、Webサイトには新しいURLが入っている場合、マージは空欄の電話を残しながら、Webサイトを更新する方向の処理です。既存に値がある項目をすべて保護する、という意味ではありません。

同じ照合条件の既存レコードが複数ある場合は、先に確認します。
参照した標準処理では、上書き・マージ時に複数の既存重複をまとめ、権限等に応じて関連情報の移動や重複レコードの削除を伴う処理があります。「指定した1件の項目だけを更新する」と思い込まず、照合条件と既存の重複を見直します。

重複確認を使わない取り込みは、同じCSVの再実行でも新規作成につながることがあります。「一度失敗した気がする」という理由で全件をやり直す前に、完了・失敗・作成済みの範囲を確認しましょう。

6. 取り込み後の結果を確認する

取り込みは、完了表示だけで終わらせず、件数とレコードの中身を合わせて確認します。

結果確認のポイント
確認する点見る内容
処理結果の内訳新規作成・更新・マージ・スキップ・失敗・未処理等を確認する。CSVの見出し行や空行を含めた単純な行数と混同しない。
文字と値日本語、先頭のゼロ、長い番号、日付、選択肢、空欄が意図した状態か。
関連先・担当者正しい顧客企業・商品等に結び付いているか。意図しない参照先の新規作成や担当の置き換えがないか。
既存情報への影響上書き・マージ対象の値と、関連する情報を確認する。
失敗・スキップの詳細表示された対象や結果を確認し、原因を直した行だけを再処理するか判断する。
大量データの処理状況即時完了か、分割・待機・スケジュール処理か。進まない場合は管理者がcron等の動作を確認する。

明細を持つデータは、別の形式として確認する

見積・受注・請求・発注などは、1件の伝票に複数の商品・サービス明細を持ちます。出力CSVが明細ごとの複数行になる場合もあり、顧客一覧と同じ「1行=1レコード」の考え方だけでは扱えません。

OSS 8.4系の標準ソースにも帳票系のインポート処理がありますが、一般の顧客データと同じ重複処理を選べるとは限りません。画面の対応状況に加え、伝票と明細のまとめ方、商品・数量・金額・税や値引き等の取り込み形式を確認し、少量の伝票で結果を確かめます。

取り消しと、元に戻す準備を分ける

標準の取り消し処理には、新規作成したレコードを対象に削除する仕組みがあります。既存値の上書き、重複の統合、関連情報の移動まで、作業前へ一括で復元する機能としては扱いません。

CSVのエクスポートは、添付ファイル・設定・すべての関連を含む完全なバックアップではありません。更新や移行の作業では、確認用CSVと、必要な範囲を復旧する方法を分けて準備します。

7. よくある質問

Q. Excelファイルを、そのまま取り込めますか?

この記事の基本手順はCSVを対象にしています。取り込むシートを整理してCSV形式で保存し、文字コードと値を確認します。対応形式は実際の画面で確認してください。

Q. 日本語が文字化けするときは、何を確認しますか?

実ファイルの文字コードと、インポート画面・表計算ソフトの読み込み指定を揃えます。日本語の取り込みではUTF-8を基本に準備し、文字化けしたまま本番へ進めないようにします。

Q. 列名がCRMの項目名と違っていても取り込めますか?

マッピングで、CSVの列を対応するCRM項目へ指定します。列名だけで判断せずサンプル値を読み、必須項目・既定値・使わない列を確認します。

Q. マージなら、既存の値は書き換わりませんか?

CSVに空でない値があれば、既存の値を更新する処理です。CSVの空欄を除いて更新する考え方で、既存の空欄だけを補う機能とは異なります。既存側に重複がある場合の統合も確認します。

Q. エクスポートしたCSVは、そのまま再取り込みできますか?

必ず同じ状態へ戻せるとは限りません。必須項目、項目対応、参照先、照合条件、日付・選択肢、明細の構造等を確認します。まず少量で、新規作成・更新の結果を確かめます。

Q. 取り消しを押せば、上書きもすべて元へ戻せますか?

標準の取り消しは、新規作成レコードの削除等、対象が限られます。上書きや統合・関連の移動を含む完全な復元の代わりにはせず、作業前の情報と復旧方法を別に用意します。

Q. インポート・エクスポートのメニューがありません。

モジュールごとの対応と、利用者の権限を確認します。FAQなど標準のユーティリティ操作が用意されていないモジュールや、帳票系のように独自の処理を使う対象もあります。全モジュールで同じ手順が使えるとは考えないようにします。

8. CSVの整理を、日々の運用へ

CSVを使う第一歩は、列を揃えることに加えて、「何を1件とするか」「何で同じデータと判断するか」「どこまで更新するか」を決めることです。関連先や取り込み結果まで確認できると、その後の顧客対応に使えるデータへ整えやすくなります。

データの意味を揃える

会社名・担当者・商品・番号などの表記と、列が持つ意味を整理します。

繰り返す作業を揃える

新規登録と更新、失敗時の再処理、作業後の確認を、担当者が変わっても追える形へ整えます。

vtplusは、Vtiger CRM OSSを基盤に、自社の業務に合わせた活用を支援するサービスです。まず標準の取り込み・書き出しで対応できる範囲を確認し、既存の顧客台帳の整理、関連データの移行、継続的な一括更新、複数明細を持つ伝票の扱いなどは、必要な要件に合わせて対応方法を検討できます。

「CSVはあるが、どの項目へ入れればよいかわからない」「毎回、重複や関連先を直している」。そんな課題から、自社のデータと運用のつなぎ方を一緒に整理してみませんか。

NEXT STEP

手元のCSVを、
顧客対応に使える情報へ。

「どのデータから移す?」「重複と空欄をどう扱う?」「顧客・商品・明細をどう結び付ける?」。自社のデータ整理と取り込み手順を考えるところから、相談できます。

参照情報・対象範囲

Vtiger CRM OSS 8.4系の公開ソースを参照しています(参照日:2026年11月8日)。OSSのリンク先は第三者の公開ミラーです。クラウド版や追加拡張の移行・同期・一括更新機能を、OSS標準として一律に扱っていません。

実際の文字コード、CSV解析、登録・更新・統合、関連先、失敗時の処理、帳票明細、権限等は導入環境で確認してください。図と項目名・データ例は説明用です。