カオナビからCSVファイルに出力するときの注意点

• 従業員のテキスト情報のみが出力可能です。所属ツリー情報は出力出来ません。
• 自動連携には対応していません。

カオナビからCSVファイルへの出力設定

①出力するCSVファイルのヘッダーを準備する

②ジョブを追加する

カスタムCSVのトップ画面で、『ジョブを作成』ボタンをクリックします。

③ジョブの種類を選択する

作成するジョブの種類『従業員のテキスト情報』を選択して『ジョブを作成』ボタンをクリックします。

④ジョブ名を登録する

ジョブ名を登録します。

⑤連携方向を入れ替える

カオナビからCSVファイルへ情報を出力するためには、連携する方向を入れ替えます。

『⇆連携方向を入れ替える』ボタンをクリックします。

「設定を削除して変更」をクリックします。

⑥ヘッダー項目を登録する

出力するCSVファイルのヘッダー項目を登録します。

『＋ヘッダー項目を登録』ボタンをクリックします。

①出力するCSVファイルのヘッダーを準備する で準備したCSVファイルを開いてヘッダー行をコピーし、「ヘッダー項目」エリアにペーストします。

「項目区切り」について、CSVファイルをExcelで開いている場合は「タブ」、メモ帳などで開いている場合は「カンマ」を選択します。

CSVファイルの例（Excel）

ヘッダー項目のペースト例（タブ）

一方、CSVファイルをメモ帳やテキストエディタで開いている場合は「カンマ（ ）」を選択します。

CSVファイルの例（メモ帳）

ヘッダー項目のペースト例（カンマ）

ペースト後、『決定』ボタンをクリックします。

⑦出力ファイル形式を変更する

続いて『出力ファイル形式を変更』をクリックします。

出力したいファイル形式を選択して、『適用』をクリックします。

• データ構造

単一レコード（縦型）	1人につき1行の一覧（例：基本情報など）
複数レコード（縦型）	１人につき複数行の一覧（例：保有資格情報、家族情報など）

• 詳細項目

文字コード	UTF-8（BOMなし）	多くのシステムで使える標準的な文字コード
	UTF-8（BOMあり）	Excelでの表示に配慮した文字コード
	Shift-JIS	古いWindowsに適した文字コード
改行コード	CRLF	Windowsに適した改行コード
	LF	Macに適した改行コード
区切り文字	カンマ（ , ）	多くのシステムで使える標準的な区切り文字
	タブ	カンマを多く含む値でも崩れにくい区切り文字
囲み文字	条件付きで使用	区切り文字、改行、「"」を含む場合のみ、「"」で囲みます。
	常に使用
	使用しない

⑧絞り込み条件を設定する

カオナビどの従業員の情報を出力するかを選択します。
プルダウンリストから条件を指定してください。

設定例

採用区分	キーワードを入力し「含む」「含まない」を選択
社員番号	キーワードを入力し「含む」「含まない」を選択

 

 

⑨連携項目を設定する

カオナビ上の項目を、CSVのどの項目に出力するかを設定します。

出力できる形式は以下の通りです。

※単一レコードシートの項目は連携項目設定が必須となります。

• 単一（1社員 x 1行）での出力
  • 複数レコード項目も指定が可能（以下図イメージ）

• 複数（1社員 x n行）での出力

項目の出力には計算式を用います。

ケース	利用する計算式例
カオナビの「役職」項目に登録されているデータをそのまま出力	[役職]
カオナビの「フリガナ」に登録されているデータを分割して「氏(カナ)」項目に	LEFT([フリガナ],FIND(" ",[フリガナ])-1) ※氏と名の間に全員に共通した記号（半角スペースなど）が入っている必要があります
「男性」「女性」と登録されている性別から「性」を省いて連携	IFS([性別]="男性","男",[性別]="女性","女")

『＋連携項目を追加』ボタンをクリックします。

計算式欄に計算式を入力します。

連携したい項目を選択し『計算式に追加』をクリックすると、その項目を表す計算式が入力されます。

計算式が入力できたら『追加』をクリックします。

CSVの出力先項目を選択します。

連携項目を増やす場合にはさらに『＋連携項目を追加』ボタンをクリックして必要な項目数分設定します。

⑩複数レコード項目の連携項目設定

単一レコード項目と複数レコード項目の特定レコードを1社員 x 1行で併せて出力する場合

連携項目の設定の前に、⑥出力ファイル形式を変更するでデータ構造を「単一レコード（縦型）」に設定します。

『＋連携シートを追加』をクリックして対象となるシートを選択します。

※対象となるシートは、管理者画面のレイアウト設定で日付パーツの項目があるシートのみです。

並びの基準とするパーツを選択し、昇順または降順を選択します。

『＋連携項目を追加』をクリックして連携項目追加画面を開きます。

連携するパーツと、連携するレコードの上からの位置を選択します。

『計算式に追加』をクリックすると、当該パーツ・レコードの情報を抽出するための計算式が入力されるので、右下の『追加』をクリックします。

