部門

1. 部門組件

1.1 什么是部門組件

一款可以選擇人員所在部門的組件

添加部門組件

1.2 使用場景

獲取人員所在部門，該組件默認(rèn)顯示當(dāng)前登錄人的部門。

1.3 高級查詢功能

• 釘釘電腦端和網(wǎng)頁瀏覽器端使用宜搭部門組件時(shí)，新增高級查詢功能，支持基于通訊錄樹狀關(guān)系的選擇及組織下鉆能力
• 高級選人功能入口，默認(rèn)在電腦端開啟，點(diǎn)擊后會以彈框的方式，提供一個(gè)完整的部門選擇頁面

1.3.1 使用場景

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

1.3.2 效果示意

2. 屬性

2.1 多選

組件默認(rèn)是未開啟多選模式，若開啟就可以選擇多個(gè)部門，效果如圖：

多選模式

2.2 全選

開啟全選模式之后提交頁面會增加一個(gè)全選的開關(guān)，可全選當(dāng)前下拉列表中的所有部門，效果如圖：

開啟全選功能

2.3 清除按鈕

允許通過 x 一鍵清空輸入的內(nèi)容，效果如圖：

允許一鍵清除按鈕

2.4 搜索數(shù)據(jù)源

如果您的企業(yè)有自己的組織架構(gòu)數(shù)據(jù)源，可以替換這里的請求地址為你的數(shù)據(jù)源接口地址；效果如圖：

您還可以根據(jù)您的接口需求，編寫請求處理函數(shù)

函數(shù)入?yún)⒌?data 為用戶搜索輸入值，返回值會作為請求接口的查詢參數(shù)，效果如圖：

請求處理函數(shù)

如果您的接口和宜搭查詢部門接口返回的數(shù)據(jù)結(jié)構(gòu)不一致，則需要修改一下數(shù)據(jù)處理函數(shù)；

保證函數(shù)返回值格式為如下對象數(shù)組，效果如圖：

[{
	value: 'department1',
  text: '部門一'
},{
	value: 'department2',
  text: '部門二'
}]

數(shù)據(jù)處理函數(shù)

3. 高級

3.1 動作設(shè)置

對于這個(gè)組件需要設(shè)置動作配置 JS 代碼時(shí)，效果如圖：

動作設(shè)置-值發(fā)生變化

4. 常見問題

4.1 如何獲取當(dāng)前登錄人的部門

該功能需要使用公式，當(dāng)前部門組件暫不支持公式編輯，效果如圖：

目前推薦使用單行文本組件，默認(rèn)值切換至公式編輯，公式如下：DEPTNAME(LOGINUSERWORKNO())

4.2 部門組件內(nèi)無法搜索到組織內(nèi)的其他部門

部門組件默認(rèn)情況下，只顯示當(dāng)前登錄人所在部門信息；

如要填寫其他部門信息，需要輸入部門名稱搜索，效果如圖：

4.3 如何通過部門組件獲取當(dāng)前部門的主管 ？

目前是不支持直接獲取的，但是可以通過在宜搭內(nèi)配置部門&主管關(guān)聯(lián)表，取完部門以后在流程表單內(nèi)自動關(guān)聯(lián)出對應(yīng)部門的主管信息，審批節(jié)點(diǎn)再綁定該主管信息變量。