成員

1. 適用場景

成員組件可以獲取釘釘通訊錄的人員，選擇人員時可以使用，比如設(shè)置出差申請人、資產(chǎn)責(zé)任人、維護人員等，還可以和 公式 組合使用，另還可用于流程表單設(shè)置審批人時使用，比如 發(fā)起人自選審批人。

2. 基礎(chǔ)功能

2.1 多選模式

支持選擇多位人員，當(dāng)人員僅需要選擇一位時，可以關(guān)閉該按鈕。

多選模式

2.2 默認展示人員

可以選擇指定人員作為默認值，在提交頁面可以默認展示對應(yīng)的成員。

設(shè)置默認值

當(dāng)成員狀態(tài)是普通的時候，默認展示成員可以清除，重新搜索選擇其他人員。

成員狀態(tài)設(shè)置為只讀的時候，組件就不支持選擇人員，僅可讀的狀態(tài)。

2.3 顯示工號

設(shè)置是否需要人員姓名后面帶有工號，這里的工號默認展示員工的UserID。

顯示工號

2.4 高級查詢模式 （新版本成員組件）

釘釘電腦端和網(wǎng)頁瀏覽器端使用宜搭成員組件時，新增高級查詢功能，支持基于通訊錄樹狀關(guān)系的選擇及組織下鉆能力

高級選人功能入口，默認在電腦端開啟，點擊后會以彈框的方式，提供一個完整的成員選擇頁面

2.4.1 使用場景

• 根據(jù)組織通訊錄的層級關(guān)系，按樹狀層級關(guān)系，向下查詢并選擇目標(biāo)成員

2.4.2 效果示意

3. 公式組合

有多種用法，比如自動獲取發(fā)起人姓名、工號、部門等，具體可以參考 高級函數(shù) 文檔。

3.1 獲取當(dāng)前登錄人昵稱

參考 GETUSERNAME 函數(shù)公式

3.2 獲取當(dāng)前登錄人或當(dāng)前登錄人的主管

參考 USER 函數(shù)公式

4. 注意事項

1. 成員組件可以選擇全公司的人員，但是展示時只能展示本部門的人員，需要通過搜索選擇其他部門的人員。
2. 目前由于容器限制，在釘釘移動端 iframe 中使用該組件時，會因為容器未向 iframe 注入 JSAPI 導(dǎo)致無法正常選擇人員，請避免在這種場景中使用該組件。

5. 常見問題

5.1 為什么成員組件批量導(dǎo)入的時候，輸入了人名但導(dǎo)進去顯示空白？

因為格式不對，批量導(dǎo)入的時候需要注意格式，具體參考批量導(dǎo)入。

5.2 想通過部門組件選擇了某個部門，那成員組件只能選擇這個部門里面的人員，可以怎么做 ？

成員組件目前沒有可以直接控制可選范圍的配置項，可以使用這個方案：創(chuàng)建一個中間表，里面放入部門和所屬成員，通過數(shù)據(jù)聯(lián)動，獲取這個中間表。

5.3 批量導(dǎo)入成員組件不成功，導(dǎo)入之后沒有數(shù)據(jù) ？

使用了成員組件，批量導(dǎo)入不成功，需要注意格式，姓名 + [員工 UserID ]，括號需要是英文格式下的中括號 [] ，查看以下截圖：