CSVの出力先項目を選択します。

連携項目を増やす場合にはさらに『＋連携項目を追加』ボタンをクリックして必要な項目数分設定します。

単一レコード項目と複数レコード項目を1社員 x 複数行で併せて出力する場合

連携項目の設定の前に、⑥出力ファイル形式を変更するでデータ構造を「複数レコード（縦型）」に設定します。

出力したい複数レコードシートを選択します。

『＋連携項目を追加』をクリックして連携項目追加画面を開きます。

連携するパーツを選択します。

『計算式に追加』をクリックすると、当該パーツ情報を抽出するための計算式が入力されるので、右下の『追加』をクリックします。

CSVの出力先項目を選択します。

連携項目を増やす場合にはさらに『＋連携項目を追加』ボタンをクリックして必要な項目数分設定します。

⑪保存する

設定を途中で終えるときは『設定を保存』をクリックしてください。
設定が完了し、すぐにダウンロードを開始したい場合は『保存してダウンロード』をクリックしてください。

『設定を保存』の場合、いったん作業を中断できます。
『保存してダウンロード』の場合、次の手順に進みます。

『実行ログ画面へ』をクリックします。

⑫CSVファイルをダウンロードする

実行ログ画面の「詳細」に『CSVダウンロード』が表示されたらダウンロードが可能となります。

『CSVダウンロード』をクリックしてCSVをダウンロードしてください。

 

 

利用可能な計算式

計算式	用途	記述例
[項目名]	項目の内容をそのまま表示	[基本情報][役職] 役職項目に入力されているデータをそのまま表示する
&	項目の結合 項目と任意の文字列の結合	[連絡先情報][郵便番号]&" "&[連絡先情報][住所] 郵便番号と住所の間に半角スペースを入れて結合する ※任意の文字列を結合したい場合は、文字列を"で囲みます
IFS	マスターのマッピング	IFS([基本情報][性別]="男性","男",[基本情報][性別]="女性","女",TRUE,"") 性別が「男」であれば「男性」、「女」であれば「女性」、それ以外であれば空欄で表示する
LEFT/RIGHT/MID FIND LEN	分割	LEFT([基本情報][氏名],FIND(" ",[基本情報][氏名])-1) 氏名から半角スペースまでの左側の文字列を表示（半角スペースは含まない）   RIGHT([基本情報][氏名],LEN([基本情報][氏名])-FIND(" ",[基本情報][氏名])) 氏名から半角スペースまでの左側の文字列を省いた、右側の文字を表示   ※氏と名の間に全員に共通した記号（スペースなど）が含まれていないと利用できません   LEFT([資格情報][取得日],4)&"/"&MID([資格情報][取得日],5,2)&"/"&RIGHT([資格情報][取得日],2) 決まった桁数（本例では8桁）の日付から年月日をそれぞれ取り出し「/」で結合する（「20240303」→「2024/03/03」）
IF	条件による出し分け	IF([連絡先情報][電話番号]="",[連絡先情報][携帯電話番号],[連絡先情報][電話番号]) 電話番号が空欄だったら「携帯電話番号」を表示、それ以外の場合は「電話番号」を表示   IF([連絡先情報][住民票住所区分]="現住所と同じ",[連絡先情報][都道府県]&[連絡先情報][市区町村]&[連絡先情報][住所1]&"　"&[連絡先情報][住所2],[連絡先情報][住民票都道府県]&[連絡先情報][住民票市区町村]&[連絡先情報][住民票住所1]&"　"&[連絡先情報][住民票住所2]) 住民票住所区分が「現住所と同じ」だったら都道府県～住所2までを結合、それ以外の場合は住民票都道府県～住民票住所2までを結合して表示
CHAR(10)	兼務項目用改行コード	[兼務情報][兼務1]&CHAR(10)&[兼務情報][兼務2] 兼務の項目の場合は、改行コードを入れて結合 ※単一レコード形式の場合のみ使用
TIMEVALUE	時刻を小数に変換	TIMEVALUE([[勤怠情報][勤怠時間]])*24 勤怠システムから出力した勤怠時間「3:30」を3.5と表示する

 

日付変換の計算式

カスタムCSVで扱う日付形式はYYYY-MM-DDとなります。

他形式で出力したい場合は変換が必要となります。

日付フォーマット	記述例
yyyy-mm-dd yyyy-m-d	[日付] そのまま連携できます。
yyyy/mm/dd	SUBSTITUTE([日付],"-","/") ハイフン（-）をスラッシュ（/）に変更する
mm/dd/yyyy	MID([日付],6,2) & "/" & RIGHT([日付],2) & "/" & LEFT([日付],4) mm/dd/yyyy形式に変換する
dd/mm/yyyy	RIGHT([日付],2) & "/" & MID([日付],6,2) & "/" & LEFT([日付],4) dd/mm/yyyy形式に変換する
yyyymmdd	SUBSTITUTE([日付],"-","") yyyymmdd形式に変換する