git:20260520.d8e6218 to git:20260702.ac3bada

1 added, 7 removed. Audit A to A.

---

name: yida-agent-center

- description: 宜搭代理中心管理。查询、新增、编辑、撤销在职流程代理和离职代理，支持代处理流程、代提交流程、全部/部分流程范围。不适用于流程规则设计（应使用 yida-process-rule）或任务列表查询（应使用 yida-data-management/task-center）。

+ description: 宜搭代理中心管理。查询、新增、编辑、撤销在职流程代理和离职代理，支持代处理流程、代提交流程、全部或部分流程范围。适用于设置流程审批的代理人。

---

# 代理中心管理

## 严格要求 (MUST DO)

- 创建、更新、撤销代理会影响真实流程审批/提交责任，执行前必须向用户确认被代理人/离职人、代理人、代理类型、时间范围和影响范围。

- 同名人员必须先用 `agent-center search-user` 或 `corp-manager search-user` 确认 userId 和部门路径，不得只凭姓名操作。

- 离职代理只有平台管理员可操作；如果接口返回无权限，不要重试，提示用户切换管理员账号或联系平台管理员。

- 普通在职代理必须传 `--start` 和 `--end`；离职代理不要传时间，平台按离职状态生效。

- 部分流程代理使用 `--range part` 时，必须提供 `--range-form <appType:formUuid>` 或 `--range-json`/`--range-file`。

- ## 不适用场景

- - 设计或发布审批流程规则：使用 `yida-process-rule`。

- - 查询待办、已处理、抄送、代提交任务：使用 `openyida task-center` 或 `yida-data-management`。

- - 平台管理员、应用管理员、通讯录可见性：使用 `yida-corp-manager`。

## 常用命令

查询代理列表：

```bash

openyida agent-center list --status EFF --page 1 --size 20

```

搜索人员，确认 userId：

```bash

openyida agent-center search-user "余浩" --dept "宜搭,钉钉官方同学"

```

新增在职代理（默认代处理流程）：

```bash

openyida agent-center create \

--source-user <被代理人userId> \

--target-user <代理人userId> \

--start "2026-05-20 09:00" \

--end "2026-05-21 18:00" \

--notify-source y

```

新增代提交流程代理：

```bash

openyida agent-center create \

--source-user <被代理人userId> \

--target-user <代理人userId> \

--category start \

--start "2026-05-20 09:00" \

--end "2026-05-21 18:00"

```

新增部分流程代理：

```bash

openyida agent-center create \

--source-user <被代理人userId> \

--target-user <代理人userId> \

--start "2026-05-20 09:00" \

--end "2026-05-21 18:00" \

--range part \

--range-form APP_xxx:FORM_xxx,APP_xxx:FORM_yyy

```

新增离职代理：

```bash

openyida agent-center create \

--type departure \

--source-user <离职人userId> \

--target-user <代理人userId>

```

编辑代理人：

```bash

openyida agent-center update <agentUuid> --target-user <新代理人userId> --type normal

```

撤销代理：

```bash

openyida agent-center cancel <agentUuid> --type normal

openyida agent-center cancel <agentUuid> --type departure

```

查询部分流程范围：

```bash

openyida agent-center range <agentUuid>

```

## 参数映射

| CLI 参数 | 页面含义 | 接口字段 |

|---------|----------|----------|

| `--source-user` | 被代理人 / 离职人 | `sourceActionerId` |

| `--target-user` | 代理人 | `toActionerId` |

| `--type normal` | 新增代理 | `agentType=NORMAL` |

| `--type departure` | 离职设置 | `agentType=DEPARTURE` |

| `--category execute` | 代处理流程 | `agentCategory=EXECUTE` |

| `--category start` | 代提交流程 | `agentCategory=START` |

| `--notify-source y` | 代理任务通知被代理人 | `originIsView=y` |

| `--range all` | 全部流程 | `agentRangeType=ALL` |

| `--range part` | 部分流程 | `agentRangeType=PART` |

## 状态映射

| 状态 | 页面含义 |

|------|----------|

| `ALL` | 全部 |

| `DIS` | 待生效 |

| `EFF` | 代理中 |

| `OUT` | 已过期 |

| `CANCEL` | 已撤销 |

## 安全检查清单

1. `agent-center search-user` 确认被代理人/离职人和代理人的 userId、部门路径。

2. `agent-center list --keyword <userId>` 查看是否已有代理记录。

3. 展示将要执行的 create/update/cancel 命令和影响范围。

4. 用户确认后执行。

5. 执行后用 `agent-center list --keyword <userId>` 验证状态。