> ## 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.

# USER

> USER函数用于获取当前登录人或其主管的信息，支持通过level参数指定返回的具体级别。

**USER**函数用于获取当前登录人或登录人主管的信息。

## 格式

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
USER(level)
```

## 属性说明

| **属性** | **是否必填** | **说明**                                                                                                                                           |
| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| level  | 否        | 数字类型。用于决定当前公式获取的信息是当前登录用户，还是登录人的主管。<br />• 如果不传此参数或传入参数为`0`，则返回当前登录用户的名称和userId，<br />• 如果传入此参数切参数不为`0`，则返回当前登录人的主管信息。传入`1`则返回一级主管，传入`2`则返回二级主管。 |

## 返回值

| **返回值类型** | **说明**                                    |
| --------- | ----------------------------------------- |
| 数组        | 返回的人员信息。<br />获取登录人主管信息时，如果不存在该级别主管，则返回空。 |

## 使用示例

如下图所示，使用`USER()`函数获取当前登录人和她的主管的信息。

<Frame>
  ![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/gif/1704436531525-b7ba310d-165d-492e-bad9-ec119fc39631.gif)
</Frame>
