审批

该分类包含 25 条以 system.approval. 开头的 Runtime 系统命令。

1. 列出定义

完整命令：system.approval.definition.list

列出审批定义。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system approval definition list \
  [--keyword value] [--cursor value] [--limit n] [--json]

参数：

keyword（可选）— Matches process name, code, description, subject, or status
subjectType（可选）— Only form_data is supported by this list
cursor（可选）— Opaque nextCursor from the previous request
limit（可选）— Maximum items, 1-100; defaults to 20

2. 获取定义

完整命令：system.approval.definition.get

获取审批定义资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system approval definition get --definition-id <uuid> [--json]

参数：

definitionId（必填）— Approval definition UUID discovered with its list command

3. 创建定义

完整命令：system.approval.definition.create

创建审批定义资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval definition create \
  (--definition-json json|--definition-file path) [--json]

参数：

code（必填）— Tenant-unique immutable-style code using lowercase letters, digits, and underscores
name（必填）— Process display name
description（可选）— Nullable process description
subjectType（必填）— Must be form_data
subjectKey（必填）— Enabled subject form UUID
subjectName（必填）— Current subject form name
schema（必填）— Initial approval graph; an empty nodes/edges draft is allowed only here

4. 更新定义

完整命令：system.approval.definition.update

更新审批定义资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval definition update \
  --definition-id <uuid> (--definition-json json|--definition-file path) \
  [--json]

参数：

definitionId（必填）— Approval definition UUID discovered with its list command
code/name/description（可选）— Basic process metadata
subjectType/subjectKey/subjectName（可选）— Replacement enabled form subject triple. Keep all three consistent

5. 启用定义

完整命令：system.approval.definition.enable

启用审批定义资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval definition enable --definition-id <uuid> [--json]

参数：

definitionId（必填）— Disabled approval definition UUID discovered with its list command

6. 归档定义

完整命令：system.approval.definition.archive

归档审批定义资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval definition archive --definition-id <uuid> [--json]

参数：

definitionId（必填）— Approval definition UUID discovered with its list command

7. 删除定义

完整命令：system.approval.definition.delete

删除审批定义资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：高风险

sl system approval definition delete --definition-id <uuid> [--json]

参数：

definitionId（必填）— Archived approval definition UUID discovered with its list command

8. 列出定义版本

完整命令：system.approval.definition.version.list

列出审批定义版本。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system approval definition version list \
  --definition-id <uuid> [--cursor value] [--limit n] [--json]

参数：

definitionId（必填）— Approval definition UUID discovered with its list command
cursor/limit（可选）— Opaque nextCursor and 1-100 version limit

9. 创建定义版本

完整命令：system.approval.definition.version.create

创建审批定义版本资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval definition version create \
  --definition-id <uuid> (--graph-json json|--graph-file path) [--json]

参数：

definitionId（必填）— Approval definition UUID discovered with its list command
schema（必填）— Complete connected graph validated against the approval compiler and tenant resources

10. 发布定义版本

完整命令：system.approval.definition.version.publish

发布审批定义版本资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval definition version publish \
  --definition-id <uuid> --version-id <uuid> [--json]

参数：

definitionId（必填）— Approval definition UUID discovered with its list command
versionId（必填）— Draft definition version UUID discovered with its list command

11. 列出记录

完整命令：system.approval.record.list

列出审批记录。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system approval record list \
  [--definition-id <uuid>] [--form-api-name value] [--status value] \
  [--from iso --to iso] [--keyword value] [--cursor value] [--limit n] \
  [--definition-json json|--definition-file path] [--json]

参数：

status（可选）— Current task status
instanceStatus（可选）— Overall instance status
definitionId/formApiName（可选）— Process and form filters
initiatorMemberId/currentApproverMemberId（可选）— Member UUID filters
startedAtFrom/startedAtTo（可选）— Paired ISO datetimes with offsets
keyword/searchFieldApiName（可选）— Keyword and optional field-specific search; field search requires formApiName
cursor/limit（可选）— Opaque nextCursor and 1-100 result limit; keep filters unchanged between requests

12. 获取记录列设置

完整命令：system.approval.record.column-settings.get

获取审批记录列设置资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system approval record column-settings get \
  --form-api-name value [--json]

参数：

formApiName（必填）— Form API name, or all for common approval columns

13. 保存记录列设置

完整命令：system.approval.record.column-settings.save

保存审批记录列设置资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval record column-settings save \
  --form-api-name value (--definition-json json|--definition-file path) \
  [--json]

参数：

formApiName（必填）— Same scope used by get
columns（必填）— Complete ordered column snapshot: fieldId, apiName, hidden, sortOrder

14. 获取实例

完整命令：system.approval.instance.get

获取审批实例资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system approval instance get --instance-id <uuid> [--json]

参数：

instanceId（必填）— Approval instance UUID discovered with its list command

15. 撤回实例管理员操作

