程序包 net.risesoft.api.platform.org

接口 PositionApi

  • @Validated
public interface PositionApi
    岗位服务组件
    从以下版本开始:
    9.6.0
    作者:
    dingzhaojun, qinman, mengjuhua
    Date:
    2022/2/10

    • 方法概要

      所有方法 实例方法 抽象方法 
      修饰符和类型 方法 说明
      net.risesoft.pojo.Y9Result<Object> addPerson​(@NotBlank String tenantId, @NotBlank String positionId, @NotBlank String personId)
      向岗位增加人员
      net.risesoft.pojo.Y9Result<net.risesoft.model.platform.Position> create​(@NotBlank String tenantId, CreatePositionDTO position)
      创建岗位
      net.risesoft.pojo.Y9Result<Object> delete​(@NotBlank String tenantId, @NotBlank String positionId)
      删除岗位
      net.risesoft.pojo.Y9Result<net.risesoft.model.platform.Position> get​(@NotBlank String tenantId, @NotBlank String positionId)
      根据id获得岗位对象
      net.risesoft.pojo.Y9Result<Boolean> hasPosition​(@NotBlank String tenantId, @NotBlank String positionName, @NotBlank String personId)
      根据人员id和岗位id判断该人员是否拥有此岗位
      net.risesoft.pojo.Y9Result<List<net.risesoft.model.platform.Position>> listByParentId​(@NotBlank String tenantId, @NotBlank String parentId)
      根据父节点获取岗位列表（不包含禁用）
      net.risesoft.pojo.Y9Result<List<net.risesoft.model.platform.Position>> listByPersonId​(@NotBlank String tenantId, @NotBlank String personId)
      获取人员拥有的岗位列表（不包含禁用）
      net.risesoft.pojo.Y9Result<List<net.risesoft.model.platform.Person>> listPersonsByPositionId​(@NotBlank String tenantId, @NotBlank String positionId)
      获取岗位绑定的人员列表（不包含禁用）
      net.risesoft.pojo.Y9Result<Object> removePerson​(@NotBlank String tenantId, @NotBlank String positionId, @NotBlank String personId)
      从岗位移除人员
      net.risesoft.pojo.Y9Result<net.risesoft.model.platform.Position> updatePosition​(@NotBlank String tenantId, CreatePositionDTO createPositionDTO)
      更新岗位

    • 方法详细资料

      • addPerson

        @PostMapping("/addPerson")
net.risesoft.pojo.Y9Result<Object> addPerson​(@RequestParam("tenantId") @NotBlank
                                             @NotBlank String tenantId,
                                             @RequestParam("positionId") @NotBlank
                                             @NotBlank String positionId,
                                             @RequestParam("personId") @NotBlank
                                             @NotBlank String personId)
        向岗位增加人员
        参数:
        tenantId - 租户id
        positionId - 岗位id
        personId - 人员id
        返回:
        Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功
        从以下版本开始:
        9.6.0

      • create

        @PostMapping("/create")
net.risesoft.pojo.Y9Result<net.risesoft.model.platform.Position> create​(@RequestParam("tenantId") @NotBlank
                                                                        @NotBlank String tenantId,
                                                                        @RequestBody @Validated
                                                                        CreatePositionDTO position)
        创建岗位
        参数:
        tenantId - 租户id
        position - 岗位对象
        返回:
        Y9Result<Position> 通用请求返回对象 - data 是保存的岗位对象
        从以下版本开始:
        9.6.0

      • delete

        @PostMapping("/delete")
net.risesoft.pojo.Y9Result<Object> delete​(@RequestParam("tenantId") @NotBlank
                                          @NotBlank String tenantId,
                                          @RequestParam("positionId") @NotBlank
                                          @NotBlank String positionId)
        删除岗位
        参数:
        tenantId - 租户id
        positionId - 岗位id
        返回:
        Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功
        从以下版本开始:
        9.6.0

      • get

        @GetMapping("/get")
