kintoneの新JS関数でユーザー情報のカスタマイズ項目を取得する- kintone活用Navi

📢 2025年8月10日リリースの新API

kintoneに「ログインユーザーのカスタマイズ項目を取得する」新しいJavaScript関数が登場しました。

関数名：kintone.user.getCustomFields()

これまで、ユーザー情報のカスタマイズ項目を取得するにはUser APIを使う必要がありましたが、今回の新しいJavascriptAPI（JS関数）で簡単に取得できるようになり、コードの記述方法もスッキリ！
しかも、API利用回数制限の対象外なのも大きなポイントです。

⚙ そもそも「カスタマイズ項目」って何？

カスタマイズ項目とは、kintoneのユーザー情報に自由に追加できる項目のこと。
例えば「上司」「特技」「出身県」など、最大50個まで作れます。
※Cybouz共通管理者の権限が必要です！

設定方法はとても簡単で、

サイボウズ共通管理の「組織とユーザー」から
「プロフィール項目の設定」ボタンをクリックし、
カスタマイズ項目の欄を追加・編集するだけ。

入力形式は「テキスト1行」か「ユーザー選択」のどちらかを選べます。
例えば「上司（ユーザー選択型）」「特技（テキスト型）」のように設定可能です。

⛳ 実際の活用イメージ

例えば、新規レコード作成画面を開いたときに…

「特技」フィールドに、ログイン中の自分の特技を自動入力
「上司」フィールドに、自分の上司を自動設定

といったことが、ほんの数行のコードでできちゃいます。
入力の手間がなくなり、ミスも防げます。

💻 サンプルコード（シンプル版）

以下は、分かりやすさ重視の最小構成サンプルです。
フィールド存在チェックや型チェックは省略しています。

サンプルコードは、MITライセンスなので、自由に使っていただいて問題ありません。

/* ログインユーザーのカスタマイズ項目を取得する
 * sample:kintone.user.getCustomFields()
 * Distributor: https://note.com/appgroup
 * Copyright (c) 2025 Application Utilization Study Group
 * Licensed under the MIT License
 ------------------------------------------------------------*/
(function () {
  "use strict";

  const EVENTS = ["app.record.create.show", "app.record.edit.show"];
  kintone.events.on(EVENTS, async (event) => {
    // ユーザーカスタマイズ項目の取得（新API）
    const customFields = await kintone.user.getCustomFields();

    // ログインユーザー名のセット
    event.record["ユーザー名"].value = kintone.getLoginUser().name;

    // カスタム項目：特技（skill）の取得とセット
    const skill = customFields.find(f => f.code === "skill");
    event.record["特技"].value = skill?.value ?? "";

    // カスタム項目：上司（boss）の取得とセット
    const boss = customFields.find(f => f.code === "boss");
    event.record["上司"].value = boss?.value ? [{ code: boss.value.code, name: boss.value.name }] : [];

    return event;
  });
})();

📌 ここがスゴイ！新関数のメリット

API利用回数制限なし
REST APIの利用回数の制限（例：1アプリ1日1万回）を気にせず利用可能。
コードがシンプル
User API経由でJSON処理していた部分が不要に。
応用が広い
- 特技や役職に応じて画面表示を変える
- プロセス管理の「決裁者」に上司を自動セット
- メッセージ表示や承認ルート分岐などにも活用可能

🎯 まとめ

これまで面倒だった「ログインユーザーのカスタマイズ項目取得」が、1行の関数で完了する様になりました。
特に「上司」や「特技」などの情報を使った自動化・条件分岐が、もっと手軽にできるようになります。
新しいJS関数を使えば、API利用回数制限の対象外なのも嬉しいですね。

💡 ポイント
「ユーザーの上司を自動取得して決裁者欄に入れる」などの事例は、従来のUser API版も参考になるので、必要に応じてチェックしてみてください。

🔨 自分でカスタマイズしてみたい方へ

以下のNote記事で本記事のカスタマイズ事例を紹介しています。
記事内で紹介しているカスタマイズコードは、無料で利用できるので是非挑戦してみて下さい。

「note:アプリ活用研究会（キン活）」は、当サイトのメンバーが執筆しています。

ログインユーザーのカスタマイズ項目を取得する｜アプリ活用研究会（キン活）

新しいAPIの紹介 2025年8月10日にリリースされたkintoneの新API紹介の続きです。ログインユーザーのカスタマイズ項目を取得する関数名：kintone.user.getCustomFields() 何が出来るのか？ Cybouz共通管理のユーザー情報のカスタマイズ項目の値を取得します。カスタマイズ項目とは、ユーザー情報に最大50個まで任意で追加できる入力項目です。入力タイプは、テキスト1行型とユーザー選択型が選べます。カスタマイズ項目は、Cybouz共通管...

🌸 アプリテンプレートの販売

本記事でご紹介しているアプリテンプレートを、下記の料金プランで販売しています。
導入をご希望の方は、各プランの「お申込み／お問い合わせ」ボタンからお問い合わせください。

■ 料金プラン

◆単品販売（買取型）は、導入サポート付きの価格です。
　単品動作タイプは60,000円、２アプリ連携タイプは100,000円、3つ以上連携タイプは150,000円です。
◆簡易サポート契約では、当サイトのアプリテンプレートとプラグインを合計6種類までご利用できます。
◆会員サポート契約では、ご利用範囲「無制限」で運用ヘルプデスク対応までフルサービスでご提供します。

項目	単品販売	簡易サポート	会員サポート
料金体系	60,000円 (税抜)	120,000円 (税抜)	360,000円 (税抜)
契約期間	なし	毎年更新	6か月更新
導入サポート	✔	✔	✔
メールサポート	×	✔	✔
チャットサポート	×	✔	✔
バージョンアップ対応	×	✔	✔
運用ヘルプデスク対応	×	×	✔
商品のご利用範囲	本商品のみ	6種類までご利用可能ユーザー数10名まで	無制限ユーザー数30名まで
お問い合わせ／お申し込み	購入する	お申込み	お問い合わせ

🏫 kintone人材育成研修

この様なカスタマイズを自分で出来る様になりたい方は、当サイトの「Kintome人材育成」上級コースの受講をご検討して下さい。当サイトのTIPSで紹介しているカスタマイズ例のテンプレートを使えば、簡単に実装出来ます！
上級コースの受講者には、特典で当サイトのカスタマイズテンプレート（3種類まで）と３か月のサポート契約を無償でご提供しています。

研修目的を「カスタマイズテンプレートのアプリ導入」とする研修メニューもご提案可能です。

📣カスタマイズ・導入支援いたします！

本記事の様な「kintoneアプリのカスタマイズ」をご希望の企業様へ
kintoneを便利に活用できるカスタマイズと運用支援は、ぜひ当社にご相談ください！

お問い合わせはこちらからどうぞ！

#kintone #Javascript #カスタマイズ

Tips

JS関数でユーザー情報のカスタマイズ項目を取得する