これまで複数の記事で、Monacaアプリにてkintoneのデータを操作するデモアプリを解説してきました。

今回は少し趣向を変えて、サーバーサイドや手元の環境からkintoneのデータを操作してみます。サーバー側からデータをメンテナンスできるようになれば、自社システムやデータベースとの連携もできるようになるでしょう。

利用する言語

今回はNode.jsを利用します。適当なフォルダを作成し、Node.jsプロジェクトとして初期化します。

$ mkdir kintone-nodejs-demo
$ cd kintone-nodejs-demo
$ npm init -y

利用するライブラリ

kintone公式のNode.js向けライブラリ kintone-nodejs-sdk を利用します。

$ npm i kintone-nodejs-sdk

コードを書く

ここからは index.js を作成し、そこにコードを書いていきます。まず kintone-nodejs-sdk を読み込みます。

const kintone = require("kintone-nodejs-sdk");

認証情報を記述する

今回はサーバーサイドからバッチ処理で複数データを更新する想定です。そこでkintoneのドメイン、認証情報を記述します。この認証は管理者ユーザーなどが良いでしょう。

const kintoneDomain = "your-domain.cybozu.com";
const username = "YOUR_USER_NAME";
const password = "YOUR_PASSWORD";

そして認証情報をセットします。

const kintoneAuth = (new kintone.Auth()).setPasswordAuth(username, password);
const kintoneConnection = new kintone.Connection(kintoneDomain, kintoneAuth);

利用するアプリを定義する

kintoneアプリのIDを決めておきます。

const appID = 999;

kintone Recordオブジェクトの定義

kintoneのデータを操作するkintone Recordオブジェクトを定義します。

const kintoneRecord = new kintone.Record(kintoneConnection);

データの検索・取得

kintoneを検索してデータを取得します。今回のクエリーストリングは自分のkintoneアプリに合わせて変更してください。書き方はQuery string - Kintone Developer Programにて説明されています。

const { records } = await kintoneRecord.getRecords(appID, "出庫メーター = 51000");

内容は以下のようになります。

[
  {
    "運行履歴テーブル": { type: "SUBTABLE", value: [Array] },
    "レコード番号": { type: "RECORD_NUMBER", value: "13" },
    "運行終了": { type: "TIME", value: "18:00" },
    "更新者": { type: "MODIFIER", value: [Object] },
    "運転年月日": { type: "DATE", value: "2022-03-10" },
    "ステータス": { type: "STATUS", value: "未提出" },
    "休憩仮眠履歴テーブル": { type: "SUBTABLE", value: [] },
    "立替金詳細テーブル": { type: "SUBTABLE", value: [] },
    "点検事項": { type: "CHECK_BOX", value: [Array] },
    "オイル補充量": { type: "NUMBER", value: "" },
    "入庫メーター": { type: "NUMBER", value: "50500" },
    "高速券使用枚数": { type: "NUMBER", value: "" },
    "運行時間数": { type: "CALC", value: "09:00" },
    "車輌番号": { type: "SINGLE_LINE_TEXT", value: "100" },
    "作業者": { type: "STATUS_ASSIGNEE", value: [] },
    "作成者": { type: "CREATOR", value: [Object] },
    "運行開始": { type: "TIME", value: "09:00" },
    "$revision": { type: "__REVISION__", value: "7" },
    "更新日時": { type: "UPDATED_TIME", value: "2023-01-25T01:44:00Z" },
    "出庫メーター": { type: "NUMBER", value: "51000" },
    "ガソリン補充量": { type: "NUMBER", value: "" },
    "運転者氏名": { type: "USER_SELECT", value: [Array] },
    "立替え金合計": { type: "CALC", value: "" },
    "差引走行距離": { type: "CALC", value: "-500" },
    "作成日時": { type: "CREATED_TIME", value: "2022-05-23T08:59:00Z" },
    "$id": { type: "__ID__", value: "13" }
  },
    : // 中略
  {
    "運行履歴テーブル": { type: "SUBTABLE", value: [] },
    "レコード番号": { type: "RECORD_NUMBER", value: "2" },
    "運行終了": { type: "TIME", value: "18:00" },
    "更新者": { type: "MODIFIER", value: [Object] },
    "運転年月日": { type: "DATE", value: "2022-03-10" },
    "ステータス": { type: "STATUS", value: "未提出" },
    "休憩仮眠履歴テーブル": { type: "SUBTABLE", value: [] },
    "立替金詳細テーブル": { type: "SUBTABLE", value: [] },
    "点検事項": { type: "CHECK_BOX", value: [Array] },
    "オイル補充量": { type: "NUMBER", value: "" },
    "入庫メーター": { type: "NUMBER", value: "50500" },
    "高速券使用枚数": { type: "NUMBER", value: "" },
    "運行時間数": { type: "CALC", value: "09:00" },
    "車輌番号": { type: "SINGLE_LINE_TEXT", value: "" },
    "作業者": { type: "STATUS_ASSIGNEE", value: [] },
    "作成者": { type: "CREATOR", value: [Object] },
    "運行開始": { type: "TIME", value: "09:00" },
    "$revision": { type: "__REVISION__", value: "7" },
    "更新日時": { type: "UPDATED_TIME", value: "2023-01-25T01:44:00Z" },
    "出庫メーター": { type: "NUMBER", value: "51000" },
    "ガソリン補充量": { type: "NUMBER", value: "" },
    "運転者氏名": { type: "USER_SELECT", value: [Array] },
    "立替え金合計": { type: "CALC", value: "" },
    "差引走行距離": { type: "CALC", value: "-500" },
    "作成日時": { type: "CREATED_TIME", value: "2022-04-15T06:50:00Z" },
    "$id": { type: "__ID__", value: "2" }
  }
]

