第 2 回 kintone コマンドラインツール(cli-kintone v0)でレコードの登録・削除をしてみよう
このチュートリアルはver. 0.x.xのcli-kintoneの使い方を紹介しています。
ver.1.0.0以降のcli-kintoneの使い方を紹介するチュートリアルは次のページを参照してください。
はじめよう cli-kintone
はじめに
前回の記事で、cli-kintoneの導入とレコードの取得について理解していただけたと思います。
この先kintoneコマンドラインツールはcli-kintoneと表記します。
今回も引き続きフィールドコードをカスタマイズした 顧客リストアプリ を利用して、レコードの追加と削除のやり方を紹介します。
レコードの追加
STEP1 追加するレコードのデータを CSV ファイルで用意する
まずは追加するレコードのデータのCSVファイルを作成しましょう。
このとき、必須項目以外のフィールドは入力しなくても問題ありません。
|
|
今回はこの内容を「customers.csv」とし、文字コードをShift-JISにして保存します。
STEP2 レコードを追加する
レコードを追加するときは、認証のオプションに加えて-f
オプションでファイルを指定して追加します。
このとき作成したレコードのファイルのエンコーディングをエクスポート時と同様に-e
オプションで指定します。
今回はShift-JISで作成したのでsjis
を指定しましょう。
実行ファイルと同じ場所にcustomers.csv
を保存した場合
|
|
customers.csv
のファイルパスを指定する場合
|
|
customers.csv
ファイルの途中行からインポートする場合
|
|
レコードを削除した後にレコードを追加
STEP1 すべてのレコードを削除してからレコードを追加する
cli-kintoneでレコードを削除してからレコードを追加する際には-f
オプションを利用したうえで-D
オプションを利用します。
このときクエリで絞り込みをしない場合 すべてのレコードを削除 してからレコードが追加されます。
|
|
STEP2 クエリで絞り込みをしたレコードを削除してからレコードを追加する
レコード追加前に一部のレコードのみを削除したい場合、-q
オプションを使って削除対象レコードをクエリで絞り込んでから実行する必要があります。
条件式の書き方は前回の取得のときと同様に
クエリの書き方を参考にしてください。
今回は担当者名に「瀧ヵ平」を含む最新5件のレコードを削除してから、新たにレコードを追加してみましょう。
|
|
テーブルを含むレコードを追加する
こちらも前回と同様 交通費申請アプリ を使って確認しましょう。
STEP1 テーブルを含むレコードの CSV ファイルを作成する
テーブルを含むレコードを追加する場合は、テーブルを含むレコードを取得したCSVと同じように、フィールドコードの行と各レコードの1行目の最初に*,
を追加します。
すでにあるレコードをcli-kintoneでエクスポートしたものを参考にCSVを作成すると間違いなく作れるかと思います。
|
|
この内容を「subtable.csv」としてShift-JISで保存しましょう。
STEP2 CSV ファイルを指定してレコードを追加する
テーブルを含まない場合と同様に、-f
オプションでファイルを指定してレコードを追加します。
|
|
注意ポイント:チェックボックスや複数選択で複数チェックが入る場合の CSV 表現
今回のサンプルアプリにはありませんでしたが、フィールドに複数の値が含まれる場合は""
内に改行区切りで選択される値を表記する必要があります。
Excelなどで確認すると、セルの中で改行されて表示されると思います。
Excelで編集する場合は「Alt + Enter」を押すと、セル内で改行できます。
テーブル内でも同様に、テーブルの行内当該のフィールドの値を""
内改行区切りで選択される値を表記します。
CSV 表現の例
上の画像のレコード2件の場合、次のCSVで表現できます。
|
|
エクセルで表示した場合は次のとおりです。
CSV 表現の例(テーブル内のフィールドの場合)
上の画像のレコード2件をCSVで表現する場合以下になります。
|
|
エクセルで表示した場合は次のとおりです。
レコードが正しく追加されてない場合のデバッグ方法
おおむねエラーメッセージに対応すればエラーは解消されるとは思いますが、cybozu.com共通管理から実行されたリクエストを見ると問題が特定しやすいです。
kintoneの右上の歯車のマークのメニューから「cybozu.com共通管理」へ移動し、左のカラムの「システム管理」内「監査ログ」の「閲覧とダウンロード」に移動します。
こちらの監査ログの一覧を見ると、レコード操作やその成否が、また表左の「i」マークをクリックすると詳細なレコード操作の内容が確認できます。
こちらを見て、cli-kintoneからリクエストが届いているか、どのようなエラー内容が出ているかを見ることでうまくいかない原因を探しやすくなります。
まとめ
第2回はここまでです。
レコード追加と削除、いかがでしたでしょうか?
次回はレコードの更新をやっていきます。
このTipsは、cli-kintone Ver 0.10.2と2020年3月版kintoneで動作を確認しています。