程序包 com.elitesland.ystdms.sys.feign

接口 SysEmployeeFeignClient

@FeignClient(name="${yst.service.system:yst-dms2-newsys}", path="/api/v1/mng/employee", primary=false) public interface SysEmployeeFeignClient

  • 方法详细资料

    • getByUserName

      @GetMapping("/getByUserName") ApiResult<SysEmployeeDTO> getByUserName(@NotBlank(message="\u8d26\u53f7\u4e3a\u7a7a") @RequestParam("userName") @NotBlank(message="\u8d26\u53f7\u4e3a\u7a7a") String userName)
      根据账号查询员工信息
      参数:
      userName - 账号
      返回:
      账号

    • getByMobile

      @GetMapping("/getByMobile") ApiResult<SysEmployeeDTO> getByMobile(@NotBlank(message="\u624b\u673a\u53f7\u4e3a\u7a7a") @RequestParam("mobile") @NotBlank(message="\u624b\u673a\u53f7\u4e3a\u7a7a") String mobile)
      根据手机号查询员工信息
      参数:
      mobile - 手机号
      返回:
      员工信息，未命中时 data 为 null

    • listByUserNames

      @PostMapping("/listByUserNames") ApiResult<List<SysEmployeeDTO>> listByUserNames(@RequestBody @NotEmpty(message="\u8d26\u53f7\u4e3a\u7a7a") @NotEmpty(message="\u8d26\u53f7\u4e3a\u7a7a") Set<String> userNames)
      根据账号查询员工信息
      参数:
      userNames - 账号
      返回:
      账号

    • listByIds

      @PostMapping("/listByIds") ApiResult<List<SysEmployeeDTO>> listByIds(@RequestBody @NotEmpty(message="ID\u4e3a\u7a7a") @NotEmpty(message="ID\u4e3a\u7a7a") Set<UUID> ids)
      根据id批量查询
      参数:
      ids - 账号
      返回:
      账号

    • listByUserIds

      @PostMapping("/listByUserIds") ApiResult<List<SysEmployeeDTO>> listByUserIds(@RequestBody @NotEmpty(message="\u7528\u6237ID\u4e3a\u7a7a") @NotEmpty(message="\u7528\u6237ID\u4e3a\u7a7a") Set<UUID> userIds)
      根据用户ID批量查询员工信息（同时填充组织信息） 用于Feign调用时，通过SysUser.id查询对应的SysEmployee及其组织信息
      参数:
      userIds - 用户ID集合（SysUser.id）
      返回:
      员工信息列表

    • listByMobiles

      @PostMapping("/listByMobiles") ApiResult<List<SysEmployeeDTO>> listByMobiles(@RequestBody @NotEmpty(message="\u624b\u673a\u53f7\u4e3a\u7a7a") @NotEmpty(message="\u624b\u673a\u53f7\u4e3a\u7a7a") Set<String> mobiles)
      根据手机号批量查询
      参数:
      mobiles - 手机号
      返回:
      手机号

    • listByNames

      @PostMapping("/listByNames") ApiResult<List<SysEmployeeDTO>> listByNames(@RequestBody @NotEmpty(message="\u59d3\u540d\u4e3a\u7a7a") @NotEmpty(message="\u59d3\u540d\u4e3a\u7a7a") Set<String> names)
      根据姓名查询员工信息
      参数:
      names - 姓名
      返回:
      姓名

    • getEmployeeOrgs

      @GetMapping("/{id}/orgs") ApiResult<List<SysOrgRespRpcDTO>> getEmployeeOrgs(@PathVariable("id") UUID id)
      根据员工ID查询所有组织信息（Feign接口） 用于其他微服务通过Feign获取员工的所有关联组织
      参数:
      id - 员工ID
      返回:
      组织信息列表

    • queryDirectDeptByKeyword

      @GetMapping("/direct-dept") ApiResult<EmployeeDirectDeptRpcResp> queryDirectDeptByKeyword(@NotBlank(message="\u67e5\u8be2\u6761\u4ef6\u4e0d\u80fd\u4e3a\u7a7a") @RequestParam("keyword") @NotBlank(message="\u67e5\u8be2\u6761\u4ef6\u4e0d\u80fd\u4e3a\u7a7a") String keyword)
      关键字与 sys_employee.last_name 或 sys_employee.mobile 精确匹配。 仅唯一命中一名员工时返回默认组织（直属部门）。

    • saveEmployee

      @PostMapping("/saveEmployee") ApiResult<List<Integer>> saveEmployee(@RequestBody List<SysEmployeeDTO> employeeDTOList)
      保存员工信息
      参数:
      employeeDTOList - 员工列表
      返回:
      姓名

    • upsert

      @PostMapping("/save/rpc") ApiResult<String> upsert(@RequestBody @Valid @Valid SysEmployeeUpsertDTO upsertDTO)

    • upsert2

      @PostMapping("/save2/rpc") ApiResult<SysEmployeeDTO> upsert2(@RequestBody @Valid @Valid SysEmployeeUpsertDTO upsertDTO)

    • switchEnabled

      @PatchMapping("/switch/enabled/{id}/rpc") ApiResult<UUID> switchEnabled(@PathVariable("id") UUID id)

    • delete

      @DeleteMapping("/del/{id}") ApiResult<UUID> delete(@PathVariable("id") UUID id, @RequestParam(name="keepUser",defaultValue="false") Boolean keepUser)