メインコンテンツへスキップ

カオナビ サポートサイト

なにかお困りのことはありますか？

カオナビ総合サポートページを公開しました！ 詳しく見る

トップへ戻る

このセクションの記事

もっと見る

（カスタムCSV連携） カオナビからCSVファイルへの出力設定（従業員のテキスト情報）

カオナビからCSVファイルへの出力設定（従業員のテキスト情報）とは

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

  • 従業員のテキスト情報のみが出力可能です。所属ツリー情報は出力出来ません。

 

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

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

 

あらかじめ連携先の他システムのヘッダーを用意し、⑥ヘッダー項目を登録するで登録することで、データ変換作業を無くすことが可能です。

日付項目は「YYYY-MM-DD」の形式で出力されます。他システムへの入力に必要な日付形式が「YYYY-MM-DD」の形式でない場合は連携項目の計算式で変換いただく必要がございます。

計算式の詳細は日付の計算式をご覧ください。

②ジョブを追加する

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

③連携方向とジョブの種類を選択する

作成するジョブの連携方向『カオナビからカスタムCSVに連携』と、ジョブの種類『従業員のテキスト情報』を選択して『ジョブを作成』ボタンをクリックします。

integration_009_032_01.png

④ジョブ名を登録する

ジョブ名を登録します。

integration_016_000.png

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

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

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

integration_016_004.png

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

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

CSVファイルの例（Excel）

integration_016_005.png

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

integration_016_006.png

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

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

integration_016_007.png

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

integration_016_008.png

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

integration_016_009.png

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

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

integration_016_010.png

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

  • データ構造
単一レコード（縦型） 1人につき1行の一覧（例：基本情報など）
複数レコード（縦型） １人につき複数行の一覧（例：保有資格情報、家族情報など）
  • 詳細項目
文字コード UTF-8（BOMなし） 多くのシステムで使える標準的な文字コード
UTF-8（BOMあり） Excelでの表示に配慮した文字コード
Shift-JIS 古いWindowsに適した文字コード
改行コード CRLF Windowsに適した改行コード
LF Macに適した改行コード
区切り文字 カンマ（ , ） 多くのシステムで使える標準的な区切り文字
タブ カンマを多く含む値でも崩れにくい区切り文字
囲み文字 条件付きで使用 区切り文字、改行、「"」を含む場合のみ、「"」で囲みます。
常に使用  
使用しない  

integration_016_011.png

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

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

integration_016_012.png

 

検索条件のルール

項目間はAND条件で検索されます。
また条件に指定できるのは各項目1回のみです。 

 

設定例

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

 

連携開始後も連携対象の従業員は変更できます。

 

⑧連携項目を設定する

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

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

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

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


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

ケース 利用する計算式例
カオナビの「役職」項目に登録されているデータをそのまま出力 [役職]
カオナビの「フリガナ」に登録されているデータを分割して「氏(カナ)」項目に LEFT([フリガナ],FIND(" ",[フリガナ])-1)

※氏と名の間に全員に共通した記号（半角スペースなど）が入っている必要があります
「男性」「女性」と登録されている性別から「性」を省いて連携 IFS([性別]="男性","男",[性別]="女性","女")

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

integration_016_015.png

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

integration_016_016.png

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

 

利用できる計算式

その他利用可能な計算式例はこちらをご覧ください。
項目が分かれて登録されているデータを繋げる計算式や、登録されているデータによって連携先では別の値を表示させる計算式などがあります。

integration_016_017.png

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

integration_016_018.png

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

integration_016_019.png

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

integration_016_020.png

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

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

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

integration_016_032.png

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

integration_016_022.png

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

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

integration_016_023.png

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

integration_016_024.png

integration_016_025.png

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

integration_016_026.png

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

integration_016_027.png

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

integration_016_028.png

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

integration_016_029.png
integration_016_030.png

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

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

integration_016_031.png

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

integration_016_033.png

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

integration_016_034.png

integration_016_035.png

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

integration_016_036.png

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

integration_016_037.png

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

integration_016_042.png

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

integration_016_038.png
integration_016_039.png

⑩保存する

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

integration_016_021.png

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

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

integration_016_040.png

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

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

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

integration_016_043.png

 

連携後のジョブ編集

連携開始後も修正、追加、削除ができます。
 

修正
修正したい連携項目の、該当箇所をクリックすると修正できます。

追加
『連携項目を追加』から新たに追加してください。

削除
削除したい連携項目の右側に表示されている『ゴミ箱』ボタンをクリックして削除してください。

 

連携後の確認

連携後、『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形式に変換する

関連記事