> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 部门

> 本文档介绍了部门组件的功能、使用场景以及如何在不同场景下配置和使用该组件。包括多选模式、全选功能、清除按钮、展示部门全路径等特性，同时提供了针对高级查询功能的详细说明。

## 1. 部门组件

### 1.1 什么是部门组件

一款可以选择人员所在部门的组件

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357306496-4ed184c8-27eb-4a5b-ac7f-96fdb34d53d8.png)
</Frame>

添加部门组件

### 1.2 使用场景

获取人员所在部门，该组件默认显示当前登录人的部门。

### 1.3 高级查询功能

* 钉钉电脑端和网页浏览器端使用宜搭部门组件时，新增高级查询功能，支持基于通讯录树状关系的选择及组织下钻能力
* 高级选人功能入口，默认在电脑端开启，点击后会以弹框的方式，提供一个完整的部门选择页面

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357432946-57b42da5-19ab-41af-9ff6-1fbdfd412fed.png)
</Frame>

#### 1.3.1 使用场景

* 根据组织通讯录的层级关系，按树状层级关系，向下查询并选择目标部门

#### 1.3.2 效果示意

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1623124717783-494732ec-8612-4431-8d40-863f7a0d601f.png)
</Frame>

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1623124733758-d032e358-b872-48d3-9da4-8f12dd1892a1.png)
</Frame>

## 2. 属性

### 2.1 多选

组件默认是未开启多选模式，若开启就可以选择多个部门，效果如图：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357491129-491c4d45-946a-461e-b42f-c8829da49bac.png)
</Frame>

多选模式

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357532903-46c4d62e-94b3-4eb5-9080-a21388e7991e.png)
</Frame>

### 2.2 全选

开启全选模式之后提交页面会增加一个全选的开关，可全选当前下拉列表中的所有部门，效果如图：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357562300-4d0f54fe-9ef6-435f-afb1-6e50393266ce.png)
</Frame>

开启全选功能

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357598945-87e535fc-6a7b-4b53-a1a1-f1211032249d.png)
</Frame>

### 2.3 清除按钮

允许通过 `x` 一键清空输入的内容，效果如图：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357627790-d4338579-c0e7-4fa6-88c1-b3de0bf214c0.png)
</Frame>

允许一键清除按钮

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357657234-4620c07e-2956-42c7-a8db-ef85800365de.png)
</Frame>

### 2.4 是否展示部门全路径

开启是否展示部门全路径后，部门组件值会按部门上下级从左至右的顺序，展示完整的部门全路径，例如：产品部是产品1部的上级部门，选择产品1部后则会显示：产品部-产品1部。

**注：默认显示最高层部门**

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1649833713324-b8fb2abd-59d0-4e9f-9f0c-13bccabb1f88.png)
</Frame>

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1649833688313-d731e14c-7fc7-4c9f-a937-cb727ffe582a.png)
</Frame>

是否展示部门全路径

### 2.5 搜索数据源

如果您的企业有自己的组织架构数据源，可以替换这里的请求地址为你的数据源接口地址；效果如图：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357702040-7645b015-273a-466f-a330-87c03e41f255.png)
</Frame>

您还可以根据您的接口需求，编写请求处理函数

函数入参的 data 为用户搜索输入值，返回值会作为请求接口的查询参数，效果如图：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357750394-5b418418-2b11-4f52-8fd2-5ce518c5dad9.png)
</Frame>

请求处理函数

如果您的接口和宜搭查询部门接口返回的数据结构不一致，则需要修改一下数据处理函数；

保证函数返回值格式为如下对象数组，效果如图：

```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
[{
    "text": {
      en_US: "文档",
      pureEn_US: "文档",
      type: "i18n",
      zh_CN: "文档"
    },
    "value": "622760468"
  }]
```

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357824728-17ad16e8-e35c-42b6-9549-fb27c5b457ed.png)
</Frame>

数据处理函数

## 3. 高级

### 3.1 动作设置

对于这个组件需要设置动作配置 JS 代码时，效果如图：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639357858594-0b330e1f-ea93-4833-adfe-a0681a077da9.png)
</Frame>

动作设置-值发生变化

## 4. 常见问题

### 4.1 如何获取当前登录人的部门

该功能需要使用公式，目前推荐使用单行文本、成员组件，默认值切换至公式编辑，成员组件设置公式：USER() ，单行文本设置公式：DEPTNAME(成员组件)

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1647588467661-4aaa0c64-6b44-4a89-8d87-2300e9193864.png)
</Frame>

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1647588511844-2b37d2e6-9eed-42fc-a3ba-1e0d5acfed00.png)
</Frame>

### 4.2 部门组件内无法搜索到组织内的其他部门

部门组件默认情况下，只显示当前登录人所在部门信息；

如要填写其他部门信息，需要输入部门名称搜索，效果如图：

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1639358156861-af031103-2749-41ca-82b2-4414a2c77a62.png)
</Frame>

### 4.3 如何通过部门组件获取当前部门的主管 ？

目前是不支持直接获取的，但是可以通过在宜搭内配置部门&主管关联表，取完部门以后在流程表单内自动关联出对应部门的主管信息，审批节点再绑定该主管信息变量。
