会社情報
採用情報
お問い合わせ
Article

kintoneでチーム業務を簡単効率化

高田晃太郎
kintoneでチーム業務を簡単効率化

知識労働の時間の約4分の1が「探す・連絡する・記録する」に費やされているという指摘は、国内外の複数の調査で繰り返し示されています[1][2]。スプレッドシートやメールを中心に回る現場ほど、このロスは累積し、チーム規模が大きくなるほど可視化されにくいのが現実です。ローコード（少ないコードで業務アプリを構築する）基盤のkintoneは、そのロスを「アプリ」「プロセス管理（状態遷移の設計）」「API」の三点で断続的に削る設計になっており、特に部門横断の案件・申請・顧客管理の文脈で費用対効果が出やすい特徴があります[7][8]。本稿で焦点とするのは、単にアプリを作るだけでなく、簡単に始めて持続的に自動化を拡張できる設計原則と、API・Webhook・デプロイの整備で業務改善の速度を落とさない運用です。以下では、中級〜上級のエンジニアがすぐに適用できる実装例と、判断に役立つベンチマーク観点を交えて解説します。

kintoneで実現する「簡単な自動化」を拡張可能にする設計

kintoneはアプリ（データコンテナ）に、フィールド（入力項目）、アクセス権、プロセス管理（ワークフロー）、通知を組み合わせる発想です。フォーム設計で必須・計算・ルックアップを適切に使い分け、プロセス管理で状態遷移と権限の境界をはっきりさせるだけで、ノーコードのままでも作業抜け漏れは大きく減ります。ポイントは、最初からすべてを自動化しないことです。入力の手戻りが頻発する箇所から最小の自動化を施し、レコードのライフサイクルに沿ってルールを明文化します。ここでの判断基準は、入力頻度、失敗コスト、依存関係の三つを並行に評価し、影響が大きく、設計が閉じている箇所から着手することです。

ガバナンスの観点では、アプリの命名、フィールドIDの規約、権限ロールの分離、ログ取得方針を最初に定義します。将来の拡張に備えて、外部連携の前提となるキー項目（顧客IDや案件IDなど）を早期に固定し、表示名の変更と内部IDの不変性を区別して運用することで、クライアントスクリプトとAPI連携の保守コストを抑えられます。

クライアント側の軽量自動化：入力品質をUIで担保する

ブラウザのカスタマイズで、入力チェックや計算、プロセスの前提確認を即時に行うだけで、後工程の修正工数が目に見えて下がります。次の例では、作成時に金額を自動計算し、閾値を越えたらエラーで差し戻します。処理は同期（画面内で完結）で短時間に終えること、外部API呼び出しは避けることが快適さの鍵です。

/* app.record.create.submit で金額を検証し算出 */
(function() {
  'use strict';
  kintone.events.on(['app.record.create.change.数量','app.record.create.change.単価'], function(event) {
    var r = event.record;
    var q = Number(r['数量'].value || 0);
    var p = Number(r['単価'].value || 0);
    r['金額'].value = q * p;
    return event;
  });
  kintone.events.on(['app.record.create.submit'], function(event) {
    var r = event.record;
    if (Number(r['金額'].value || 0) > 1000000) {
      event.error = '金額が上限を超えています。承認経路を見直してください。';
    }
    return event;
  });
})();

この段階でのエラーはユーザーの手元で完結するためネットワーク待ちがなく、UXを損ねません。複雑なビジネスルールは後述のWebhookやサーバー連携に委譲し、クライアントは軽量・即時であることを貫きます。

REST APIで現場と基幹をつなぐ：堅牢な自動化の背骨

部門横断の自動化では、@kintone/rest-api-clientを使った堅牢な連携が中核になります。認証はAPIトークンやユーザー認証に対応し、プロキシやTLS設定も環境変数で柔軟に扱えます。例として、Node.jsでレコードを作成しつつエラーとタイムアウトに備える実装を示します。

import 'dotenv/config';
import { KintoneRestAPIClient } from '@kintone/rest-api-client';