完整命令：system.approval.instance.admin-withdraw

撤回管理员操作审批实例。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：高风险

sl system approval instance admin-withdraw \
  --instance-id <uuid> --reason value [--json]

参数：

instanceId（必填）— Running approval instance UUID discovered with its list command
reason（必填）— Mandatory administrator reason recorded as the withdrawal comment

16. 获取任务

完整命令：system.approval.task.get

获取审批任务资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system approval task get --task-id <uuid> [--json]

参数：

taskId（必填）— Approval task UUID discovered with its list command

17. 记录任务管理员决定

完整命令：system.approval.task.admin-decide

记录管理员决定审批任务。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：高风险

sl system approval task admin-decide \
  --task-id <uuid> (--definition-json json|--definition-file path) \
  [--json]

参数：

taskId（必填）— Pending approval task UUID discovered with its list command
decision（必填）— approved, rejected, or returned
reason（必填）— Mandatory administrator reason
mentionedMemberIds（可选）— Up to 50 active member UUIDs
returnTarget（可选）— Required only for returned: initiator, restart, or a prior nodeKey

18. 添加任务管理员签名

完整命令：system.approval.task.admin-add-sign

添加管理员签名审批任务。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval task admin-add-sign \
  --task-id <uuid> (--definition-json json|--definition-file path) \
  [--json]

参数：

taskId（必填）— Pending approval task UUID discovered with its list command
memberIds（必填）— 1-50 active tenant member UUIDs
reason（必填）— Mandatory administrator reason

19. 列出超时策略

完整命令：system.approval.timeout-rule.list

列出审批超时策略。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system approval timeout-rule list \
  [--keyword value] [--cursor value] [--limit n] [--json]

参数：

keyword（可选）— Rule name filter
cursor/limit（可选）— Opaque nextCursor and 1-100 result limit

20. 获取超时策略

完整命令：system.approval.timeout-rule.get

获取审批超时策略资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：读取

sl system approval timeout-rule get --rule-id <uuid> [--json]

参数：

ruleId（必填）— Timeout rule UUID discovered with its list command

21. 创建超时策略

完整命令：system.approval.timeout-rule.create

创建审批超时策略资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval timeout-rule create \
  (--definition-json json|--definition-file path) [--json]

参数：

name（必填）— Rule name
scopeType/definitionIds（必填）— selected_definitions requires IDs; all_definitions requires an empty list
timeoutValue/timeoutUnit（必填）— Primary timeout duration
actionRemind/actionAutoClose（必填）— At least one action must be true
remindTimeoutValue/remindTimeoutUnit（必填）— Reminder duration fields
autoCloseTimeoutValue/autoCloseTimeoutUnit（必填）— Auto-close duration fields
includeInProgressInstances（必填）— Whether enabling also schedules eligible running instances
repeatRemind/repeatRemindValue/repeatRemindUnit（必填）— Repeat configuration; repeat requires reminders
enabled（可选）— Fixed false for CLI creation; call enable after review

22. 更新超时策略

完整命令：system.approval.timeout-rule.update

更新审批超时策略资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval timeout-rule update \
  --rule-id <uuid> (--definition-json json|--definition-file path) \
  [--json]

参数：

ruleId（必填）— Timeout rule UUID discovered with its list command
configuration fields（可选）— Partial configuration update; enabled is intentionally excluded

23. 启用超时策略

完整命令：system.approval.timeout-rule.enable

启用审批超时策略资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval timeout-rule enable --rule-id <uuid> [--json]

参数：

ruleId（必填）— Disabled timeout rule UUID discovered with its list command

24. 停用超时策略

完整命令：system.approval.timeout-rule.disable

停用审批超时策略资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：写入

sl system approval timeout-rule disable --rule-id <uuid> [--json]

参数：

ruleId（必填）— Enabled timeout rule UUID discovered with its list command

25. 删除超时策略

完整命令：system.approval.timeout-rule.delete

删除审批超时策略资源。此租户级 Runtime 命令会按已注册的命令 schema 校验输入。 · 风险：高风险

sl system approval timeout-rule delete --rule-id <uuid> [--json]

参数：

ruleId（必填）— Disabled timeout rule UUID discovered with its list command

1. 列出定义​

2. 获取定义​

3. 创建定义​

4. 更新定义​

5. 启用定义​

6. 归档定义​

7. 删除定义​

8. 列出定义版本​

9. 创建定义版本​

10. 发布定义版本​

11. 列出记录​

12. 获取记录列设置​

13. 保存记录列设置​

14. 获取实例​

15. 撤回实例管理员操作​

16. 获取任务​

17. 记录任务管理员决定​

18. 添加任务管理员签名​

19. 列出超时策略​

20. 获取超时策略​

21. 创建超时策略​

22. 更新超时策略​

23. 启用超时策略​

24. 停用超时策略​

25. 删除超时策略​