【kintone API】レコードの値の取得・変更時の注意点

技術記事
【kintone API】レコードの値の取得・変更時の注意点

kintone APIで、kintone.app.record.get()とkintone.app.record.set()を使用する時の注意点について書いていきます。

レコードの値の取得・変更

kintone APIには、レコードの値を取得するkintone.app.record.get()と、レコードの値を変更するkintone.app.record.set()があります。

主に、イベント外でレコード情報を取得・変更したいときに使用する関数になります。

関数を使う時の注意点

関数を使う時の注意点として、これらの関数は、kintone.events.onのイベントハンドラ内では実行することができません。イベントハンドラ内では、ハンドラに渡される引数のイベントオブジェクトを使用する必要があります。

以下の様に書いた場合、正常に動作しません。

1kintone.events.on('app.record.create.show', function(event) {
2    const record = kintone.app.record.get(); // 使えない
3    // ...
4});

kintone.events.onのイベントハンドラ内では、以下の様に引数のeventオブジェクトでレコード情報を取得し、オブジェクトをreturnすることで更新ができます。

1kintone.events.on('app.record.create.show', function(event) {
2    const record = event.record;
3    // ...
4    return event;
5});

関数の使いどころとしては、以下のように、ボタンを押下した時の処理に使用することができます。

1// ボタンを押したときにレコード情報を取得
2document.getElementById('my-button').addEventListener('click', function() {
3    const record = kintone.app.record.get();
4    // ...
5});

今回はkintone APIのkintone.app.record.get()とkintone.app.record.set()についてまとめました。以上で記事を終わりにします。

参考文献