kintone tips

kintoneをより使いこなすための情報を提供するサイトです。

REST API

レコードの追加(1件)

kintone REST APIを使用して、レコードを1件追加する方法を紹介します。必要な権限や注意点、Node.jsやGAS、curlでのサンプルコードも掲載しています。

レコードの追加(複数件)

kintone REST APIを使用して、レコードを複数件追加する方法を紹介します。Node.jsやGASでのサンプルコードも掲載しています。

APIトークンと認証

kintone REST API の認証方法(API トークン認証・パスワード認証・セッション認証)の仕組みと使い分けを解説します。API トークンの発行手順、複数トークンの運用、セキュリティ上の注意点、外部サービスとの連携時の認証設定まで

アプリ設定API

kintone REST API を使ってアプリの設定を取得・変更する方法を解説します。フィールドの追加・削除、フォームレイアウトの変更、アプリのデプロイまで、プログラムからアプリ設定を操作する方法を紹介します。

bulkRequest

kintone REST API の bulkRequest を使って、複数のAPI操作を1回のリクエストでまとめて実行する方法を解説します。トランザクション的な一括処理、アプリ間のデータ同期、デリートインサートの安全な実装方法を紹介します

コメントAPI

kintone のレコードコメント API を使って、コメントの追加・取得・削除を行う方法を解説します。メンション機能の活用方法やページング取得のパターンも紹介します。

カーソルAPI

kintone のカーソル API を使って 10,000 件を超える大量レコードを安全に取得する方法を解説します。カーソルの作成・取得・削除の基本操作から、全件取得の汎用関数、運用上の注意点まで紹介します。

レコードのデリートインサート

APIを使ってレコードを更新したい場合、基本的にはPUT APIを使用します。ただ、仕様や安全性を考慮し、一定条件のレコードを全て削除したうえで、レコードを再生成しなければならない状況も起こりえます。今回はそういった場合のコードサンプルを紹

レコードの削除

kintone REST APIを使用して、レコードを削除する方法を紹介します。1件の場合と複数件の場合で使用方法に変わりありません。1回あたり100件までの制限や、Node.jsやGASでのサンプルコードも掲載しています。

ファイルのアップロード・ダウンロード

kintone REST API を使って添付ファイルのアップロード・ダウンロードを行う方法を解説します。ファイルキーの取得、Blob を使ったダウンロード、JavaScript からのファイル添付レコード登録まで紹介します。

プラグイン開発

JavaScript API

条件付き書式(行の色分け)

kintone の一覧画面(レコード一覧)で、フィールドの値に応じて行の背景色やテキストの色を動的に変更する条件付き書式の実装方法を、JavaScript/CSS を使ったサンプルコード付きで解説します。

確認ダイアログの実装

kintone のレコード操作前に確認ダイアログを表示する方法や、処理完了後にカスタム通知(トースト)を表示する方法を JavaScript で実装する手順をサンプルコード付きで解説します。

アプリ間のデータ連携

kintone の複数アプリ間でデータを連携する方法を解説します。REST API を使ったレコードのコピー、マスターアプリからのデータ参照、アプリ間の集計、レコード保存時の自動同期など、実務で頻出するパターンを紹介します。

カスタムビュー

kintone のカスタムビュー(カスタマイズビュー)を使って、独自の HTML と JavaScript でレコード一覧を自由にカスタマイズする方法を解説します。カード型レイアウト、集計ダッシュボード、カレンダー表示などの実装例を紹介しま

日付・日時フィールドの処理

kintone の日付(DATE)、時刻(TIME)、日時(DATETIME)フィールドを JavaScript で操作する方法を解説します。フォーマットの違い、タイムゾーンの考慮、日付計算、期間の判定など実践的なパターンを紹介します。

フィールド値の変更イベント

kintone JavaScript カスタマイズにおけるフィールド値変更イベント(app.record.create.change.フィールドコード)の使い方を解説します。ドロップダウン・ラジオボタン・チェックボックスなどの変更を検知し、

フィールドの入力制限・可否の変更

アプリの各フィールドの入力可否を操作する方法を解説します。ルックアップと関連付けたフィールドは入力不可になりますが、今回紹介する方法で手入力可能にできます。再度ルックアップを取得したタイミングや、データの取り込みを行ったタイミングで手入力部

フィールドの表示/非表示

kintone JavaScript カスタマイズで、フィールドの表示・非表示を動的に切り替える方法を解説します。setFieldShown を使った基本的な使い方から、条件に応じた制御、グループフィールドやテーブルとの組み合わせまで紹介し

フィールドの値を文字列として取得

kintoneではREST APIを使ってレコード情報を取得することができますが、各フィールドが持つ値はフィールドタイプによって異なります。

サンプル - レコードIDを取得する

kintoneのJavaScriptカスタマイズで、現在表示中・編集中のレコードのレコードIDを取得する方法を紹介します。kintone.app.record.getId()とevent.recordIdの違い、nullが返る条件、保存後に

外部連携

Chatwork - メッセージの送信

引数に各パラメータを設定することで利用できます。`kintone.proxy`はコールバックを渡さない場合 Promise を返すので、送信結果を確認してから処理したい場合は、以下のように `then` もしくは `await` を使用しま

Chatwork - ユーザー一覧の取得

kintone.proxyとChatwork APIの GET /contacts を使い、APIトークンを発行したユーザーのコンタクト一覧をkintoneから取得する方法を解説します。レスポンスの形式、JSON.parse、エラー時のステ

Google Apps Script 連携

