「kintone Utility Library for JavaScript」の使い方

はじめに

今回は、2016年12月に（ひそかに）リリースされた、「kintone Utility Library for JavaScript」について紹介します。

「kintone Utility Library for JavaScript」とは、REST APIを使う上で、生産性を向上するために有志により開発されたライブラリです。
例えば、レコードの一括取得/更新/削除など、毎回記述するには面倒な処理を、よりシンプルに記述できます。

それでは、その使い方を説明します。

kintone Utility Library for JavaScriptのダウンロード

GitHubの https://github.com/kintone/kintoneUtility/releases の「Assets」から kintoneUtility.min.js をダウンロードし、カスタマイズの適用画面で設定してください。

※ 本サンプルプログラムはMIT licenseにて提供しています。

kintone Utility Library for JavaScriptの構造

kintoneUtilityオブジェクトには「rest」のプロパティがあり、関数を持っています。   「rest」で提供される関数 関数の一覧はrest_doc.mdに記載されています。

• kintoneUtility.rest.getRecord
• kintoneUtility.rest.getRecords
• kintoneUtility.rest.getAllRecordsByQuery
• kintoneUtility.rest.postRecord
• kintoneUtility.rest.postRecords
• kintoneUtility.rest.postAllRecords
• kintoneUtility.rest.putRecord
• kintoneUtility.rest.putRecords
• kintoneUtility.rest.putAllRecords
• kintoneUtility.rest.deleteRecords
• kintoneUtility.rest.deleteAllRecords
• kintoneUtility.rest.deleteAllRecordsByQuery
• kintoneUtility.rest.upsertRecord
• kintoneUtility.rest.upsertRecords
• kintoneUtility.rest.downloadFile (v0.2.1で追加）
• kintoneUtility.rest.uploadFile (v0.2.1で追加）
• kintoneUtility.rest.setUserAuth (v0.2.1で追加）
• kintoneUtility.rest.setApiTokenAuth (v0.2.1で追加）
• kintoneUtility.rest.setDomain (v0.2.1で追加）
• kintoneUtility.rest.setBasicAuth (v0.2.1で追加）
• kintoneUtility.rest.setGuestSpaceId (v0.2.1で追加）
• kintoneUtility.rest.clearUserAuth (v0.2.1で追加）
• kintoneUtility.rest.clearApiTokenAuth (v0.2.1で追加）
• kintoneUtility.rest.clearDomain (v0.2.1で追加）
• kintoneUtility.rest.clearBasicAuth (v0.2.1で追加）
• kintoneUtility.rest.clearGuestSpaceId (v0.2.1で追加）
• kintoneUtility.rest.getFormFields (v0.3.0で追加）
• kintoneUtility.rest.getFormLayout (v0.3.0で追加）

サンプルコード

例：下記のアプリの「Numberフィールドが0より大きい全レコード」を取得するサンプルコードです。

• レコード番号：529
• 取得条件(query)："Number"フィールドが0より大きいレコード
• レスポンスに含めるフィールドコード(fields)：String,Number
• ゲストスペースではない

まず、「kintone Utility Library for JavaScript」を使わなかった場合、Promiseを使い再帰的にレコードを取得する必要があります。

「kintone Utility Library for JavaScript」を使わなかった場合

一方、「kintone Utility Library for JavaScript」を使うと、パラメータ（JSON）を指定するだけで、 全レコードを取得することができます。

「kintone Utility Library for JavaScript」を使った場合

この様にPromiseや再帰処理がなくなることによるコードの簡素化が実現できます。 また、すべてのレスポンスはPromiseオブジェクトで返されます。   

最後に

「kintone Utility Library for JavaScript」は、皆さんの開発負荷を軽減できるよう、今後も機能を拡充していく予定です。 ぜひ、コメントでのフィードバックをお待ちしています。  

更新履歴

• 2017/08 v0.2.0を公開しました ：下記の機能を追加しました。
  • 単一ファイルを取り扱う機能を追加
  • 外部サービスと連携するための認証機能を追加
• 2017/09 v0.2.2を公開しました。：下記の修正をしました。追加機能はありません。
  • ライブラリの更新
• 2017/11 v0.3.0を公開しました。：下記の機能を追加しました。
  • kintoneUtility.rest.getFormFields
  • kintoneUtility.rest.getFormLayout 

関連記事

（外部記事）kintone Utility for JavaScript を使ってみたよ