kintoneでランダム取得を作ってみた（imoniCamp 2022-07-27)

by Shotaro Matsuda

Slide 1

Slide 1 text

Slide 2

Slide 2 text

Slide 3

Slide 3 text

2 © 2022 Project Asunote 今回の事例の概要 • 製造業の現場作業における、危険予知セルフチェック • チェック項⽬マスタアプリにセルフチェック項⽬を登録してある（作業分類、⾏動分類ごとに複数のチェック項⽬がある） • ⽇々のセルフチェックにおいては、各分類ごとに、マスタからランダムでピックアップした項⽬についてセルフチェックを⾏い、結果をミーティングで共有し、安全についてのディスカッションを⾏う Ø 毎回全項⽬をチェックするのは、⼯数的にも⾮現実的 Ø いつも同じチェック項⽬だと、マンネリ化してしまうため、ランダムでチェック項⽬を変化させたいカスタマイズを⾏う理由

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Slide 6

Slide 6 text

5 © 2022 Project Asunote kintoneで他のアプリからデータを取ってくる⽅法ルックアップ REST API ü キーワード検索による絞り込みが活⽤可 ü ランダム取得の実現のためには、ルックアップ連携キーを指定する必要がある ü 分類内の連携キーを全件取得し、その中から１つをランダムに選出し、ルックアップフィールドにセットし、取得処理を⾏う（⼿動） ü チェック項⽬マスタから、各分類内のレコードをランダムに１件取得する ü REST APIによる直接取得であれば、直接フィールドにデータを取得してくることができる。ルックアップ取得処理も不要。今回はこちらを使うことにした

Slide 7

Slide 7 text

6 © 2022 Project Asunote ランダム取得実現の⽅針狙い撃ちで１件取得取ってきてから選び出す ü 狙いのレコードを予め決める必要がある（$id指定） ü 対象レコードidを全件取得【GET①】そこからランダムに１つを選出⽬的レコードを再度取得【GET②】基本はレコードの取得（GET） GET レコードの取得（１件）レコードの⼀括取得（クエリ利⽤） ü OFFSETを利⽤ ü クエリで対象分類のレコード件数を取得【GET①】 OFFSET値をランダムに⽣成 OFFSET指定で⽬的レコードを１件取得【GET②】レコードの⼀括取得（クエリ利⽤） ü クエリで対象分類の複数レコードを取得【GET①】 ü 取得した複数レコードから１つを選び出す

Slide 8

Slide 8 text

7 © 2022 Project Asunote kintoneへの負荷狙い撃ちで１件取得取ってきてから選び出す ü 狙いのレコードを予め決める必要がある（$id指定） ü 対象レコードidを全件取得【GET①】そこからランダムに１つを選出⽬的レコードを再度取得【GET②】 GET レコードの取得（１件）レコードの⼀括取得（クエリ利⽤） ü OFFSETを利⽤ ü クエリで対象分類のレコード件数を取得【GET①】 OFFSET値をランダムに⽣成 OFFSET指定で⽬的レコードを１件取得【GET②】レコードの⼀括取得（クエリ利⽤） ü クエリで対象分類の複数レコードを取得【GET①】 ü 取得した複数レコードから１つを選び出す

Slide 9

Slide 9 text

8 © 2022 Project Asunote 制約等の確認取ってきてから選び出すレコードの⼀括取得（クエリ利⽤） ü クエリで対象分類の複数レコードを取得【GET①】 ü 取得した複数レコードから１つを選び出す ü レコードの⼀括取得APIで⼀度に取得できるレコード数︓500 ü 今回は取得対象アプリのレコード数が少ないため、カーソルAPIの利⽤等は考慮せず。 ü レコード数が多い（多くなることが想定される）アプリの場合は、考慮する必要がありますね。

Slide 10

Slide 10 text

9 © 2022 Project Asunote コーディングの⽅針 1. 処理を動かすタイミング新規レコード追加画⾯表⽰後イベント 2. 対象分類のレコードを⼀括取得レコード⼀括取得API（分類をクエリで指定） ★REST APIによるレコード取得は⾮同期処理なので、 kintone Promise または async/await を使う必要がある 3. 取得した複数レコードから１つを選び出すレコードの⼀括取得で得られたデータは、複数レコードが配列になっている。そこから１つをランダムに取り出すための処理を関数化（selectRandom関数） 4. 取得したレコードのデータをフィールドに転記 event オブジェクトに代⼊し return event; ※Promiseやasync/awaitを使わないと、レコード取得が完了する前に return event が実⾏されてしまう

Slide 11

Slide 11 text

10 © 2022 Project Asunote 1. 処理を動かすタイミング kintone.events.on(createEvents, async (event) => { }); コーディングの全体設計図 2. 対象分類のレコードを⼀括取得 const resp = await kintone.api(getURL, 'GET', param); 3. 取得した複数レコードから１つをランダムに選び出す const result = selectRandom(resp.records); 4. 取得したレコードからデータをフィールドに転記 event.record[ʻチェック項⽬ʼ].value = result[ʻチェック項⽬ʼ].value; return event; レコード取得は⾮同期処理 await で後続処理に待ってもらう resp.records はレコードの配列レコード追加画⾯表⽰後イベントで動作ハンドラーの関数で async宣⾔配列の要素からランダムに１つを選び出す処理を作成分類が複数あるので関数化 eventオブジェクトのフィールドの値を書き換えて、eventオブジェクトを returnした場合、その値でフィールドの値を更新