const client = new KintoneRestAPIClient({
  baseUrl: process.env.KINTONE_BASE_URL!,
  auth: { apiToken: process.env.KINTONE_API_TOKEN! },
  requestOptions: { timeout: 15000 }
});

async function createRecord(app: number) {
  try {
    const res = await client.record.addRecord({
      app,
      record: {
        文字列__1行_: { value: 'API作成' },
        数量: { value: '5' },
        単価: { value: '1200' }
      }
    });
    return res.id;
  } catch (e: any) {
    const msg = e?.message || 'unknown error';
    const code = e?.code || 'NO_CODE';
    throw new Error(`kintone addRecord failed: ${code}: ${msg}`);
  }
}

createRecord(Number(process.env.KINTONE_APP_ID)).then(id => {
  console.log('created id', id);
}).catch(err => {
  console.error(err);
  process.exit(1);
});

大量データでは、HTTPの往復を削減することで劇的に時間短縮できます。kintoneは一度に複数レコードの書き込みや、複数API呼び出しを束ねるBulk Request（まとめ実行）、ページングを抽象化するカーソルAPI（サーバー側で状態を保持して分割取得）を備えています[5][3]。以下はバルク作成の例です。

import { KintoneRestAPIClient } from '@kintone/rest-api-client';

const client = new KintoneRestAPIClient({
  baseUrl: process.env.KINTONE_BASE_URL!,
  auth: { apiToken: process.env.KINTONE_API_TOKEN! }
});

async function bulkInsert(app: number, rows: any[]) {
  const chunkSize = 100; // 公式仕様の上限に従う
  for (let i = 0; i < rows.length; i += chunkSize) {
    const slice = rows.slice(i, i + chunkSize);
    const payload = { app, records: slice };
    await client.record.addRecords(payload);
  }
}

bulkInsert(Number(process.env.KINTONE_APP_ID), Array.from({ length: 500 }, (_, i) => ({
  文字列__1行_: { value: `row-${i}` }
}))).catch(console.error);

取得側はカーソルAPIが有効です。大量ページングでもメモリを圧迫せず、一定サイズでストリーミング処理できます[3][4]。

import { KintoneRestAPIClient } from '@kintone/rest-api-client';

const client = new KintoneRestAPIClient({
  baseUrl: process.env.KINTONE_BASE_URL!,
  auth: { apiToken: process.env.KINTONE_API_TOKEN! }
});

async function* streamRecords(app: number, fields: string[], size = 500) {
  const { id } = await client.record.createCursor({ app, fields, size });
  try {
    while (true) {
      const page = await client.record.getRecordsByCursor({ id });
      for (const r of page.records) yield r;
      if (!page.next) break;
    }
  } finally {
    await client.record.deleteCursor({ id }).catch(() => void 0);
  }
}

(async () => {
  for await (const r of streamRecords(Number(process.env.KINTONE_APP_ID), ['レコード番号','文字列__1行_'])) {
    // 処理
  }
})();

Bulk Requestで複数操作を一括実行することも可能です。承認と更新、コメント投稿をひとまとめにして整合性を高められます[5]。

import { KintoneRestAPIClient } from '@kintone/rest-api-client';

const client = new KintoneRestAPIClient({
  baseUrl: process.env.KINTONE_BASE_URL!,
  auth: { apiToken: process.env.KINTONE_API_TOKEN! }
});

async function approveAndComment(app: number, id: string) {
  await client.bulkRequest.send({
    requests: [
      {
        method: 'PUT',
        api: '/k/v1/record/status.json',
        payload: { app, id, action: '承認', assignee: null }
      },
      {
        method: 'PUT',
        api: '/k/v1/record.json',
        payload: { app, id, record: { ステータス: { value: '承認済み' } } }
      },
      {
        method: 'POST',
        api: '/k/v1/record/comment.json',
        payload: { app, record: id, comment: { text: '自動承認完了' } }
      }
    ]
  });
}

実運用では、1件ずつのAPI呼び出しを避け、100件程度のバッチにまとめるだけでHTTP往復が減り、総処理時間が目に見えて短縮されるケースがよくあります（ネットワークとサーバー負荷に依存しますが、数十％の短縮が観測されることもあります）。前提は、往復回数の削減が自動化の体感速度を押し上げるという原理です。

