# 资源定义
部门是飞书组织架构里的一个基础实体，每个员工都归属于一个或多个部门。
部门在飞书的身份标识包括`department_id`、`open_department_id`。有关department各类ID的详细介绍，参考 
[部门ID说明](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/contact-v3/department/field-overview#23857fe0)。

# 字段说明

名称 | 类型 | 描述
---|---|---
department_id | string | 部门ID<br>**字段权限要求（满足任一）**：<br>查看部门基础信息(directory:department.base:read)<br>查看部门自定义 ID(directory:department.external_id:read)
department_count | department_count | 部门成员计数与子部门计数。计算结果可能会有延迟<br>**字段权限要求（满足任一）**：<br>查看部门成员与子部门计数(directory:department.count:read)<br>查看部门组织架构信息(directory:department.organization:read)
recursive_members_count | string | 部门成员数量，包含部门内所有层级子部门的成员数量
direct_members_count | string | 部门成员数量，仅包含直属成员数，不包含子部门成员数
recursive_members_count_exclude_leaders | string | 部门成员数量，包含部门内所有层级子部门的成员数量
recursive_departments_count | string | 部门成员数量，包含部门内所有层级子部门的成员数量
direct_departments_count | string | 部门成员数量，仅包含直属成员数，不包含子部门成员数
has_child | boolean | 是否有子部门<br>**字段权限要求（满足任一）**：<br>查看部门是否有子部门(directory:department.has_child:read)<br>查看部门组织架构信息(directory:department.organization:read)
leaders | department_leader\[\] | 部门负责人<br>**字段权限要求**：<br>查看部门负责人信息(directory:department.leader:read)
leader_type | int | 部门负责人类型<br>**可选值有**：<br>- 1：主<br>- 2：副
leader_id | string | 部门负责人ID
parent_department_id | string | 父部门ID<br>**字段权限要求（满足任一）**：<br>查看部门组织架构信息(directory:department.organization:read)<br>查看部门的父部门 ID(directory:department.parent_id:read)
name | i18n_text | 部门名称<br>**字段权限要求（满足任一）**：<br>查看部门基础信息(directory:department.base:read)<br>查看部门的名称(directory:department.name:read)
default_value | string | 默认值
i18n_value | map&lt;string, string&gt; | 国际化值，key为zh_cn, ja_jp, en_us, value为对应的值
enabled_status | boolean | **字段权限要求**：<br>查看部门的停启用状态(directory:department.status:read)
order_weight | string | 部门排序权重<br>**字段权限要求（满足任一）**：<br>查看部门排序权重(directory:department.order_weight:read)<br>查看部门组织架构信息(directory:department.organization:read)
custom_field_values | custom_field_value\[\] | 部门自定义字段值<br>**字段权限要求**：<br>查看部门自定义字段信息(directory:department.custom_field:read)
field_key | string | 自定义字段key
field_type | string | 自定义字段类型<br>**可选值有**：<br>- 1：多行文本<br>- 2：网页链接<br>- 3：枚举选项<br>- 4：人员
text_value | i18n_text | 文本字段值
default_value | string | 默认值
i18n_value | map&lt;string, string&gt; | 国际化值，key为zh_cn, ja_jp, en_us, value为对应的值
url_value | url_value | 网页链接字段值
link_text | i18n_text | 网页标题
default_value | string | 默认值
i18n_value | map&lt;string, string&gt; | 国际化值，key为zh_cn, ja_jp, en_us, value为对应的值
url | string | 移动端网页链接
pcurl | string | 桌面端网页链接
enum_value | enum_value | 枚举字段值
enum_ids | string\[\] | 选项结果ID
enum_type | string | 选项类型<br>**可选值有**：<br>- 1：文本<br>- 2：图片
user_values | user_value\[\] | 人员字段值
ids | string\[\] | 人员ID
department_path_infos | department_base_info\[\] | 部门路径信息。排列顺序为根级到末级，不包含根部门<br>**字段权限要求**：<br>查看部门路径信息(directory:department.department_path:read)
department_id | string | 部门ID
department_name | i18n_text | i18n文本
default_value | string | 默认值
i18n_value | map&lt;string, string&gt; | 国际化值，key为zh_cn, ja_jp, en_us, value为对应的值
data_source | int | 数据来源<br>**可选值有**：<br>- 1：管理后台<br>- 2：人事企业版<br>- 3：SCIM<br>**字段权限要求（满足任一）**：<br>查看部门基础信息(directory:department.base:read)<br>查看部门数据来源(directory:department.data_source:read)

## 数据示例

```json 
 {
    "department_id": "D100",
    "open_department_id": "od-4e6ac4d14bcd5071a37a39de902c7141",
    "name": {
        "value": "销售部",
        "i18n_value":{
            "language": "en_us"
                "value": "Sale"
            }
        },
    "parent_department_id": "D90",
    "leaders": [
        {
            "leader_ID": "u273y69",
            "DepartmentLeaderType": 1
        }
    ],
    "has_child":true,
    "department_count": {
        "recursive_members_count": 100,
        "direct_members_count": 90,
        "recursive_members_count_exclue_leaders":80,
        "recursive_departments_count": 20,
        "direct_departments_count": 10
    },
    "enabled_status": true,
    "order_weight": 1,
    "department_path_info": [
        {
            "department_id": "D102",
            "department_name":{
                "value": "北京科技有限公司",
                "i18n_value":{
                    "language": "en_us"
                        "value": "Beijing Technology Co., Ltd"
                }
            }
        },
        {
            "department_id": "D101",
            "department_name":{
                "value": "华北大区",
                "i18n_value":{
                    "language": "en_us"
                        "value": "North China Region"
                }
            }
        },
        {
            "department_id": "D100",
            "department_name":{
                "value": "销售部",
                "i18n_value":{
                    "language": "en_us"
                        "value": "Sale"
                }
            }
        }
    ],
    "custom_field_values": [
        {
            "field_id": "DemoId",
            "field_value": {
                "field_type": 1,
                "text_value": "DemoText"
            }
        },
        {
            "field_id": "DemoId_2",
            "field_value": {
                "field_type": 4,
                "user_value": [
                    "9b2fabg5"
                ]
            }
        }
    ],
    "data_source":1   
}

```