Oa用户手册

OA 审批系统 · 用户手册 #

适用版本:SmartChart OA 模块 文档更新:2026-04-26


一、系统简介 #

OA 审批系统是一套轻量级流程审批工具,主要用于:

  • 员工发起各类审批(请假、报销、采购等)
  • 按预设流程自动流转给相关审批人
  • 审批人在线处理(通过、拒绝、转办等)
  • 管理后台配置流程和组织架构

系统支持多租户,不同租户(公司/部门)数据完全隔离。


二、页面入口 #

页面 入口地址 适用角色
OA 工作台 /oa/ 全体员工
流程设计器 /oa/designer/ 系统管理员
组织架构管理 /oa/org/ 系统管理员

三、普通员工操作指南 #

3.1 发起审批 #

  1. 进入 OA 工作台 → 点击顶部「发起申请」按钮
  2. 在流程列表中选择需要使用的审批流程(如"请假申请"、“费用报销"等)
  3. 填写表单内容(不同流程有不同的表单字段,如请假天数、事由、金额等)
  4. 如流程设计支持自选审批人,在表单中选择审批人
  5. 点击「提交」按钮

提交后,系统会自动将流程推送至审批人。

3.2 审批处理(待我审批) #

  1. 进入 OA 工作台 → 「待我审批」页面
  2. 点击任一任务,查看详情(申请内容、流程历史、当前节点等)
  3. 选择操作:
    • 通过:同意申请,继续流转
    • 拒绝:驳回申请,流程结束
    • 🔄 转办:转给其他人处理
    • ↩️ 退回:退回给发起人或前任审批人
    • 加签:临时增加其他审批人参与会签
  4. 如需填写审批意见,可在操作时一并填写

3.3 撤回申请 #

如果审批尚未开始处理,可在「我的申请」页面找到对应申请,点击「撤回」。

3.4 查看历史记录 #

  • 我的申请」:查看自己发起过的所有申请记录
  • 已我审批」:查看自己已处理过的审批记录
  • 支持按流程类型、状态、时间范围筛选

四、系统管理员操作指南 #

4.1 流程设计器 #

流程设计器用于配置审批流程的流转规则。

4.1.1 页面布局 #

┌─────────────────────────────────────────────────────────┐
│  工具栏: [新建] [保存] [发布] [发布新版本] [导出] [导入]     │
├──────────────┬──────────────────────────────────────────┤
│  节点组件    │              画布                         │
│  ─────────   │                                          │
│  ▶ 开始      │   [拖拽节点到画布,用箭头连接形成流程]      │
│  ▶ 审批节点  │                                          │
│  ▶ 会签节点  │                                          │
│  ▶ 或签节点  │                                          │
│  ▶ 条件分支  │                                          │
│  ▶ 并行分支  │                                          │
│  ▶ 通知节点  │                                          │
│  ▶ 延时节点  │                                          │
│  ▶ 智能体节点│                                          │
│  ▶ 结束      │                                          │
│              │                                          │
│  ─────────   │                                          │
│  流程信息    │                                          │
│  名称: xxx   │                                          │
│  UUID: xxx   │                                          │
│  [复制UUID]  │                                          │
└──────────────┴──────────────────────────────────────────┘

4.1.2 设计流程步骤 #

第一步:新建流程

  1. 点击「新建」按钮
  2. 输入流程名称和描述
  3. 开始拖拽节点

第二步:配置开始节点

  1. 拖拽「开始」节点到画布
  2. 双击打开配置面板
  3. 在「表单设计」中添加需要收集的字段(如请假天数、事由、金额等)
  4. 支持字段类型:文本、多行文本、数字、日期、单选、复选、下拉、人员选择、部门选择、金额等

第三步:添加审批节点

  1. 拖拽「审批节点」(单人)或「会签节点」(多人)到画布
  2. 双击配置审批人来源:
    • 指定人员:固定选择某人为审批人
    • 发起人自选:发起人在提交时自己选择
    • 表单字段:从发起人填写的表单中读取(如"部门负责人"字段)
  3. 设置办理期限(可选)
  4. 会签节点可设置"多人时全部通过才通过”,或签节点设置"任意一人通过即通过"

第四步:配置条件分支(如需)

  1. 拖拽「条件分支」节点
  2. 双击配置路由条件,使用变量语法:
    • v.xxx — 变量值
    • v.xxx.yyy — 对象属性
    • v.xxx[0] — 数组第一个元素
  3. 例:v.amount > 10000 表示金额超过1万的走此分支

第五步:保存并发布

  1. 点击「保存」——保存草稿
  2. 点击「发布」——正式发布,流程可供使用

💡 提示:发布后如需修改,只能发布新版本,旧版本流程实例不受影响。

4.1.3 节点类型说明 #

节点类型 用途说明
开始 流程入口,定义发起时需要填写的表单
审批节点 单人审批,指定一个人处理
会签节点 多人依次审批,全部通过才算通过
或签节点 多人审批,任意一人通过即通过
条件分支 根据条件表达式,自动选择下一个节点
并行分支 多条分支同时执行,最后合并
通知节点 向指定人员发送站内消息
延时节点 流程在此节点暂停等待指定时间后再继续
脚本节点 执行一段 Python 代码(用于数据处理)
智能体节点 调用 SmartChart 智能体处理复杂逻辑
数据写入节点 将表单数据写入指定数据表
子流程节点 触发另一个审批流程(子流程)
变量节点 在流程中设置/修改变量值
事件节点 触发外部系统事件
结束 流程正常结束节点

4.1.4 复制流程 UUID #

在左侧面板的「流程信息」区域直接显示该流程的 UUID,点击复制图标即可复制。

UUID 用途:如果需要通过接口(API)发起此流程,需要传入该 UUID。


4.2 组织架构管理 #

入口:OA 工作台 → 右上角「组织管理」(或直接访问 /oa/org/

4.2.1 租户管理 #

租户是系统中的最高层级隔离单位(如不同子公司、不同部门使用不同租户)。

租户管理仅系统超级管理员可操作,普通管理员无法访问。

4.2.2 角色与权限 #

系统内置 3 个角色,每个角色对应不同权限码:

角色 权限 说明
组织管理员 org_manage 管理组织架构(部门、岗位、员工)
员工管理员 employee_manage 增删改查员工信息
任务管理员 task_manage 处理审批任务

权限码与流程的"启动权限"对应——在设计流程时,可指定只有特定角色的人才能发起该流程。

4.2.3 部门管理 #

  • 添加、编辑、删除部门
  • 设置上级部门(形成树形结构)
  • 部门树形展示,支持按名称搜索

4.2.4 岗位管理 #

  • 添加、编辑、删除岗位
  • 岗位可设置对应的角色权限

4.2.5 员工管理 #

  • 添加、编辑、删除员工账号
  • 设置员工所属部门、岗位、直接上级
  • 设置员工的兼任部门(一个员工可同时属于多个部门)
  • 设置员工角色(决定可访问哪些功能)

员工状态分为在职(ACTIVE)和非在职,离职员工登录后无法使用系统。


五、常见问题 #

Q:发起审批时找不到对应流程? A:请联系系统管理员,确认该流程已发布且您有启动权限(角色匹配)。

Q:审批人被指定了,但看不到待办任务? A:请检查是否登录了正确的租户,或刷新页面重新加载。

Q:可以修改正在运行中的流程吗? A:不可以。流程实例一旦启动,流程定义不可修改。如需变更,需终止旧实例后用新流程重新发起。

Q:员工离职后,其发起的申请怎么处理? A:已发起的申请流程不受影响,正常流转。离职员工账号会被标记为非在职,无法登录。

Q:如何通过接口(API)发起流程? A:请使用 POST /oa/instance/start/ 接口,请求体格式详见第六章。API 调用方需要持有有效用户身份(cookie 中的 session 或 token)。


六、附录:常用术语 #

术语 解释
流程定义(FlowInfo) 流程的模板/配置,决定流程如何流转
流程实例(FlowInstance) 某次具体的申请,从发起开始到结束
流程任务(FlowTask) 流程中每个节点的待办事项
租户(Tenant) 数据隔离单位,对应一个公司或部门
变量(Variable) 流程中的动态数据,可用于条件判断
会签 多个人都要审批,全部通过才算通过
或签 多个人中任意一人审批通过即可
转办 将任务转给其他人处理
退回 将流程退回到之前某个节点重新处理

如有更多问题,请联系系统管理员。