文档中心 > API文档

4.34.3. 部门管理

接口列表:

  • public ServiceResponse create(String token, DepartmentInfoParam_All department);

  • public ServiceResponse update(String token, long departmentId, DepartmentInfoParam_All department);

  • public ServiceResponse updateByName(String token, DepartmentInfoParam_All department);

  • public boolean updateDepartmentByCode(String token, String departmentCode, DepartmentInfoParam_All department);

  • public ServiceResponse delete(String token, long departmentId);

  • public ServiceResponse deleteByName(String token, String accountName, String departmentName);

  • public ServiceResponse deleteByNames(String token, String accountName, String departmentName, String parentDepartmentName);

  • public ServiceResponse deleteByNameArray(String token, String accountName, String[] departmentName);

  • public boolean deleteDepartmentByCode(String token, String departmentCode) throws ServiceException;

  • public ServiceResponse enable(String token, long departmentId, boolean enable);

  • public ServiceResponse enableByName(String token, String accountName, String departmentName, boolean enable);

  • public ServiceResponse enableByNames(String token, String accountName, String departmentName, String parentDepartmentName, boolean enable);

  • public ServiceResponse enableByNameArray(String token, String accountName, String[] departmentName, boolean enable);

  • public DepartmentInfoParam_All getDepartmentByCode(String token, String departmentCode) throws ServiceException;

  • public ServiceResponse move(String token, long departmentId, long targetDepartmentId);

  • public ServiceResponse moveByNameArray(String token, String accountName, String[] departmentName, String[] targetDepartmentName);

接口说明:

  • create:按照部门实体中的部门信息创建部门。按部门路径名称创建部门,如果未能找到符合条件的部门路径,则创建部门路径,并添加新部门;参数token为登录验证后获取的身份令牌,参数department为部门信息;成功返回部门ID,否则返回-1

  • update:按照部门实体中的部门信息修改指定ID的部门信息。 如果存在相同名称的兄弟部门则创建部门失败;参数token为登录验证后获取的身份令牌,参数departmentId为部门ID,参数department为部门信息;成功返回部门ID,否则返回-1,

  • updateByName:更新部门(按部门名称)。 按照部门实体中的部门信息修改指定部门路径的部门信息。如果存在相同名称的兄弟部门则修改部门失败;参数token为登录验证后获取的身份令牌,参数department为部门信息(部门路径名称必填);成功返回部门ID,否则返回-1

  • updateDepartmentByCode:按照部门编码修改部门信息。如果按照代码找出多条部门记录,则不能修改,部门编码要唯一 ;参数token为登录验证后获取的身份令牌,参数departmentCode为部门编码,参数department为部门信息;成功返回true,失败返回false

  • delete:按照部门ID删除部门信息。 如果部门下存在人员则删除部门失败, 如果部门存在关联组则删除部门失败 ;参数token为登录验证后获取的身份令牌,参数departmentId为部门ID;成功返回部门ID,否则返回-1

  • deleteByName:按照部门名称删除本单位下的所有具有相同名称的部门信息。 如果部门中存在部门其下存在人员则删除部门失败,如果部门中存在部门其下存在关联组则删除部门失败 ;参数token为登录验证后获取的身份令牌,参数accountName为单位名称,参数departmentName为部门名称;成功返回部门ID,否则返回-1

  • deleteByNames:按照部门名称删除本单位下的所有具有相同名称和父部门名称的部门信息。 如果部门中存在部门其下存在人员则删除部门失败,如果部门中存在部门其下存在关联组则删除部门失败 ;参数token为登录验证后获取的身份令牌,参数accountName为单位名称,参数departmentName为部门名称,参数parentDepartmentName为父部门名称;成功返回部门ID,否则返回-1

  • deleteByNameArray:删除部门(按部门名称全路径)按照部门路径名称删除本单位的部门信息。 如果部门下存在人员则删除部门失败,如果部门下存在关联组则删除部门失败;参数token为登录验证后获取的身份令牌,参数accountName为单位名称,参数departmentName为部门名称数组,从根到要删除部门名称的数组(部门路径名称);成功返回部门ID,否则返回-1

  • deleteDepartmentByCode:按照部门编码删除部门。 删除部门时,如果部门下有成员,不允许删除,如果按照代码找出多条部门记录,则不能删除,部门编码要唯一;参数token为登录验证后获取的身份令牌,参数departmentCode为部门编码;成功返回true,失败返回false

  • enable:启用/禁用部门(按ID)。 按照部门ID设置部门的启用状态,如果部门下存在人员则停用部门失败;参数token为登录验证后获取的身份令牌,参数departmentId为部门ID,参数enable为部门启用状态(true为启用,false为停用);成功返回部门ID,否则返回-1

  • enableByName:启用/禁用部门(按部门名称)。 按照部门名称设置单位下部门的启用状态,如果部门下存在人员则停用部门失败;参数token为登录验证后获取的身份令牌,参数accountName为单位名称,参数departmentName为部门名称,参数enable为部门启用状态(true为启用,false为停用);成功返回部门ID,否则返回-1

  • enableByNames:启用/禁用部门(按部门名称及父部门名称)。 按照部门名称和父部门名称设置单位下部门的启用状态,如果部门下存在人员则停用部门失败;参数token为登录验证后获取的身份令牌,参数accountName为单位名称,参数departmentName为部门名称,参数parentDepartmentName为父部门名称,参数enable为部门启用状态(true为启用,false为停用);成功返回部门ID,否则返回-1

  • enableByNameArray:启用/禁用部门(按部门路径名称) 按照部门路径名称设置单位下部门的启用状态,如果部门下存在人员则停用部门失败;参数token为登录验证后获取的身份令牌,参数accountName为单位名称,参数departmentName为部门名称数组,参数enable为部门启用状态(true为启用,false为停用);成功返回部门ID,否则返回-1

  • getDepartmentByCode:按照部门编码获取部门的信息。 按照部门编码找到唯一的部门,如果找到多条部门记录,则返回空,获取失败;参数token为登录验证后获取的身份令牌,参数departmentCode为部门编码;返回满足条件的唯一部门

  • move:移动部门(按部门id)。 按照部门ID及目标父部门ID移动部门信息。 如果目标父部门未能找到,则移动失败;如果目标父部门下存在相同名称的子部门,则移动失败;参数token为登录验证后获取的身份令牌,参数departmentId为部门ID,参数targetDepartmentId为目标父部门id;成功返回部门ID,否则返回-1

  • moveByNameArray:移动部门(按部门名称)。 按照部门路径名称及目标父部门路径名称在本单位下移动部门信息。 如果目标父部门未能找到,则移动失败;如果目标父部门下存在相同名称的子部门,则移动失败;参数token为登录验证后获取的身份令牌,参数accountName为单位名称,参数departmentName为标识部门路径的名称数组,参数targetDepartmentName为标识目标部门路径的名称数组;成功返回部门ID,否则返回-1

    部门实体(DepartmentInfoParam_All)