Webhook駆動で「人の待ち時間」をゼロにする

状態遷移やレコード更新をトリガーにWebhook（更新イベントを外部URLへ通知する仕組み）を発火し、外部の承認・請求・チャット通知を自動化します。セキュリティ上はWebhookトークンを検証し、リトライに備えた冪等（同じイベントを複数回受けても結果が一意）実装を徹底します。次はExpressでの受信例です。

import express from 'express';
import crypto from 'node:crypto';

const app = express();
app.use(express.json());

const WEBHOOK_TOKEN = process.env.KINTONE_WEBHOOK_TOKEN!;

app.post('/kintone/webhook', (req, res) => {
  const token = req.get('X-Cybozu-Webhook-Token');
  if (token !== WEBHOOK_TOKEN) return res.status(401).send('unauthorized');
  const body = req.body;
  try {
    const eventType = body?.type;
    const record = body?.record;
    if (eventType === 'ADD_RECORD') {
      // 外部システム連携や通知
    }
    res.status(200).send('ok');
  } catch (e) {
    // 冪等化のため、処理の重複を避けるキーを用意する
    console.error(e);
    res.status(202).send('deferred');
  }
});

app.listen(3000, () => console.log('listening'));

Webhookはネットワーク障害を前提に設計します。イベントIDを外部ストアに記録し、同一IDの再処理をスキップするだけで、不具合報告は大幅に減ります。通知は人を動かす最後の一押しになるため、チャットやメールに過度な情報を流さないフィルタリングも重要です。

デプロイと運用：カスタマイズをチームで回す

kintoneのカスタマイズはGUIで即時に反映できますが、チーム運用ではコードと設定をバージョン管理し、環境ごとに安全に昇格させる仕組みが欠かせません。公式ツールのkintone-customize-uploaderをCIから呼び出し、アプリごとにマニフェストで依存を固定します[6]。次の例は最小のマニフェストとnpmスクリプトです。

{
  "manifest_version": 1,
  "type": "APP",
  "app": {
    "desktop": {
      "js": [
        { "path": "dist/app-desktop.js" }
      ],
      "css": []
    }
  }
}

{
  "name": "kintone-app-customize",
  "private": true,
  "scripts": {
    "build": "esbuild src/index.ts --bundle --minify --outfile=dist/app-desktop.js",
    "upload:stg": "kintone-customize-uploader --base-url $K_BASE --username $K_USER --password $K_PASS --app-id $K_APP --manifest ./customize-manifest.json",
    "upload:prod": "kintone-customize-uploader --base-url $K_BASE --api-token $K_TOKEN --app-id $K_APP --manifest ./customize-manifest.json"
  },
  "devDependencies": {
    "esbuild": "^0.23.0",
    "kintone-customize-uploader": "^6.0.0"
  }
}

設定値は環境変数を使い、資格情報の取り扱いはCIのシークレット管理に委ねます。ステージングと本番のアプリIDは別にし、スキーマ変更はエクスポート・インポートで検証してから段階的に反映します。ブラウザ側のカスタマイズはサイズと依存を最小化し、Polyfillをむやみに含めない構成にすると初期表示が速くなります。一般に、未圧縮ライブラリの排除やバンドルサイズの削減は初回表示の数百ms〜秒単位の改善につながることが多く、体感性能の向上に直結します。

信頼性の確保：テスト・監視・障害対応

ユニットテストはビジネスロジックをNode側に寄せて行い、ブラウザカスタマイズはE2Eで重要経路のみを自動化します。外部連携の監視にはWebhook受信の成功率、APIのレイテンシ分布、バルク処理の1ロットあたり平均処理時間をダッシュボード化します。障害時は手動運用に切り替えるフローを用意し、プロセス管理のアクションで「手動処理中」の状態に遷移させると、現場とITの認識齟齬を防げます。変更管理はプルリクベースでレビューし、フィールドIDやプロセス名の変更がAPIに波及しないかをチェックリスト化します。

