カスタムCSV連携とは

他サービス・基幹システムとCSVファイルを用いて連携をする場合に、都度発生していたデータ変換や情報の分割・統合作業をなくし、自動で連携できるようにする機能です。
なお、連携設定を行った項目のみが連携され、設定していない項目については影響がないため「指定した列のみを更新」することも可能です。

カスタムCSVで更新・出力できる情報

• 従業員のテキスト情報
• 所属ツリー情報

カスタムCSVの更新・出力の考え方

CSVアップロードでの更新（カスタムCSVからカオナビへの連携）の場合

他システムから出力したCSVについて、変換ルールを設定することでデータ変換や情報の分割・統合作業を無くすことが出来ます。

CSVダウンロード出力（カオナビからカスタムCSVへの連携）の場合

カオナビに登録されている基本情報や各シートのデータを、変換ルールを設定することでデータ変換や情報の分割・統合作業を無くして1つのCSVファイルに出力することが出来ます。

（例）単一レコードシートの情報を"単一"形式で出力

（例）単一レコードシートの項目を、”複数” 形式の出力項目に指定

単一レコードシートの項目と複数レコードシートの項目を合わせて出力できます。

その際、複数レコードシートのレコード分単一レコードシート項目は各行繰り返し出力します。

（例）複数レコードシートの項目を、”単一” 形式の出力項目に指定

単一レコードシートの項目と複数レコードシートの項目を合わせて出力できます。

その際、複数レコードシートのどのレコードを抽出するか指定して出力します。

カスタムCSV連携の注意点

• 英語環境でもご利用いただけますが、日本語表記のままとなります
• カオナビ内に同じ名称のシートや同一シート内に同名の項目があった場合、連携はできません
• 以下は連携の対象外です。
  ・基本情報の変更履歴
  ・単一レコードシートの変更履歴
  ・管理者機能＞ユーザー管理の情報
• 本機能はデータ安心パックのアクセスログの提供範囲外です
• 定期実行（自動連携）の利用可否はプランによって異なります。詳しくはこちら

カスタムCSV連携のアップロードモードについて

「カスタムCSV連携」のアップロードモードは選択できません。

単一レコード

「新規追加モード」＋「指定行の入れ替えモード」の形式で更新されます。
カオナビに存在している社員番号のメンバーの情報であればCSVファイルの内容で更新し、カオナビに存在していない社員番号のメンバーであれば新規で作成します。
※「全入れ替えモード」ではないため、CSVファイルに含まれていないがカオナビに存在しているメンバーの情報が、連携により消えることはありません。

※ジョブ内の計算式に項目として利用されているヘッダーがアップロードするCSVに存在しない場合は、エラーとなりアップロードができません。

複数レコード（指定行の入れ替え）

CSVファイルの内容で上書きされるため、CSVファイルに必要な情報が含まれているか確認してください。
例：CSVにレコードAとBがあり、カオナビ側にレコードCがある場合、アップロードによりレコードCが消え、AとBが登録されます

複数レコード（新規追加）

CSVファイルの内容を新規追加します。登録済みのデータには影響ありません。

例：CSVにレコードAとBがあり、カオナビ側にレコードCがある場合、アップロードにより、既存のレコードCに加えてAとBが登録されます

その他連携時の詳細な注意点については設定説明ページにて記載しています。
CSVファイルからカオナビに連携するときの注意点