更新情報の作成

取得した情報（ID、リビジョン）を使って更新情報を作成します。今回は取得した出庫メーターの値を +1000 しています。レコードの値は文字列なので、parseIntして数字にしています。この仕様はRecord - kintone Node.js SDKを参照してください。

const updateRecords = records.map((record) => {
    return {
        id: record.$id.value,
        revision: record.$revision.value,
        record: {
            "出庫メーター": {
                value: parseInt(record.出庫メーター.value) + 1000,
            },
        },
    };
});

更新する

作成した updateRecords を使って更新処理を実行します。

const response = await kintoneRecord.updateRecords(appID, updateRecords);

レスポンスは以下のようになります。revisionが1つ上がっているはずです。

{
  records: [
    { id: "13", revision: "8" },
    { id: "12", revision: "8" },
    { id: "11", revision: "8" },
    { id: "10", revision: "8" },
    { id: "9", revision: "8" },
    { id: "8", revision: "8" },
    { id: "7", revision: "8" },
    { id: "6", revision: "8" },
    { id: "5", revision: "8" },
    { id: "4", revision: "8" },
    { id: "3", revision: "8" },
    { id: "2", revision: "8" }
  ]
}

全体のコード

今回のコードです。実装時の参考にしてください。

const kintone = require("kintone-nodejs-sdk");

const username = "YOUR_USER_NAME";
const password = "YOUR_PASSWORD";
const kintoneDomain = "your-domain.cybozu.com";

const kintoneAuth = (new kintone.Auth()).setPasswordAuth(username, password);
const kintoneConnection = new kintone.Connection(kintoneDomain, kintoneAuth);

const appID = 99;

(async () => {
    const kintoneRecord = new kintone.Record(kintoneConnection);
    try {
        const { records } = await kintoneRecord.getRecords(appID, "出庫メーター = 51000");
        const updateRecords = records.map((record) => {
            return {
                id: record.$id.value,
                revision: record.$revision.value,
                record: {
                    "出庫メーター": {
                        value: parseInt(record.出庫メーター.value) + 1000,
                    },
                },
            };
        });
        const response = await kintoneRecord.updateRecords(appID, updateRecords);
    } catch (error) {
        console.log(error);
    }
})();

まとめ

まとめてアップデートや削除などができるのは便利です。システム連携する際に利用できるでしょう。

kintoneアプリを自動化したり、システム連携する際にはNode.js SDKを活用してみると良さそうです。