費用対効果を意思決定に落とし込む：小さく始めて大きく育てる

導入の意思決定では、開発費ではなく回収速度に注目します。申請や案件登録のように入力点が多く、後工程の手戻りが高いプロセスから着手すると、短期間で効果が見えます。例えば、入力補助と自動通知だけでも、担当者の着手までの待ち時間が縮まり、承認の滞留が減ります。そこで得たデータをもとに、API連携に投資すべきか、プロセスの分割が先かを判断します。実務感のある目安として、レコード件数、平均処理時間、エラー再入力率、通知の既読率を毎週の改善会で確認し、次に解くボトルネックを1点に絞ります。ローコードの価値はスピードにありますが、スピードを支えるのは、命名規約、環境分離、監査ログといった地味な土台です。これらの土台をチームで合意し、最小構成から段階的に自動化を広げることが、結果的に簡単で壊れにくい業務改善につながります。

参考の内部知見と関連リソース

現場導入でよく問われるのは、どこまでアプリで、どこからAPIかという線引きです。入力の即時性とオフライン耐性が重要ならクライアント、整合性と可観測性が重要ならサーバー側に寄せる、という判断が現実的です。より詳しい設計パターンやROIの試算テンプレートは、チーム内のナレッジに集約しておくと横展開が速まります。

まとめ：チームが前に進むための最小の自動化から

kintoneは、フォーム作成の簡単さとAPI・Webhookの拡張性が同居した基盤です。入力の品質をUIで担保し、重い整合性はサーバーで守り、デプロイと監視でチームに馴染ませる。たったこれだけの原則でも、日々の小さな待ち時間や認識ズレは目に見えて減ります。明日からできる一歩として、最も失敗コストが高い入力点に軽い自動化を入れ、次に往復回数を減らす連携を一つだけ選び、効果の数値を一週間で測ってみてください。あなたのチームにとっての簡単な自動化は、今日の小さな決断から始まります。どのプロセスから変えていくか、今この瞬間に選ぶとしたら、どこでしょうか。

参考文献

  1. APQC Survey Finds One Quarter of Knowledge Workers’ Time Is Lost Due to Productivity Drains. Business Wire. https://www.businesswire.com/news/home/20211109005449
  2. 業務における情報収集に要する時間（IDC調査の紹介）. TechTargetジャパン（ホワイトペーパー）. https://wp.techtarget.itmedia.co.jp/contents/25417#:~:text=%E3%81%9D%E3%81%93%E3%81%A7%E6%B3%A8%E7%9B%AE%E3%81%97%E3%81%9F%E3%81%84%E3%81%AE%E3%81%AF%E3%80%81%E6%A5%AD%E5%8B%99%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B%E6%83%85%E5%A0%B1%E5%8F%8E%E9%9B%86%E3%81%AB%E8%A6%81%E3%81%99%E3%82%8B%E6%99%82%E9%96%93%E3%81%A0%E3%80%82
  3. カーソルAPI. cybozu developer network（kintone REST API ドキュメント）. https://cybozu.dev/ja/kintone/docs/rest-api/records/cursor/
  4. カーソルAPIを使った大量レコード取得のポイント（offsetとの比較）. cybozu developer network. https://cybozu.dev/ja/kintone/miscellaneous/archive-tips/bulk-get-records-using-cursor-api/
  5. Bulk Request API. cybozu developer network（kintone REST API ドキュメント）. https://cybozu.dev/ja/kintone/docs/rest-api/records/bulk-request/
  6. カスタマイズ中級者向け：bulk uploadとマニフェストファイル・uploader活用. cybozu developer network. https://cybozu.dev/ja/kintone/tips/development/customize/development-know-how/javascript-customize-middle-class-bulk-upload/
  7. 課題解決ソリューション（kintone導入効果・活用領域の紹介）. サイボウズ オフィシャル. https://kintone-sol.cybozu.co.jp/success/solution-sol/sol001.html
  8. 事例：ロジスティードにおける業務プロセス改善と標準化の取り組み. サイボウズ オフィシャル. https://kintone-sol.cybozu.co.jp/cases/logisteed.html