【 cli-kintone エクスポート】エラー無しでCSV出力する使い方

この記事は、 cli-kintone エクスポートが失敗してしまう方向けにまとめました。

Kintoneの内部データをエラー無しで「 cli-kintone 」からエクスポートできる使い方をご紹介します。実際の設定画像と操作手順に沿って進めましょう。

「 cli-kintone 」のCSVエクスポートが文字化けしてしまい、データ利用できない方は下記の記事をご覧ください。

今回は、 cli-kintone のエクスポートCSVが文字化けしてしまう際、どうすれば正しいデータとして活用できるかを詳しく解説します。テーブルコード「テーブル（表）」は、入力件数が多いとエクスポート時のデータ量に大きく影響するのですが、どの記事でも【文字化けしてしまう条件】を発見することができませんでした。

本記事の構成（＝もくじ）

cli-kintone 利用の必須条件
情報整理(計4項目):メモ帳などでまとめましょう
cli-kintone のダウンロード
cli-kintone のエクスポート用batファイルを作成
cli-kintone からエクスポート可能か動作テスト

cli-kintone 利用の必須条件

１	Windows OS搭載PC/64bit搭載PCであること →確認方法(Win10) [1] キーボードの”Windowsマーク”と”X”を同時に押す [2] “システム”をクリック [3] 画面内の”システムの種類”欄で、32bit/64bitが確認できる
２	常時Web使用できること
３	設定者が“Kintoneアプリ設定－アクセス権－アプリ”の「アプリ管理」権限保持者であること

サイボウズ社提供EXEファイル「 cli-kintone 」と、任意作成する「bat(バッチ)」ファイルを使用すると、Kintoneからエクスポートしたい“対象アプリ/フィールド(項目)”が cli-kintone を介してエクスポートされます

PCアプリ「タスクスケジューラ」を使用すると、上記batファイルを起動させると、指定時刻にCSVファイルがエクスポートされる仕組みが構築できます

■用語の確認

exeファイルとは？	Windows上で実行可能なコンピュータプログラムが収められたファイルで、このファイルを指定して開くとプログラムが起動される
batファイルとは？	Windows環境で実行できるコマンド列を記述したテキストファイル
タスクスケジューラとは？	Windows OSに入っている管理系機能（ソフト、プログラム）のひとつ指定時刻になると、指定したプログラムが起動できる

情報整理(計4項目):メモ帳などでまとめましょう

① cli-kintone から取得したいアプリのID

連動させたいKintoneアプリを開いた後、表示URLからIDを取得する

例：https://●●●●.cybozu.com/k/20/の場合
→URL末尾の値「20」がIDとなる

②ドメイン名

KintoneのURLからドメインを取得する

例：https://●●●●.cybozu.com/の場合
→「●●●●」がドメインとなる

Kintoneアプリ画面の「設定」

③ cli-kintone と紐づけるAPIトークンを取得

連動させたいKintoneアプリ画面の「設定」アイコンをクリックする

管理画面を開いた後、”設定－カスタマイズ/サービス連携－APIトークン”の手順でAPIトークン発行画面を開く

上図に沿ってAPIトークンを取得する
（１）「生成する」ボタンをクリック
（２）「アクセス権－レコード閲覧」へチェック
（３）「APIトークン」をコピーし、メモ帳などへ貼り付け保管する
（４）「保存」ボタンをクリック

APIトークン取得後、上図「アプリを更新」ボタンをクリックし、設定項目を確定させる
※更新ボタンを押さないとCSV エクスポートが動作しません

④ cli-kintone からエクスポートするフィールド「名称」を取得

フィールド「名称」の取得は確実に

管理画面を開いた後、”フォーム”画面を開き、 cli-kintone からエクスポートさせたい項目を取得する

上図のように、フィールドの「設定画面」を開き、”フィールド名称”をメモ帳などへ貼り付け保管する

項目ごとに名称は異なります

cli-kintone のダウンロード

表題アプリのダウンロード前に、PCデスクトップ画面にデータ保管用の新規フォルダを作成する
新規フォルダ作成後、 cli-kintone ダウンロ－ドページ（外部サイト）より「windows-x64.zip」のダウンロードを行う

cli-kintone.exeの選択を間違えないように

“「github.com」は、プログラムのソースコードをバージョン管理するウェブサービスであり、全世界で6,500万人以上（2021年9月現在）のユーザーを抱えています”

ダウンロード終了後、該当zipファイルを”windows-x64.zip－build－windows-x64″”の手順で展開し、アプリ「 cli-kintone 」をPCデスクトップ画面で新規作成したフォルダへ保存する
※”ダウンロード”フォルダなど、Cドライブ直下フォルダへ「 cli-kintone 」を保存すると、正常動作しないことがあるため、ご注意ください

cli-kintone のエクスポート用batファイルを作成

新規の「メモ帳」を開き、各所で取得した情報を下記コード内①～⑥へ転記し、各所情報を記載する

cli-kintone.exe --export -a 【１】 -d 【２】 -t 【３】 -c "$id,【４】,【５】,【６】" -e sjis > 【７】.csv

【１】	アプリID（半角値）を入力
【２】	ドメイン名（半角）を入力
【３】	APIトークン（半角）を入力
【４】	エクスポートする「フィールドコード」１つ目を入力
【５】	エクスポートする「フィールドコード」２つ目を入力
【６】	エクスポートする「フィールドコード」３つ目を入力
【７】	CSVファイル名を入力