獲取使用者所屬的組織
連結已複製
取得使用者所屬的組織。
可用於根據使用者資訊進行分支處理，以及建立顯示使用者資訊的UI。
將以執行此API的使用者設定的語言傳回「其他語言的顯示名稱」中設置的值。
此API是異步API。
如果要同步處理，請參閱以下頁面。
函數
連結已複製
電腦版/行動裝置版
kintone.user.getOrganizations(code)
參數
連結已複製
| 參數名稱 | 類型 | 必須 | 說明 |
|---|---|---|---|
| code | 字串 | 可省略 | 要獲取的使用者的登入名稱 如果省略，獲取目前登入中的使用者的資訊。 |
返回值
連結已複製
返回值是Promise物件。
解析Promise物件時，可以取得包含以下元素的物件陣列：
| 屬性名稱 | 類型 | 值和說明 |
|---|---|---|
| organization | 物件 | 組織資訊 |
| organization.id | 字串 | 組織ID |
| organization.code | 字串 | 組織代碼 |
| organization.name | 字串 | 組織名稱 |
| organization.primary | 布爾值 | 是否為優先組織
|
| title | 物件 | 職務資訊 如果未設置，將返回null。 |
| title.id | 字串 | 役職ID |
| title.code | 字串 | 職務代碼 |
| title.name | 字串 | 職務名稱 |
可使用的畫面
連結已複製
電腦版/行動裝置版
可使用的畫面同整體自訂的套用畫面。
kintone整體自訂的套用畫面
但以下畫面不可用。
- 搜尋畫面
- 應用程式商城
- 插件設置畫面
注意事項
連結已複製
此API會在執行階段從伺服器獲取資料。獲取到的資料會被緩存，直到發生畫面轉換。
如果每個使用者每分鐘從伺服器獲取資料超過50次，則會拒絕傳回的Promise物件。
- 如果想要取得使用者所屬組織的其他資訊，可以使用下列API：
獲取組織