net.risesoft.pojo.Y9Result<net.risesoft.model.platform.Position> get​(@RequestParam("tenantId") @NotBlank
                                                                     @NotBlank String tenantId,
                                                                     @RequestParam("positionId") @NotBlank
                                                                     @NotBlank String positionId)
        根据id获得岗位对象
        参数:
        tenantId - 租户id
        positionId - 岗位唯一标识
        返回:
        Y9Result<Position> 通用请求返回对象 - data 是岗位对象
        从以下版本开始:
        9.6.0

      • hasPosition

        @GetMapping("/hasPosition")
net.risesoft.pojo.Y9Result<Boolean> hasPosition​(@RequestParam("tenantId") @NotBlank
                                                @NotBlank String tenantId,
                                                @RequestParam("positionName") @NotBlank
                                                @NotBlank String positionName,
                                                @RequestParam("personId") @NotBlank
                                                @NotBlank String personId)
        根据人员id和岗位id判断该人员是否拥有此岗位
        参数:
        tenantId - 租户id
        positionName - 岗位名称
        personId - 岗位唯一标识
        返回:
        Y9Result<Boolean> 通用请求返回对象 - data 可判断否拥有该岗位
        从以下版本开始:
        9.6.0

      • listByParentId

        @GetMapping("/listByParentId")
net.risesoft.pojo.Y9Result<List<net.risesoft.model.platform.Position>> listByParentId​(@RequestParam("tenantId") @NotBlank
                                                                                      @NotBlank String tenantId,
                                                                                      @RequestParam("parentId") @NotBlank
                                                                                      @NotBlank String parentId)
        根据父节点获取岗位列表（不包含禁用）
        参数:
        tenantId - 租户唯一标识
        parentId - 父节点ID
        返回:
        Y9Result<List<Position>> 通用请求返回对象 - data 是岗位对象集合
        从以下版本开始:
        9.6.0

      • listByPersonId

        @GetMapping("/listByPersonId")
net.risesoft.pojo.Y9Result<List<net.risesoft.model.platform.Position>> listByPersonId​(@RequestParam("tenantId") @NotBlank
                                                                                      @NotBlank String tenantId,
                                                                                      @RequestParam("personId") @NotBlank
                                                                                      @NotBlank String personId)
        获取人员拥有的岗位列表（不包含禁用）
        参数:
        tenantId - 租户唯一标识
        personId - 人员ID
        返回:
        Y9Result<List<Position>> 通用请求返回对象 - data 是岗位对象集合
        从以下版本开始:
        9.6.0

      • listPersonsByPositionId

        @GetMapping("/listPersonsByPositionId")
net.risesoft.pojo.Y9Result<List<net.risesoft.model.platform.Person>> listPersonsByPositionId​(@RequestParam("tenantId") @NotBlank
                                                                                             @NotBlank String tenantId,
                                                                                             @RequestParam("positionId") @NotBlank
                                                                                             @NotBlank String positionId)
        获取岗位绑定的人员列表（不包含禁用）
        参数:
        tenantId - 租户id
        positionId - 岗位唯一标识
        返回:
        Y9Result<List<Person>> 通用请求返回对象 - data 是人员对象集合
        从以下版本开始:
        9.6.0

      • removePerson

        @PostMapping("/removePerson")
net.risesoft.pojo.Y9Result<Object> removePerson​(@RequestParam("tenantId") @NotBlank
                                                @NotBlank String tenantId,
                                                @RequestParam("positionId") @NotBlank
                                                @NotBlank String positionId,
                                                @RequestParam("personId") @NotBlank
                                                @NotBlank String personId)
        从岗位移除人员
        参数:
        tenantId - 租户id
        positionId - 岗位id
        personId - 人员id
        返回:
        Y9Result<Object> 通用请求返回对象 - success 属性判断操作是否成功
        从以下版本开始:
        9.6.0

      • updatePosition

        @PostMapping("/updatePosition")
net.risesoft.pojo.Y9Result<net.risesoft.model.platform.Position> updatePosition​(@RequestParam("tenantId") @NotBlank
                                                                                @NotBlank String tenantId,
                                                                                @RequestBody @Validated
                                                                                CreatePositionDTO createPositionDTO)
        更新岗位
        参数:
        tenantId - 租户id
        createPositionDTO - 岗位对象
        返回:
        Y9Result<Position> 通用请求返回对象 - data 是岗位对象
        从以下版本开始:
        9.6.0