取得使用者自訂項目
取得使用者的自訂項目。
可用於根據使用者資訊進行分支處理,以及建立顯示使用者資訊的UI。
取得目前登入中的使用者的自訂項目時,也可以取得非公開的項目。
此API是非同步API。
如果要同步處理,請參閱以下頁面。
函式
電腦版/行動裝置版
kintone.user.getCustomFields(code)參數
| 參數名稱 | 類型 | 必須 | 說明 |
|---|---|---|---|
| code | 字串 | 可省略 | 要取得的使用者的登入名稱 如果省略,取得目前登入中的使用者的資訊。 |
返回值
返回值是Promise物件。
解析Promise物件時,可以取得包含以下元素的物件陣列:
| 屬性名稱 | 類型 | 值和說明 |
|---|---|---|
| code | 字串 | 項目代碼 |
| name | 字串 | 項目名稱 |
| type | 字串 | 欄位類型
|
| value | 字串/物件 | 儲存值 根據 type不同,資料類型也不同。
|
| value.code | 字串 | 已儲存的使用者編號 僅當 type為USER_SELECT時才存在。 |
| value.name | 字串 | 已儲存的使用者名稱 僅當 type為USER_SELECT時才存在。 |
| visibility | 字串 | 公開/非公開的設定
|
可使用的畫面
電腦版/行動裝置版
可使用的畫面同整體自訂的套用畫面。
kintone整體自訂的套用畫面
但以下畫面不可用。
- 搜尋畫面
- 應用程式商城
- 外掛程式設定畫面
注意事項
此API會在執行階段從伺服器取得資料。取得到的資料會被緩存,直到發生畫面轉換。
如果每個使用者每分鐘從伺服器取得資料超過50次,則會拒絕傳回的Promise物件。
