kintone の Javascript カスタマイズのあれこれ

kintone の Javascript カスタマイズをあれこれ触るようになって、気が付いたことをまとめておきます。開発しながらメモった感じなので、間違っていたら、すいません。

REST API の getRecords の limit と totalCount

クエリに該当するレコード数が totalCount で返ってきます。このとき、 limit 指定により取得件数の制限がかけてあり、それが totalCount 以下でも、totalCount = limit にはならずに、 limit を除いたクエリに該当するレコード数になるようです。

APIの説明だと、『クエリに該当するレコード数』とあるので、 limit かけれてば、 totalCount はlimit以下になるように思えるけど、違うので要注意。

クエリの書き方

フィールドコード < 時刻

はありだが、

時刻 < フィールドコード

はエラーになりますので、注意が必要です。

リファレンスはこちら。

クエリの書き方 - cybozu developer network

「フィールドコード演算子値」のように記述します。

という表記の通りで、入れ替えては成立しないということです。

レコード更新とレコード番号

複数のレコード更新をする際の updateKey にデフォルトのレコード番号は使えないようです。

複数のレコードを更新する - cybozu developer network

ドキュメントからするとできてもよさそうなんですが、こんな感じのエラーで落ちました。

xxxアプリのyyyでエラーが発生しました。 KintoneRestAPIError: [400] [GAIA_IN06] レコードの更新に失敗しました。「updateKey」に指定したフィールド（code: レコード番号)が不正です。「updateKey」には、文字列（1行）フィールドか数値フィールドのみ指定できます。また、フィールドの設定で、値の重複を禁止する必要があります。 (PviiQ4bCDMEZUl2h4Ull)
    at __webpack_modules__../node_modules/@kintone/rest-api-client/lib/src/KintoneResponseHandler.js.KintoneResponseHandler.handleErrorResponse (d:\work\xxxx\sample_app\node_modules\@kintone\rest-api-client\src\KintoneResponseHandler.ts:49:5)
    at https://localhost:5500/dist/transaction_sample.js:287:123 {name: 'KintoneRestAPIError', id: 'PviiQ4bCDMEZUl2h4Ull', code: 'GAIA_IN06', errors: undefined, status: 400, …}