命を燃やすために出勤を記録したら部屋をアチアチにする【Nature Remo×kintone】

f:id:ibukintone:20210727101542j:plain

みなさん、命を燃やして仕事をしていますか？

私は、命を燃やして仕事をしています。

命を燃やすには、部屋がアチアチのほうがいいですよね。

というわけで、kintoneのタイムカードアプリで出勤を記録したら、Nature Remoを操作して部屋をアチアチにする外部連携をやってみます。

やりたいこと
Nature Remo Cloud API トークン生成
kintoneアプリ作成
Nature Remo上のエアコン情報を取得
コードをかきかき
- ！注意！
いざ動作確認！
〆
告知

やりたいこと

kintoneのタイムカードアプリで出勤を記録
Nature RemoをAPIで操作し、エアコンを温度MAXの暖房で始動
アチアチの部屋で心を燃やしながらお仕事

やりたいことはただひとつ。命を燃やしたい。それだけです。

Nature Remo Cloud API トークン生成

次の記事の「Nature Remo Cloud API トークン発行」を参考にして、トークンを発行しておきます。

ibukintone.jp

kintoneアプリ作成

続いて、kintoneアプリの作成です。今回はアプリストアの「タイムカード」アプリをそのまま利用しました。 f:id:ibukintone:20210726211716p:plain

タイムカードアプリは、デフォルトでは退勤時刻の初期値にレコード作成日時が設定されます。今回のカスタマイズだと初期値が設定されるのは都合が悪いので、フォームの設定から初期値のチェックを外します。 f:id:ibukintone:20210726211734p:plain

以上でアプリの作成は完了。設定を保存しておきます。

Nature Remo上のエアコン情報を取得

今度は、APIを実行するために必要な、Nature Remo上のエアコン情報を取得します。curlを使って次のコマンドを実行。

curl -X GET -H 'Authorization: Bearer トークン' https://api.nature.global/1/appliances | jq

すると、Nature Remoと連携しているデバイスの情報が入ったオブジェクトの配列が得られるはず。nicknameなどでエアコンの情報が入ったオブジェクトを特定して、IDをメモしておきます。

[
  {
    "id": "ここにエアコンのIDがある",
    "device": {
    ・・・
    },
    "model": {
　・・・
    },
    "type": "AC",
    "nickname": "エアコン",
    "image": "ico_ac_1",
    "settings": {
      "temp": "28",
      "temp_unit": "c",
      "mode": "cool",
      "vol": "auto",
      "dir": "auto",
      "dirh": "",
      "button": "",
      "updated_at": "2021-07-27T00:25:44Z"
    },

コードをかきかき

最後に外部連携のキモとなるコードを書いていきましょう。

(function() {
    'use strict';

    const RTOKEN = トークン;
    const AIRCONID = エアコンのID;

    // レコード保存時にイベント発火
    kintone.events.on(['app.record.create.submit', 'app.record.edit.submit'], event => {

        // 退勤時刻が設定されていない場合に処理開始
        const clockOut = event.record['退勤時刻'].value;
        if(clockOut === undefined) {

            // 部屋をアチアチにするためにNature Remoに投げるパラメータ設定
            const url = `https://api.nature.global/1/appliances/${AIRCONID}/aircon_settings`; 
            const headers = {
                'Authorization': 'Bearer' + RTOKEN, 
                'Content-Type' : 'application/x-www-form-urlencoded'
            };
            const data = 'button=&temperature=30&operation_mode=warm';

            // kintone.proxyでNature Remo Cloud APIを実行
            kintone.proxy(url, 'POST', headers, data)
            .then(resp => {
                return event;
            }).catch(resp => {
                event.error = resp.message;
                return event;
            })
        }
    })
})();