Google Apps Script(GAS)から kintone REST API を呼び出してデータを取得・登録・更新する方法を解説します。Google スプレッドシートとの双方向同期、認証の設定、ページネーション対応まで紹介します。

Slack - 通知の送信

kintone の JavaScript カスタマイズから Slack に通知を送る方法を解説します。Incoming Webhook を使った基本的な通知の送信から、レコード情報を含むリッチな通知、レコード保存時の自動通知まで紹介します。

Microsoft Teams 通知

kintone から Microsoft Teams に通知を送信する方法を解説します。Incoming Webhook を使ったシンプルな通知から、Adaptive Card を使ったリッチ通知、レコード保存時の自動通知まで紹介します。

Webhook

kintone の Webhook 機能を使って、レコードの追加・更新・削除やステータス変更時に外部サービスへ自動通知する仕組みを解説します。Webhook の設定手順、受信側の実装例、セキュリティの考慮点まで紹介します。

kintoneカスタマイズ入門

サンプル集 - app.record.edit.show

kintoneのJavaScriptカスタマイズについての情報は多く存在しますが、「じゃあ、結局やりたいことを実現させるためにはどうすればいいの?」という問題を簡単に解決することが難しいように感じました。今回はいくつかのサンプルコードを使っ

サンプル集 - app.record.index.show

kintoneのJavaScriptカスタマイズについての情報は多く存在しますが、「じゃあ、結局やりたいことを実現させるためにはどうすればいいの?」という問題を簡単に解決することが難しいように感じました。今回はいくつかのサンプルコードを使っ

非同期処理(async/await)

JavaScriptカスタマイズを行う上でよく利用する非同期処理を実装する方法と、実装する上での注意点を紹介します。kintone.events.onに登録した関数は引数として受け取ったeventを最終的にreturnします。この関数を非同

CSSカスタマイズの基本

kintone の CSS カスタマイズの基本を解説します。フィールドやヘッダーの見た目を変更する方法から、条件に応じた行の背景色変更、フィールドの非表示、レスポンシブ対応まで幅広く紹介します。

デバッグとトラブルシューティング

kintone の JavaScript カスタマイズにおけるデバッグ手法を体系的に解説します。Chrome DevTools の活用、console メソッド、ブレークポイント、ネットワークタブによる API 通信の確認、よくあるエラーと

エラーハンドリング

kintoneのJavaScriptカスタマイズで、event.errorやフィールドのerrorプロパティ、try-catchを使ってエラーを画面に表示する方法と、ボタンクリック時など非同期イベントでの注意点を解説します。

kintone.events.onを効率化する

kintoneカスタマイズを行う際、必ずと言っていいほど記述するコードは何でしょうか?kintoneが独自に用意する関数やプロパティはいろいろありますが、kintone.events.onは誰しもが頻繁に使用されていると思います。1つのアプ

全体の構造とevents.on

実用的なサンプルを交えながら、kintoneにおけるJavaScriptカスタマイズの使い方を紹介します。基本的なプログラムの構造から、スペースフィールドにボタンを設置する方法までを解説しています。

グローバル変数

kintoneではグローバル変数・定数は基本的に使用禁止です。ただやむを得ず使用したい場合の対処法がガイドラインに定義されています。その定義方法・パターンをいくつか紹介します。

利用しているデバイスの判定

PC版とスマートフォン版、1つのアプリでできれば同じJavaScriptファイルを使いたいですよね。kintoneについてはURLも発生イベントもデバイスによって異なりますし、全く同じコードを使用することはできません。リソースを共有するため

デザイン

Tips

APIのバックドア

kintoneで、ユーザーにアクセス権限のないアプリのデータをJavaScriptカスタマイズからだけ取得する方法を解説します。アプリ単位のAPIトークンとkintone.proxyを組み合わせる手法と、セキュリティ上の注意点を紹介します。

定数定義

定数定義は本当に様々な方法で実装可能なため、どのように実装するのがベストなのか、今でもよく悩むところです。今回は、僕が実際に採用してうまくいった方法を紹介したいと思います。

レコード一覧・詳細画面にボタンを設置するサンプル

kintoneのJavaScriptカスタマイズで、レコード一覧・詳細・編集画面にボタンを設置する方法をサンプルコード付きで紹介します。ヘッダ領域を取得するAPIの使い分けや、複数画面で処理を共通化する方法も解説します。

フィールドコードの命名

kintoneで作成できるアプリには様々なフィールドが存在し、その全てにフィールド名とフィールドコードを割り振る必要があります。フィールド名は主にユーザーが見える部分に、フィールドコードは主にアプリ管理者およびJavaScriptで参照する

ダウンロード機能の実装

kintoneの一覧画面にワンクリックのCSVダウンロードボタンをJavaScriptカスタマイズで設置する方法を紹介します。BOM付きUTF-8、ダブルクォートのエスケープ、取得件数の制限など、実装時の注意点も解説します。

1文字単位での検索

kintoneのフィールド検索は、日本語は2文字以上、英数字は単語単位でしか検索できません。標準機能では解決できないこの制約を、1文字単位の検索を可能にする無料のオープンソースプラグインで解決する方法を紹介します。

Webフォントの適用

kintoneの標準フォントは設定で変更できません。Google FontsのURLをJavaScript/CSSカスタマイズに追加し、Noto Sans JPなどのWebフォントをkintone全体や特定のアプリに適用する手順を解説します

IE廃止の影響

IE11のサポート終了により、kintoneのJavaScriptカスタマイズでIE対応のための古い書き方が不要になりました。IE廃止がkintone開発に与える影響と、今後のコーディングで避けるべき var やPromiseチェーンの代わ

もっと読む