ユーザーが所属する組織を取得する

目次

ユーザーが所属する組織を取得する

ユーザーが所属する組織を取得します。
ユーザーの情報を元にした分岐処理や、ユーザーの情報を表示するUIの作成などに利用できます。
「別言語での表示名」を設定できる項目の値は、このAPIを実行するユーザーが設定した言語で返ります。

このAPIは非同期なAPIです。
同期的に処理したい場合は、次のページを参照してください。

関数

PC/モバイル
kintone.user.getOrganizations(code)

引数

引数名 型 必須 説明
code 文字列 省略可 情報を取得するユーザーのログイン名
省略した場合はログインユーザーの情報を取得します。

戻り値

戻り値はPromiseオブジェクトです。
Promiseオブジェクトの解決時に次の要素をもつオブジェクトの配列が取得できます。

プロパティ名 型 値と説明
organization オブジェクト 組織情報
organization.id 文字列 組織ID
organization.code 文字列 組織コード
organization.name 文字列 組織名
organization.primary 真偽値 優先する組織かどうか
  • true:優先する組織である
  • false:優先する組織ではない
title オブジェクト 役職情報
未設定の場合にはnullが返ります。
title.id 文字列 役職ID
title.code 文字列 役職コード
title.name 文字列 役職名

利用できる画面

PC/モバイル

利用できる画面は、全体カスタマイズの適用画面に従います。
kintone全体のカスタマイズが適用される画面

ただし、次の画面では利用できません。

  • 検索画面
  • アプリストア
  • プラグイン設定画面

注意事項

このAPIは実行時にサーバーからデータを取得します。取得したデータは画面遷移が発生するまでキャッシュされます。
ユーザーごとに1分当たり50回を超えるサーバーからのデータの取得があった場合、戻り値のPromiseオブジェクトが拒否(rejected)されます。

  • ユーザーが所属する組織の他の情報を取得したい場合には、次のAPIを利用してください。
    組織を取得する

公式コミュニティ

kintone開発者同士で質問や知見を共有し、学び合うことができます。