TaskSearch.Builder (larksuite-oapi 2.8.5 API)

java.lang.Object
- com.lark.oapi.service.approval.v4.model.TaskSearch.Builder

封闭类:: TaskSearch

public static class TaskSearch.Builder
extends Object

构造器概要

构造器
构造器和说明

Builder()

构造器
构造器和说明
`Builder()`

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`TaskSearch.Builder`	`approvalCode(String approvalCode)` 审批定义 Code。
`TaskSearch`	`build()`
`TaskSearch.Builder`	`groupExternalId(String groupExternalId)` 审批定义分组的第三方 ID。
`TaskSearch.Builder`	`instanceCode(String instanceCode)` 审批实例 Code。
`TaskSearch.Builder`	`instanceExternalId(String instanceExternalId)` 审批实例的第三方 ID。
`TaskSearch.Builder`	`locale(String locale)` 语言。
`TaskSearch.Builder`	`locale(TaskSearchTaskSearchLocaleEnum locale)` 语言。
`TaskSearch.Builder`	`order(Integer order)` 按任务时间排序示例值：2
`TaskSearch.Builder`	`order(TaskSearchTaskSearchOrderEnum order)` 按任务时间排序示例值：2
`TaskSearch.Builder`	`taskStartTimeFrom(String taskStartTimeFrom)` 任务查询开始时间，Unix 毫秒时间戳。
`TaskSearch.Builder`	`taskStartTimeTo(String taskStartTimeTo)` 任务查询结束时间，Unix 毫秒时间戳。
`TaskSearch.Builder`	`taskStatus(String taskStatus)` 审批任务状态。
`TaskSearch.Builder`	`taskStatus(TaskSearchTaskSearchTaskStatusEnum taskStatus)` 审批任务状态。
`TaskSearch.Builder`	`taskStatusList(String[] taskStatusList)` 查询多种状态的任务，当填写此参数时，task_status 参数将失效。
`TaskSearch.Builder`	`taskTitle(String taskTitle)` 审批任务标题。
`TaskSearch.Builder`	`userId(String userId)` 任务审批人 ID，ID 类型与查询参数 user_id_type 保持一致。
`TaskSearch.Builder`	`withRevokedInstance(Boolean withRevokedInstance)` 是否包含撤销申请对应的审批单示例值：false

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - Builder
```
public Builder()
```
- 方法详细资料
  - userId
```
public TaskSearch.Builder userId(String userId)
```
    任务审批人 ID，ID 类型与查询参数 user_id_type 保持一致。
    示例值：lwiu098wj
    
    参数:
    
    userId -
    
    返回:
  - approvalCode
