ExternalInstanceTaskNode.Builder (larksuite-oapi 2.8.5 API)

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

封闭类:: ExternalInstanceTaskNode

public static class ExternalInstanceTaskNode.Builder
extends Object

构造器概要

构造器
构造器和说明

Builder()

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

方法概要

所有方法实例方法具体方法
限定符和类型	方法和说明
`ExternalInstanceTaskNode.Builder`	`actionConfigs(ActionConfig[] actionConfigs)` 任务级别的快捷审批操作配置，需要在[创建三方审批定义](https://open.feishu.cn/document%2FuAjLw4CM%2FukTMukTMukTM%2Freference%2Fapproval-v4%2Fexternal_approval%2Fcreate)中配置正确的回调地址，回调参数参考[三方快捷审批回调](https://open.feishu.cn/document%2FukTMukTMukTM%2FukjNyYjL5YjM24SO2IjN%2Fquick-approval-callback)。
`ExternalInstanceTaskNode.Builder`	`actionContext(String actionContext)` 操作上下文。
`ExternalInstanceTaskNode`	`build()`
`ExternalInstanceTaskNode.Builder`	`createTime(String createTime)` 任务创建时间，Unix 毫秒时间戳。
`ExternalInstanceTaskNode.Builder`	`displayMethod(ExternalInstanceTaskNodeDisplayMethodEnum displayMethod)` 审批中心列表页打开审批任务的方式。
`ExternalInstanceTaskNode.Builder`	`displayMethod(String displayMethod)` 审批中心列表页打开审批任务的方式。
`ExternalInstanceTaskNode.Builder`	`endTime(String endTime)` 任务完成时间。
`ExternalInstanceTaskNode.Builder`	`excludeStatistics(Boolean excludeStatistics)` 三方审批任务是否不纳入效率统计。
`ExternalInstanceTaskNode.Builder`	`extra(String extra)` 扩展字段。
`ExternalInstanceTaskNode.Builder`	`generateType(ExternalInstanceTaskNodeGenerateTypeEnum generateType)` 任务生成类型，保留字段，可不填，但是不要填空字符串示例值：EXTERNAL_CONSIGN
`ExternalInstanceTaskNode.Builder`	`generateType(String generateType)` 任务生成类型，保留字段，可不填，但是不要填空字符串示例值：EXTERNAL_CONSIGN
`ExternalInstanceTaskNode.Builder`	`links(ExternalInstanceLink links)` 审批实例链接信息。
`ExternalInstanceTaskNode.Builder`	`nodeId(String nodeId)` 审批节点 ID，目前用于效率诊断的流程诊断，如需关注效率数据，请按照准确的流程数据填写，要求如下：;;- 一个审批流程内，每个节点 ID 唯一。
`ExternalInstanceTaskNode.Builder`	`nodeName(String nodeName)` 节点名称，审批节点名称，目前用于效率诊断流程诊断，如需关注效率数据，请按照准确的流程数据填写，要求如下：;;- 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。
`ExternalInstanceTaskNode.Builder`	`openId(String openId)` 审批人 open_id，获取方式参见[如何获取用户的 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)。
`ExternalInstanceTaskNode.Builder`	`status(ExternalInstanceTaskNodeStatusEnum status)` 任务状态示例值：PENDING
`ExternalInstanceTaskNode.Builder`	`status(String status)` 任务状态示例值：PENDING
`ExternalInstanceTaskNode.Builder`	`taskId(String taskId)` 审批实例内，审批任务的唯一标识，用于更新审批任务时定位数据。
`ExternalInstanceTaskNode.Builder`	`title(String title)` 审批任务名称。
`ExternalInstanceTaskNode.Builder`	`updateTime(String updateTime)` 任务最近更新时间，Unix 毫秒时间戳，用于推送数据版本控制。
`ExternalInstanceTaskNode.Builder`	`userId(String userId)` 审批人 user_id，获取方式参见[如何获取用户的 User ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id)。

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

- 构造器详细资料
  - Builder
```
public Builder()
```
- 方法详细资料
  - taskId
```
public ExternalInstanceTaskNode.Builder taskId(String taskId)
```
    审批实例内，审批任务的唯一标识，用于更新审批任务时定位数据。
    示例值：112534
    
    参数:
    
    taskId -
    
    返回:
  - userId
```
public ExternalInstanceTaskNode.Builder userId(String userId)
```
    审批人 user_id，获取方式参见[如何获取用户的 User ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-user-id)。; ;**说明**：; ;- 该任务会出现在审批人的飞书审批中心 **待办** 或 **已办** 的列表中。;- user_id 与 open_id 需至少传入一个。
    示例值：a987sf9s
    
    参数:
    
    userId -
    
    返回:
  - openId
```
public ExternalInstanceTaskNode.Builder openId(String openId)
```
    审批人 open_id，获取方式参见[如何获取用户的 Open ID](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-obtain-openid)。; ;**说明**：; ;- 该任务会出现在审批人的飞书审批中心 **待办** 或 **已办** 的列表中。;- user_id 与 open_id 需至少传入一个。
    示例值：ou_be73cbc0ee35eb6ca54e9e7cc14998c1
    
    参数:
    
    openId -
    
    返回:
  - title
```
public ExternalInstanceTaskNode.Builder title(String title)
```
    审批任务名称。; ;**说明**：;;- 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。;;- Key 需要以 @i18n@ 开头。
    示例值：@i18n@4
    
    参数:
    
    title -
    
    返回:
  - links
```
public ExternalInstanceTaskNode.Builder links(ExternalInstanceLink links)
```
    审批实例链接信息。设置的链接用于在审批中心 **已发起** 列表内点击跳转，跳回三方审批系统查看审批详情。
    示例值：
    
    参数:
    
    links -
    
    返回:
  - status
```
public ExternalInstanceTaskNode.Builder status(String status)
```
    任务状态
    示例值：PENDING
    
    参数:
    
    status -
    
    返回:
  - status
```
public ExternalInstanceTaskNode.Builder status(ExternalInstanceTaskNodeStatusEnum status)
```
    任务状态
    示例值：PENDING
    
    参数:
    
    status - ExternalInstanceTaskNodeStatusEnum
    
    返回:
  - extra
```
public ExternalInstanceTaskNode.Builder extra(String extra)
```
    扩展字段。JSON 格式，传值时需要压缩转义为字符串。目前支持指定任务结束原因(complete_reason)，用于三方审批的效率诊断，如需关注效率数据，请传入正确的值，枚举值说明如下：;; - approved：同意; - rejected：拒绝; - node_auto_reject：因逻辑判断产生的自动拒绝; - specific_rollback：退回（包括退回到发起人、退回到中间任一审批人）; - add：并加签（添加新审批人，与我一起审批）; - add_pre：前加签（添加新审批人，在我之前审批）; - add_post：后加签（添加新审批人，在我之后审批）; - delete_assignee：减签; - forward: 手动转交; - forward_resign：离职自动转交; - recall：撤销（撤回单据，单据失效）; - delete ：删除审批单; - admin_forward：管理员在后台操作转交; - system_forward：系统自动转交; - auto_skip：自动通过; - manual_skip：手动跳过; - submit_again：重新提交任务; - restart：重新启动流程; - others：其他
    示例值：{\"xxx\":\"xxx\",\"complete_reason\":\"approved\"}
    
    参数:
    
    extra -
    
    返回:
  - createTime
```
public ExternalInstanceTaskNode.Builder createTime(String createTime)
```
    任务创建时间，Unix 毫秒时间戳。
    示例值：1556468012678
    
    参数:
    
    createTime -
    
    返回:
  - endTime
```
public ExternalInstanceTaskNode.Builder endTime(String endTime)
```
    任务完成时间。未结束的审批为 0，Unix 毫秒时间戳。
    示例值：1556468012678
    
    参数:
    
    endTime -
    
    返回:
  - updateTime
```
public ExternalInstanceTaskNode.Builder updateTime(String updateTime)
```
    任务最近更新时间，Unix 毫秒时间戳，用于推送数据版本控制。;如果 update_mode 值为 UPDATE，则仅当传过来的 update_time 有变化时（变大），才会更新审批中心中的审批任务信息。
    示例值：1556468012678
    
    参数:
    
    updateTime -
    
    返回:
  - actionContext
```
public ExternalInstanceTaskNode.Builder actionContext(String actionContext)
```
    操作上下文。当用户操作审批时，回调请求中会包含该参数，用于传递该任务的上下文数据。
    示例值：123456
    
    参数:
    
    actionContext -
    
    返回:
  - actionConfigs
```
public ExternalInstanceTaskNode.Builder actionConfigs(ActionConfig[] actionConfigs)
```
    任务级别的快捷审批操作配置，需要在[创建三方审批定义](https://open.feishu.cn/document%2FuAjLw4CM%2FukTMukTMukTM%2Freference%2Fapproval-v4%2Fexternal_approval%2Fcreate)中配置正确的回调地址，回调参数参考[三方快捷审批回调](https://open.feishu.cn/document%2FukTMukTMukTM%2FukjNyYjL5YjM24SO2IjN%2Fquick-approval-callback)。; ;**注意**：快捷审批目前仅支持在飞书移动端操作。
    示例值：
    
    参数:
    
    actionConfigs -
    
    返回:
  - displayMethod
```
public ExternalInstanceTaskNode.Builder displayMethod(String displayMethod)
```
    审批中心列表页打开审批任务的方式。
    示例值：BROWSER
    
    参数:
    
    displayMethod -
    
    返回:
  - displayMethod
```
public ExternalInstanceTaskNode.Builder displayMethod(ExternalInstanceTaskNodeDisplayMethodEnum displayMethod)
```
    审批中心列表页打开审批任务的方式。
    示例值：BROWSER
    
    参数:
    
    displayMethod - ExternalInstanceTaskNodeDisplayMethodEnum
    
    返回:
  - excludeStatistics
```
public ExternalInstanceTaskNode.Builder excludeStatistics(Boolean excludeStatistics)
```
    三方审批任务是否不纳入效率统计。可选值有：;;- true：此任务不纳入效率统计;- false：此任务纳入效率统计
    示例值：false
    
    参数:
    
    excludeStatistics -
    
    返回:
  - nodeId
```
public ExternalInstanceTaskNode.Builder nodeId(String nodeId)
```
    审批节点 ID，目前用于效率诊断的流程诊断，如需关注效率数据，请按照准确的流程数据填写，要求如下：;;- 一个审批流程内，每个节点 ID 唯一。例如，一个流程下直属上级、隔级上级等节点的 node_id 均不一样。;- 同一个三方审批定义内，不同审批实例中的相同节点，node_id 要保持不变。例如，用户 A 和用户 B 分别发起了请假申请，这两个审批实例中的直属上级节点的 node_id 应该保持一致。
    示例值：node
    
    参数:
    
    nodeId -
    
    返回:
  - nodeName
```
public ExternalInstanceTaskNode.Builder nodeName(String nodeName)
```
    节点名称，审批节点名称，目前用于效率诊断流程诊断，如需关注效率数据，请按照准确的流程数据填写，要求如下：;;- 这里传入的是国际化文案 Key（即 i18n_resources.texts 参数中的 Key），还需要在 i18n_resources.texts 参数中以 Key:Value 格式进行赋值。;;- Key 需要以 @i18n@ 开头。
    示例值：i18n@name
    
    参数:
    
    nodeName -
    
    返回:
  - generateType
```
public ExternalInstanceTaskNode.Builder generateType(String generateType)
```
    任务生成类型，保留字段，可不填， **但是不要填空字符串**
    示例值：EXTERNAL_CONSIGN
    
    参数:
    
    generateType -
    
    返回:
  - generateType
```
public ExternalInstanceTaskNode.Builder generateType(ExternalInstanceTaskNodeGenerateTypeEnum generateType)
```
    任务生成类型，保留字段，可不填， **但是不要填空字符串**
    示例值：EXTERNAL_CONSIGN
    
    参数:
    
    generateType - ExternalInstanceTaskNodeGenerateTypeEnum
    
    返回:
  - build
```
public ExternalInstanceTaskNode build()
```

类 ExternalInstanceTaskNode.Builder

构造器概要

方法概要

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

构造器详细资料

Builder

方法详细资料

taskId

userId

openId

title

links

status

status

extra

createTime

endTime

updateTime

actionContext

actionConfigs

displayMethod

displayMethod

excludeStatistics

nodeId

nodeName

generateType

generateType

build