「ログインユーザーの所属組織情報をkintoneで自動取得するUser APIの活用事例を解説します！
kintoneで業務アプリを運用していると、「ログインしているユーザーの所属組織を自動で取得して、
レコードにセットできたら便利なのに…」と感じたことはありませんか？
特に申請・報告系のアプリでは、所属組織や部署名をユーザーが自分で入力すると入力ミスや記載漏れが発生することも。
これを防ぐには、User APIを使って、ログインユーザーの詳細情報を取得する方法が有効です。
■ User APIで取得できる情報
kintoneのユーザー情報には、
- 所属する組織
- 優先する組織（複数組織に属している場合）
- 誕生日や入社日などのプロフィール情報
- 上司の氏名（カスタマイズ項目）
など、ユーザー管理画面では見られるのに、kintoneのJavaScriptAPIのカスタマイズだけでは取得できない情報が含まれています。
■ User APIを使わないと取得できない理由
JavaScriptで kintone.getLoginUser() を使えば、基本情報（名前、メールアドレスなど）は取得できますが、
所属組織などの詳細は含まれません。
そのため、User API を組み合わせる必要があります。
ただし、User APIはエンドポイントや認証設定など、少しだけハードルが高いので、
初めて扱う場合は実装例を参考にするのがおすすめです。
■ 具体的なカスタマイズ例
例えば、新規レコード作成画面で、ログインユーザーの所属組織を自動でセットする場合は・・・
- レコードの作成画面が表示されたタイミングで、
kintone.apiを使って/v1/userエンドポイントを呼び出す - 取得した
organizationsの値を、レコードの組織名フィールドにセットする - 組織情報は複数取得される場合があるため、優先組織を取得するなどロジックを入れる
といった流れで実装します。
■ 所属組織を自動セットするメリット
- ユーザーの入力ミスが防げる
- 組織移動があった場合も管理画面の変更だけで自動反映される
- 申請承認フローの条件分岐を組織単位で柔軟に設定できる
など、日々の運用がぐっと楽になります。
■ まとめ
「所属組織を取得して自動でセットする」
このちょっとした仕組みがあるだけで、ヒューマンエラーの防止や属人化の解消につながります。
User APIの活用は一見ハードルが高く感じるかもしれませんが、
一度仕組みを作ればメンテナンスは最小限で済みます。
kintoneの標準機能だけでは実現できないちょっと便利な自動化カスタマイズ、
ぜひ一度試してみてください！
自分でカスタマイズしてみたい方へ
以下のNote記事で本記事のカスタマイズ事例を紹介しています。
記事内で紹介しているカスタマイズコードは、無料で利用できるので是非挑戦してみて下さい。
「note:アプリ活用研究会（キン活）」は、当サイトのメンバーが執筆しています。
🌸 アプリテンプレートの販売
本記事でご紹介しているアプリテンプレートを、下記の料金プランで販売しています。
導入をご希望の方は、各プランの「お申込み／お問い合わせ」ボタンからお問い合わせください。
■ 料金プラン
◆単品販売（買取型）は、導入サポート付きの価格です。
単品動作タイプは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 #カスタマイズ