```
public TaskSearch.Builder approvalCode(String approvalCode)
```
    审批定义 Code。获取方式：;;- 调用[创建审批定义](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/approval/create)接口后，从响应参数 approval_code 获取。;- 登录审批管理后台，在指定审批定义的 URL 中获取，具体操作参见[什么是 Approval Code](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/approval/overview-of-approval-resources#8151e0ae)。;;**注意**：;;- user_id、approval_code、instance_code、instance_external_id、group_external_id 不能同时为空。;;- approval_code 和 group_external_id 查询结果取并集。
    示例值：EB828003-9FFE-4B3F-AA50-2E199E2ED942
    
    参数:
    
    approvalCode -
    
    返回:
  - instanceCode
```
public TaskSearch.Builder instanceCode(String instanceCode)
```
    审批实例 Code。获取方式：;;- 调用[创建审批实例](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/create)接口后，从响应参数 instance_code 获取。;- 调用[批量获取审批实例 ID](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/approval-v4/instance/list)接口，获取所需的审批实例 Code。;;**注意**：;;- user_id、approval_code、instance_code、instance_external_id、group_external_id 不能同时为空。;;- instance_code 和 instance_external_id 查询结果取并集。
    示例值：EB828003-9FFE-4B3F-AA50-2E199E2ED943
    
    参数:
    
    instanceCode -
    
    返回:
  - instanceExternalId
```
public TaskSearch.Builder instanceExternalId(String instanceExternalId)
```
    审批实例的第三方 ID。;;**注意**：;;- user_id、approval_code、instance_code、instance_external_id、group_external_id 不能同时为空。;;- instance_code 和 instance_external_id 查询结果取并集。
    示例值：EB828003-9FFE-4B3F-AA50-2E199E2ED976
    
    参数:
    
    instanceExternalId -
    
    返回:
  - groupExternalId
```
public TaskSearch.Builder groupExternalId(String groupExternalId)
```
    审批定义分组的第三方 ID。;;**注意**：;;- user_id、approval_code、instance_code、instance_external_id、group_external_id 不能同时为空。;;- approval_code 和 group_external_id 查询结果取并集。
    示例值：1234567
    
    参数:
    
    groupExternalId -
    
    返回:
  - taskTitle
```
public TaskSearch.Builder taskTitle(String taskTitle)
```
    审批任务标题。;;**说明**：仅第三方审批存在审批任务标题。
    示例值：test
    
    参数:
    
    taskTitle -
    
    返回:
  - taskStatus
```
public TaskSearch.Builder taskStatus(String taskStatus)
```
    审批任务状态。;;**注意**：若不设置则查询全部状态，若不在集合中，则报错。
    示例值：PENDING
    
    参数:
    
    taskStatus -
    
    返回:
  - taskStatus
```
public TaskSearch.Builder taskStatus(TaskSearchTaskSearchTaskStatusEnum taskStatus)
```
    审批任务状态。;;**注意**：若不设置则查询全部状态，若不在集合中，则报错。
    示例值：PENDING
    
    参数:
    
    taskStatus - TaskSearchTaskSearchTaskStatusEnum
    
    返回:
  - taskStartTimeFrom
```
public TaskSearch.Builder taskStartTimeFrom(String taskStartTimeFrom)
```
    任务查询开始时间，Unix 毫秒时间戳。与 task_start_time_to 参数构成时间段查询条件，仅会返回在该时间段内的审批任务。;;**注意**：查询时间跨度不得大于 30 天，开始和结束时间必须同时设置或者同时不设置。
    示例值：1547654251506
    
    参数:
    
    taskStartTimeFrom -
    
    返回:
  - taskStartTimeTo
```
public TaskSearch.Builder taskStartTimeTo(String taskStartTimeTo)
```
    任务查询结束时间，Unix 毫秒时间戳。与 task_start_time_from 参数构成时间段查询条件，仅会返回在该时间段内的审批任务。;;**注意**：查询时间跨度不得大于 30 天，开始和结束时间必须同时设置或者同时不设置。
    示例值：1547654251506
    
    参数:
    
    taskStartTimeTo -
    
    返回:
  - locale
```
public TaskSearch.Builder locale(String locale)
```
    语言。
    示例值：zh-CN
    
    参数:
    
    locale -
    
    返回:
  - locale
```
public TaskSearch.Builder locale(TaskSearchTaskSearchLocaleEnum locale)
```
    语言。
    示例值：zh-CN
    
    参数:
    
    locale - TaskSearchTaskSearchLocaleEnum
    
    返回:
  - taskStatusList
```
public TaskSearch.Builder taskStatusList(String[] taskStatusList)
```
    查询多种状态的任务，当填写此参数时，task_status 参数将失效。;;**可选值有**：;;- `PENDING`：审批中;- `REJECTED`：拒绝;- `APPROVED`：通过;- `TRANSFERRED`：转交;- `DONE`：已完成;- `RM_REPEAT`：去重;- `PROCESSED`：已处理
    示例值：PENDING
    
    参数:
    
    taskStatusList -
    
    返回:
  - order
```
public TaskSearch.Builder order(Integer order)
```
    按任务时间排序
    示例值：2
    
    参数:
    
    order -
    
    返回:
  - order
```
public TaskSearch.Builder order(TaskSearchTaskSearchOrderEnum order)
```
    按任务时间排序
    示例值：2
    
    参数:
    
    order - TaskSearchTaskSearchOrderEnum
    
    返回:
  - withRevokedInstance
```
public TaskSearch.Builder withRevokedInstance(Boolean withRevokedInstance)
```
    是否包含撤销申请对应的审批单
    示例值：false
    
    参数:
    
    withRevokedInstance -
    
    返回:
  - build
```
public TaskSearch build()
```

类 TaskSearch.Builder

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

Builder

方法详细资料

userId

approvalCode

instanceCode

instanceExternalId

groupExternalId

taskTitle

taskStatus

taskStatus

taskStartTimeFrom

taskStartTimeTo

locale

locale

taskStatusList

order

order

withRevokedInstance

build