mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-05 20:38:43 +00:00
64 lines
2.3 KiB
Markdown
64 lines
2.3 KiB
Markdown
---
|
||
id: org-department.sync.howto
|
||
title: 同步部门成员
|
||
type: howto
|
||
feature: org-department
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 同步部门
|
||
- 同步部门成员
|
||
- 部门成员同步
|
||
- 把子部门成员同步到上级
|
||
- 父部门看到子部门成员
|
||
- 部门成员归集
|
||
related_tools: []
|
||
related_pages: []
|
||
prerequisites:
|
||
- 需要系统管理员权限（userIsAdmin）
|
||
- 目标部门下有子部门
|
||
negative:
|
||
- 同步是"子部门成员合并到当前部门"，**不是**反向（不会把当前部门成员推到子部门）
|
||
- 同步是单向、追加：只新增 `users.department` 里没有该部门 ID 的用户，已在的不重复加
|
||
- 已 disable_at 的用户被跳过，不会同步进部门或部门群
|
||
- 没有子部门时返回成功但不做事，提示「同步完成，子部门中没有成员需要同步」
|
||
- 同步与 LDAP 拉取无关：DooTask 内部不直接通过此接口对接 LDAP
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 同步部门成员
|
||
|
||
## 是什么
|
||
"同步部门成员"是把所有**子部门**（递归）的成员合并到**当前部门**的一键操作。常用于：父部门负责人希望看到/管理下属部门的全部成员，但不想手动逐个调整 `users.department`。
|
||
|
||
## 入口
|
||
- 桌面端：管理后台 → 团队管理 → 某部门行尾「⋯」→ 「同步部门成员」
|
||
- 接口：`GET api/users/department/sync`，参数 `id`（要同步的目标部门 id）
|
||
|
||
## 操作步骤
|
||
1. 选中目标父部门
|
||
2. 点击「⋯」→「同步部门成员」
|
||
3. 提交，弹出结果提示：
|
||
- `同步完成，共同步 N 个成员`
|
||
- 若部分人员已在当前部门：`其中 M 个成员已在当前部门`
|
||
|
||
## 返回字段
|
||
| 字段 | 含义 |
|
||
|---|---|
|
||
| `synced_count` | 本次新加入该部门的人数 |
|
||
| `already_in_dept_count` | 已在该部门、跳过的人数 |
|
||
| `sub_department_ids` | 所有递归子部门 ID 列表 |
|
||
|
||
## 副作用
|
||
- 子部门成员的 `users.department` 追加目标部门 ID
|
||
- 部门群（dialog_id）会自动 joinGroup 把"在部门但不在群"的人补齐
|
||
- 全程事务：失败回滚
|
||
|
||
## 不支持
|
||
- 不支持"反向同步"（把父部门成员推下去）
|
||
- 不支持"仅预览不写入"
|
||
|
||
## 相关
|
||
- 部门概念：[[org-department.concept]]
|
||
- 删除部门会自动移出成员：[[org-department.delete.howto]]
|