成員

1. 適用場(chǎng)景

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

2. 基礎(chǔ)功能

2.1 多選模式

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

多選模式

2.2 默認(rèn)展示人員

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

設(shè)置默認(rèn)值

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

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

2.3 顯示工號(hào)

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

顯示工號(hào)

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

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

高級(jí)選人功能入口，默認(rèn)在電腦端開啟，點(diǎn)擊后會(huì)以彈框的方式，提供一個(gè)完整的成員選擇頁(yè)面

2.4.1 使用場(chǎng)景

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

2.4.2 效果示意

3. 公式組合

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

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

參考 GETUSERNAME 函數(shù)公式

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

參考 USER 函數(shù)公式

4. 注意事項(xiàng)

1. 成員組件可以選擇全公司的人員，但是展示時(shí)只能展示本部門的人員，需要通過搜索選擇其他部門的人員。
2. 目前由于容器限制，在釘釘移動(dòng)端 iframe 中使用該組件時(shí)，會(huì)因?yàn)槿萜魑聪?iframe 注入 JSAPI 導(dǎo)致無(wú)法正常選擇人員，請(qǐng)避免在這種場(chǎng)景中使用該組件。

5. 常見問題

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

因?yàn)楦袷讲粚?duì)，批量導(dǎo)入的時(shí)候需要注意格式，具體參考批量導(dǎo)入。

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

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

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

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