部门管理
Maven坐标
xml
<dependency>
<groupId>com.ikingtech.platform</groupId>
<artifactId>sdk-department-api</artifactId>
</dependency>核心功能方法
| 方法名 | 方法释意 |
|---|---|
| add(DeptDTO dept) | 创建新的部门 |
| delete(String id) | 删除指定的部门，若部门为默认部门(root)，则不能删除。 |
| page(DeptQueryParamDTO queryParam) | 根据条件分页查询部门信息 |
| detail(String id) | 获取指定部门的详细信息 |
| listInfoByIds(BatchParam< String> ids) | 根据多个部门ID获取部门信息列表 |
| listManagerByIds(BatchParam< String> ids) | 获取指定部门的主管信息列表 |
| listByName(String name, Boolean dataScope) | 根据部门名称获取部门信息列表 |
| listSubAllByParentId(String parentId, Boolean includeSelf) | 获取某个部门下的所有子部门 |
| mapInfoByIds(BatchParam< String> ids) | 根据多个部门ID获取部门信息映射表 |
| drag(DragOrderParam dragParam) | 对部门进行拖动排序 |
| all(DeptQueryParamDTO queryParam) | 根据条件查询所有部门信息 |
Service层（DeptService）
| 方法名 | 方法释意 |
|---|---|
| parseFullPath(String parentId, String id) | 解析部门全路径 |
| exist(String id) | 检查某个部门是否存在 |
| nameExist(String name), nameExist(String id, String name) | 验证部门名称是否已存在 |
| getMaxSortOrder(String parentId) | 获取指定部门的最大排序值 |
| between(Object parentId, T startValue, T endValue), gt(Object parentId, Object value) | 进行部门排序相关操作 |
| listFullPathByFullPaths(List< String> fullPaths), listFullPathByIds(List< String> ids), listFullPathAll() | 根据ID或全路径查询部门全路径列表。 getFullPathById(String id): 获取指定部门的全路径 |
| listByFullPath(String fullPath, Boolean includeSelf) | _ 查询指定全路径下的所有子部门_ |
| all(List< String> ids, String selfFullPath) | 查询所有部门，可排除指定部门及其所有子部门 |
| listByName(String name) | 根据部门名称查询部门列表 |
| listByParentId(String parentId, List< String> departmentIds) | 根据父部门ID查询子部门列表 |
| listManagerIdByIds(List< String> ids) | 获取指定部门的管理者ID列表 |
注意事项
异常处理（DeptExceptionInfo）定义了部门模块的一些异常信息，如"部门不存在"、"父部门不存在"、"已存在相同名称的部门"等
部门编号生成策略有两种：自动生成和手动设置。若选择手动设置，则必须指定部门编号。
创建或更新部门时，如果不指定父部门编号，系统将默认设置为根部门编号(root)。
对于部门名称不能重复，同名部门会创建失败。