简介这份 ASP.NET 自动办公系统源码面向需要搭建企业 OA 与审批流的中高级 .NET 开发者基于 VS2008 与 SQL2005 环境采用经典三层架构可直接用于二次开发或教学参考。系统界面借鉴猫扑的标签式操作涵盖个人事务公司通知浏览与维护、日程安排、人员列表、审批流转起草审批、待我审批、经我审批、审批查询、审批监控、审批档案中心及审批类别、节点、模板、流程、归档等管理、内部邮件与系统设置等模块。源码集成大文件上传进度条、ckeditor 与 ckfinder 配合的公文模板设定、DsoFramer 在线编辑 Office 2003-2007 并支持修改留痕以及 IE 下 VML 画图模块技术点密集。压缩包共 2069 个文件以 js、gif、cs、html、aspx、css 等为主整体约 8.86MB目录结构完整。目前已有 1171 人学习下载适合研究审批流设计与富文本、在线编辑集成的开发者参考。1. 从一堆散落文件说起这套 ASP.NET 自动办公系统源码到底能跑出什么如果你手里拿到的是一个压缩包解压后看到all-wcprops、config.ascx、page.ascx、ckeditor.asp、events.asp、advanced.asp、replaceall.asp这些文件混在一起第一反应大概率是懵的——这到底是半成品还是完整工程我拆过不少 OA 类源码这套 ASP.NET 自动办公系统的结构其实很典型它把审批流、公文模板、在线编辑、大文件上传这些办公场景里最硬的需求都做进去了而且用的是三层架构前端界面参照猫扑那种标签式操作不是现在流行的 SPA 风格但胜在逻辑直白、改起来不绕。它适合谁如果你正在找一套能跑在 VS2008 SQL2005 环境下、带完整审批流转和公文留痕的 ASP.NET 源码用来做二次开发或者内部系统原型这套东西的参考价值比那些只有增删改查的 demo 高得多。尤其是审批节点、审批模板、归档设置这几块很多开源 OA 要么砍掉要么做得极简这套至少把流程配置的骨架搭全了。下面我按实际拆包和跑通的顺序把关键模块、配置参数和容易翻车的地方一条条过一遍。2. 三层架构与标签式界面这套 OA 的骨架怎么搭2.1 三层架构在源码里的实际落点三层架构这个词被说烂了但在这套源码里你能看到它具体怎么落地。表现层是.ascx用户控件和.aspx页面业务逻辑层集中在App_Code下的类文件里数据访问层通过 SQLHelper 或类似封装跟 SQL2005 打交道。你打开config.ascx会发现它承担了部分配置读取的职责而page.ascx更像是页面基类或者公共头部控件负责统一加载样式和脚本。这种结构的直接好处是改审批逻辑不用动页面改页面样式不用碰数据库。但坑也在这里——很多二次开发的人图省事直接在.ascx的Page_Load里写 SQL 查询三层就变成了两层半后面想换数据库或者加缓存就非常痛苦。我一般会先花半小时把App_Code里的类名和数据库表名对一遍画一张简单的映射表再动手改任何东西。// 典型的三层调用示例根据源码结构还原 // 表现层ApprovalList.ascx.cs protected void Page_Load(object sender, EventArgs e) { if (!IsPostBack) { // 调用业务逻辑层不直接写 SQL DataTable dt ApprovalManager.GetPendingList(CurrentUserId); rptList.DataSource dt; rptList.DataBind(); } } // 业务逻辑层ApprovalManager.cs public static DataTable GetPendingList(int userId) { // 参数校验和业务规则在这里 if (userId 0) throw new ArgumentException(用户ID无效); return ApprovalDAL.GetPendingByUser(userId); } // 数据访问层ApprovalDAL.cs public static DataTable GetPendingByUser(int userId) { string sql SELECT * FROM OA_Approval WHERE ApproverIdUserId AND Status0; SqlParameter[] paras { new SqlParameter(UserId, userId) }; return SqlHelper.ExecuteDataTable(sql, paras); }上面这段代码的关键在于表现层只负责绑定业务层做校验数据层只拼 SQL 和参数。参数UserId必须用 SqlParameter 传不要用字符串拼接否则 SQL 注入是迟早的事。如果你在源码里看到WHERE ApproverId userId这种写法建议优先改掉这是后面所有安全问题的源头。2.2 标签式界面的实现方式与改造边界界面参照猫扑的标签式操作实际实现大概率是用MultiView或者divdisplay切换来做的。你打开page.ascx会看到一组标签按钮点击后切换下方内容区域。这种做法的好处是页面不刷新、体验接近桌面软件坏处是 ViewState 会变大而且所有标签的内容都在同一个页面生命周期里某个标签出错可能影响整页。改造的时候注意两点第一标签切换的 JavaScript 函数名和控件 ID 是硬绑定的你改控件 ID 就要同步改 JS否则点击没反应第二如果要在标签里嵌 iframe 加载审批表单注意 IE 下 iframe 的src切换会导致历史记录混乱常见做法是用window.location.hash做简单路由或者干脆用Response.Redirect换页。我一般会保留标签结构但把每个标签的内容做成独立的用户控件这样编译和调试都清爽很多。// 标签切换的典型实现根据 page.ascx 还原 function switchTab(tabId) { // 隐藏所有内容区 var contents document.getElementsByClassName(tab-content); for (var i 0; i contents.length; i) { contents[i].style.display none; } // 显示目标内容区 var target document.getElementById(tabId); if (target) { target.style.display block; } // 更新标签按钮样式 var tabs document.getElementsByClassName(tab-btn); for (var j 0; j tabs.length; j) { tabs[j].className tabs[j].className.replace( active, ); } document.getElementById(btn_ tabId).className active; }这段 JS 里tabId的命名规则要和后台生成的 HTML 一致否则getElementById拿不到元素。如果你在 IE8 下测试getElementsByClassName是不支持的需要换成document.all或者引入兼容脚本。这也是这套源码跑在旧环境下的一个典型坑。3. 审批流转模块从起草到归档的完整链路怎么配3.1 审批节点与流程设置的数据库映射审批流转是这套系统的核心源码里对应的表大概有OA_Approval审批主表、OA_ApprovalNode审批节点表、OA_ApprovalTemplate审批模板表、OA_ApprovalCategory审批类别表。你打开审批管理下的“审批节点”和“审批流程设置”实际上是在操作这几张表。流程设置的本质是一条审批记录从起草人开始经过若干个节点每个节点指定审批人或者角色审批人通过后流转到下一节点直到归档。源码里大概率用NodeOrder字段控制顺序用NextNodeId或者直接按NodeOrder递增来找下一个节点。配置的时候注意如果某个节点的审批人离职或者角色为空流程会卡住所以最好在业务层加一个默认审批人兜底。-- 审批节点表的核心字段根据源码结构推断 CREATE TABLE OA_ApprovalNode ( NodeId INT PRIMARY KEY IDENTITY, TemplateId INT NOT NULL, -- 关联审批模板 NodeName NVARCHAR(50), -- 节点名称如“部门经理审批” NodeOrder INT NOT NULL, -- 节点顺序从1开始 ApproverId INT, -- 指定审批人 ApproverRole NVARCHAR(50), -- 审批角色为空则用 ApproverId AllowEdit BIT DEFAULT 0, -- 是否允许修改表单 AllowAttach BIT DEFAULT 0 -- 是否允许上传附件 ); -- 查询某个模板的完整流程 SELECT * FROM OA_ApprovalNode WHERE TemplateId TemplateId ORDER BY NodeOrder ASC;参数TemplateId来自审批模板设定页面NodeOrder必须连续如果中间断号流程流转时可能找不到下一节点。我见过有人把NodeOrder设成 10、20、30结果代码里写的是NodeOrder 1直接卡死。所以配置完流程后最好手动跑一条测试审批从起草到归档走一遍看每个节点是否都能正常出现。3.2 起草审批与待我审批的查询逻辑“起草审批”页面负责新建审批单“待我审批”和“经我审批”是查询视图。源码里这两个查询的区别在于待我审批查的是当前节点审批人是我且状态为“待审批”的记录经我审批查的是我已经审批过的记录。实现上通常用EXISTS子查询或者联表查询。-- 待我审批当前节点审批人是我且审批单未归档 SELECT a.* FROM OA_Approval a INNER JOIN OA_ApprovalNode n ON a.CurrentNodeId n.NodeId WHERE n.ApproverId UserId AND a.Status 0 -- 0表示审批中 AND a.IsArchived 0; -- 经我审批我审批过的记录从审批日志表查 SELECT a.* FROM OA_Approval a INNER JOIN OA_ApprovalLog l ON a.ApprovalId l.ApprovalId WHERE l.ApproverId UserId AND l.Action Approve ORDER BY l.ActionTime DESC;这里的关键参数是Status和IsArchived。Status0表示审批中Status1表示已通过Status2表示已驳回。如果你在待我审批里看到已经归档的单子大概率是IsArchived条件没加或者归档时没更新Status。审批日志表OA_ApprovalLog是留痕的关键每次审批动作都要写一条记录包括审批人、时间、意见、动作类型。少了这张表后面“审批监控”和“审批档案中心”就没法做。3.3 审批监控与档案中心的实现要点审批监控是给管理员看的能看到所有进行中的审批单和当前节点。档案中心是已归档的审批单查询。这两个模块的查询逻辑跟待我审批类似但权限控制不同。监控通常要求管理员角色档案中心可能按部门或者时间范围过滤。源码里大概率用角色判断来做权限比如if (CurrentUser.Role ! Admin) Response.Redirect(~/NoPermission.aspx);。这种硬编码的角色名在二次开发时很容易翻车——你改了角色名或者加了新角色忘了同步改判断条件结果要么谁都进不去要么谁都能进。我一般会把角色判断抽成一个方法HasPermission(ApprovalMonitor)里面查权限表而不是写死字符串。// 权限判断的推荐写法 public static bool HasPermission(string permissionCode) { if (CurrentUser null) return false; // 从缓存或数据库查当前用户的权限列表 Liststring permissions PermissionManager.GetPermissions(CurrentUser.UserId); return permissions.Contains(permissionCode); } // 页面调用 if (!HasPermission(ApprovalMonitor)) { Response.Redirect(~/NoPermission.aspx); return; }这样改的好处是加权限只需要在权限表里加一条记录不用改代码。参数permissionCode建议用常量类管理避免拼写错误。4. 公文模板与在线编辑DsoFramer 和 CKEditor 的配合方式4.1 DsoFramer 在线编辑的配置与留痕机制DsoFramer 是一个 ActiveX 控件用来在 IE 里嵌入 Office 文档进行在线编辑。源码里用它支持 Office 2003-2007 的在线编辑和修改留痕。配置的时候需要在客户端注册DsoFramer.ocx并且把站点加到 IE 的信任站点里否则控件加载不了。!-- DsoFramer 嵌入的典型写法 -- object idDsoFramer1 classidclsid:00460182-9E5E-11D5-B7C8-00010261A9C8 width100% height600 codebaseDsoFramer.cab#version1,0,0,1 param nameTitlebar valuefalse / param nameBorderStyle value0 / param nameMenubar valuefalse / param nameToolbars valuefalse / param nameVisible valuetrue / /object参数codebase指向 cab 包IE 会自动下载安装。但现在的浏览器基本都不支持 ActiveX 了所以这套在线编辑只能在 IE 或者基于 IE 内核的浏览器里跑。如果你要在 Chrome 里用得换方案比如用 WebOffice 或者 OnlyOffice 的在线编辑服务。修改留痕是 DsoFramer 自带的功能但需要 Office 开启修订模式并且保存时把修订记录一起存回服务器。源码里大概率是保存整个文档文件而不是只存文本所以数据库里对应的是varbinary(max)或者文件路径。4.2 CKEditor 与 CKFinder 的集成参数源码里用了ckeditor_aspnet_3.6.1和ckfinder_aspnet_2.2.1这两个是配套的富文本编辑器和文件管理器。CKEditor 负责编辑公文内容CKFinder 负责上传图片和附件。集成的时候注意版本匹配3.6.1 的 CKEditor 配 2.2.1 的 CKFinder 是官方推荐组合混用高版本可能报错。// CKEditor 配置示例根据源码还原 CKEDITOR.replace(txtContent, { height: 400, width: 100%, toolbar: [ [Source, -, Bold, Italic, Underline, Strike], [NumberedList, BulletedList, -, Outdent, Indent], [JustifyLeft, JustifyCenter, JustifyRight, JustifyBlock], [Link, Unlink, Image, Table, HorizontalRule], [Styles, Format, Font, FontSize], [TextColor, BGColor], [Maximize, ShowBlocks, -, About] ], filebrowserBrowseUrl: /ckfinder/ckfinder.html, filebrowserImageBrowseUrl: /ckfinder/ckfinder.html?typeImages, filebrowserUploadUrl: /ckfinder/core/connector/aspx/connector.aspx?commandQuickUploadtypeFiles, filebrowserImageUploadUrl: /ckfinder/core/connector/aspx/connector.aspx?commandQuickUploadtypeImages });关键参数是filebrowserBrowseUrl和filebrowserUploadUrl路径必须跟实际部署目录一致。如果你把 CKFinder 放在/ckfinder/下但配置里写的是/ckfinder2/上传就会 404。另外 CKFinder 的config.ascx里要设置CheckAuthentication返回 true否则上传会提示未授权。常见做法是判断Session[UserId]是否存在存在就返回 true。4.3 大文件上传与进度条的实现思路源码里提到“大文件上传加进度条显示”这在 ASP.NET 里通常用HttpModule或者HttpHandler配合XMLHttpRequest的upload.onprogress事件来实现。服务端分块接收客户端显示进度。如果你在源码里看到UploadProgress.ashx或者类似的 handler那就是干这个的。// 大文件分块上传的服务端处理简化示例 public class UploadHandler : IHttpHandler { public void ProcessRequest(HttpContext context) { context.Response.ContentType text/plain; string fileName context.Request[fileName]; int chunkIndex int.Parse(context.Request[chunkIndex]); int totalChunks int.Parse(context.Request[totalChunks]); // 保存分块到临时目录 string tempPath context.Server.MapPath(~/TempUploads/); if (!Directory.Exists(tempPath)) Directory.CreateDirectory(tempPath); string chunkFile Path.Combine(tempPath, fileName .part chunkIndex); context.Request.Files[0].SaveAs(chunkFile); // 如果是最后一块合并所有分块 if (chunkIndex totalChunks - 1) { string finalPath context.Server.MapPath(~/Uploads/ fileName); using (FileStream fs new FileStream(finalPath, FileMode.Create)) { for (int i 0; i totalChunks; i) { string partFile Path.Combine(tempPath, fileName .part i); byte[] bytes File.ReadAllBytes(partFile); fs.Write(bytes, 0, bytes.Length); File.Delete(partFile); } } context.Response.Write(OK); } else { context.Response.Write(ChunkReceived); } } public bool IsReusable { get { return false; } } }参数chunkIndex和totalChunks由前端计算并传递前端用File.slice切块用FormData逐块发送。进度条就是根据已发送的块数除以总块数来更新。注意web.config里的maxRequestLength要调大否则大文件在 IIS 层面就被拦了。默认是 4MB改成 100MB 或者更大同时executionTimeout也要相应调大。5. 避坑与排查这套源码跑起来最容易翻车的五个地方5.1 现象编译报错“找不到类型或命名空间”原因源码里引用了AjaxControlToolkit或者CKEditor的 DLL但你的项目里没加引用或者版本不对。解决打开web.config看assemblies节点里注册了哪些程序集去bin目录确认 DLL 是否存在。如果缺失从源码包的Lib或者packages目录里找对应的 DLL 加引用。常见做法是先用 NuGet 装AjaxControlToolkit再把版本对齐。5.2 现象审批流转到某个节点后卡住待我审批里看不到原因节点的ApproverId为空或者ApproverRole对应的角色下没有用户。解决查OA_ApprovalNode表确认当前节点的审批人配置。如果用的是角色查角色成员表看有没有人。我一般会在流程设置页面加一个校验保存节点时检查审批人或角色是否有效无效就弹提示不让保存。5.3 现象CKFinder 上传图片提示“未授权”原因ckfinder/config.ascx里的CheckAuthentication返回了 false或者 Session 丢失。解决打开config.ascx找到CheckAuthentication方法改成判断Session[UserId] ! null。如果还是不行检查web.config里的sessionState配置确保 Session 模式是InProc或者StateServer并且timeout够长。5.4 现象DsoFramer 控件加载后显示空白或者报“未注册类”原因客户端没有注册DsoFramer.ocx或者 IE 的安全设置阻止了 ActiveX。解决把站点加到 IE 的“受信任的站点”在“自定义级别”里启用“对未标记为可安全执行脚本的 ActiveX 控件初始化并执行脚本”。如果还是不行手动用regsvr32 DsoFramer.ocx注册。注意这个控件只支持 32 位 IE64 位 IE 下可能加载不了。5.5 现象大文件上传到一半失败进度条卡住原因web.config的maxRequestLength太小或者executionTimeout太短。解决在system.web节点下加httpRuntime maxRequestLength102400 executionTimeout600 /单位是 KB 和秒。如果用了 IIS 7还要在system.webServer下加securityrequestFilteringrequestLimits maxAllowedContentLength104857600 //requestFiltering/security单位是字节。两个地方都要改只改一个没用。6. 二次开发前值得先跑一遍的验证清单拿到这套源码别急着改代码。我一般会先花半天时间做一轮“最小验证”确认环境、数据库、核心流程都能跑通再动手加功能。下面这张表是我自己用的检查项你可以直接抄。检查项操作预期结果失败时看哪里数据库连接打开web.config看连接字符串能连上 SQL2005connectionStrings节点编译通过VS2008 里重新生成解决方案0 错误引用列表、App_Code登录用默认账号登录进入主界面用户表、登录页逻辑起草审批新建一条审批单保存成功状态为审批中OA_Approval表待我审批切换到审批人账号能看到刚起草的单子节点配置、查询 SQL审批通过点击通过按钮流转到下一节点或归档审批日志表、流程逻辑在线编辑打开公文模板DsoFramer 加载文档ActiveX 注册、IE 设置富文本上传在 CKEditor 里传图片图片显示路径正确CKFinder 配置、权限大文件上传传一个 50MB 文件进度条走完文件保存maxRequestLength、handler这张表里的每一项我都踩过坑。比如“待我审批”看不到单子十有八九是节点的ApproverId没配对在线编辑打不开基本都是 ActiveX 没注册。跑完这一轮你对整套系统的数据流和配置点就有底了。最后说一个我自己的习惯每次改完审批流程相关的代码我都会强制走一遍“起草 → 审批 → 归档”的完整链路哪怕只改了一个按钮的文字。因为审批流的坑往往不在你改的地方而在你没想到的关联表里。希望这套源码在你手里能跑出比原型更多的东西也希望这份拆解帮你少熬两个晚上。本文还有配套的精品资源点击获取
简介这份 ASP.NET 自动办公系统源码面向需要搭建企业 OA 与审批流的中高级 .NET 开发者基于 VS2008 与 SQL2005 环境采用经典三层架构可直接用于二次开发或教学参考。系统界面借鉴猫扑的标签式操作涵盖个人事务公司通知浏览与维护、日程安排、人员列表、审批流转起草审批、待我审批、经我审批、审批查询、审批监控、审批档案中心及审批类别、节点、模板、流程、归档等管理、内部邮件与系统设置等模块。源码集成大文件上传进度条、ckeditor 与 ckfinder 配合的公文模板设定、DsoFramer 在线编辑 Office 2003-2007 并支持修改留痕以及 IE 下 VML 画图模块技术点密集。压缩包共 2069 个文件以 js、gif、cs、html、aspx、css 等为主整体约 8.86MB目录结构完整。目前已有 1171 人学习下载适合研究审批流设计与富文本、在线编辑集成的开发者参考。1. 从一堆散落文件说起这套 ASP.NET 自动办公系统源码到底能跑出什么如果你手里拿到的是一个压缩包解压后看到all-wcprops、config.ascx、page.ascx、ckeditor.asp、events.asp、advanced.asp、replaceall.asp这些文件混在一起第一反应大概率是懵的——这到底是半成品还是完整工程我拆过不少 OA 类源码这套 ASP.NET 自动办公系统的结构其实很典型它把审批流、公文模板、在线编辑、大文件上传这些办公场景里最硬的需求都做进去了而且用的是三层架构前端界面参照猫扑那种标签式操作不是现在流行的 SPA 风格但胜在逻辑直白、改起来不绕。它适合谁如果你正在找一套能跑在 VS2008 SQL2005 环境下、带完整审批流转和公文留痕的 ASP.NET 源码用来做二次开发或者内部系统原型这套东西的参考价值比那些只有增删改查的 demo 高得多。尤其是审批节点、审批模板、归档设置这几块很多开源 OA 要么砍掉要么做得极简这套至少把流程配置的骨架搭全了。下面我按实际拆包和跑通的顺序把关键模块、配置参数和容易翻车的地方一条条过一遍。2. 三层架构与标签式界面这套 OA 的骨架怎么搭2.1 三层架构在源码里的实际落点三层架构这个词被说烂了但在这套源码里你能看到它具体怎么落地。表现层是.ascx用户控件和.aspx页面业务逻辑层集中在App_Code下的类文件里数据访问层通过 SQLHelper 或类似封装跟 SQL2005 打交道。你打开config.ascx会发现它承担了部分配置读取的职责而page.ascx更像是页面基类或者公共头部控件负责统一加载样式和脚本。这种结构的直接好处是改审批逻辑不用动页面改页面样式不用碰数据库。但坑也在这里——很多二次开发的人图省事直接在.ascx的Page_Load里写 SQL 查询三层就变成了两层半后面想换数据库或者加缓存就非常痛苦。我一般会先花半小时把App_Code里的类名和数据库表名对一遍画一张简单的映射表再动手改任何东西。// 典型的三层调用示例根据源码结构还原 // 表现层ApprovalList.ascx.cs protected void Page_Load(object sender, EventArgs e) { if (!IsPostBack) { // 调用业务逻辑层不直接写 SQL DataTable dt ApprovalManager.GetPendingList(CurrentUserId); rptList.DataSource dt; rptList.DataBind(); } } // 业务逻辑层ApprovalManager.cs public static DataTable GetPendingList(int userId) { // 参数校验和业务规则在这里 if (userId 0) throw new ArgumentException(用户ID无效); return ApprovalDAL.GetPendingByUser(userId); } // 数据访问层ApprovalDAL.cs public static DataTable GetPendingByUser(int userId) { string sql SELECT * FROM OA_Approval WHERE ApproverIdUserId AND Status0; SqlParameter[] paras { new SqlParameter(UserId, userId) }; return SqlHelper.ExecuteDataTable(sql, paras); }上面这段代码的关键在于表现层只负责绑定业务层做校验数据层只拼 SQL 和参数。参数UserId必须用 SqlParameter 传不要用字符串拼接否则 SQL 注入是迟早的事。如果你在源码里看到WHERE ApproverId userId这种写法建议优先改掉这是后面所有安全问题的源头。2.2 标签式界面的实现方式与改造边界界面参照猫扑的标签式操作实际实现大概率是用MultiView或者divdisplay切换来做的。你打开page.ascx会看到一组标签按钮点击后切换下方内容区域。这种做法的好处是页面不刷新、体验接近桌面软件坏处是 ViewState 会变大而且所有标签的内容都在同一个页面生命周期里某个标签出错可能影响整页。改造的时候注意两点第一标签切换的 JavaScript 函数名和控件 ID 是硬绑定的你改控件 ID 就要同步改 JS否则点击没反应第二如果要在标签里嵌 iframe 加载审批表单注意 IE 下 iframe 的src切换会导致历史记录混乱常见做法是用window.location.hash做简单路由或者干脆用Response.Redirect换页。我一般会保留标签结构但把每个标签的内容做成独立的用户控件这样编译和调试都清爽很多。// 标签切换的典型实现根据 page.ascx 还原 function switchTab(tabId) { // 隐藏所有内容区 var contents document.getElementsByClassName(tab-content); for (var i 0; i contents.length; i) { contents[i].style.display none; } // 显示目标内容区 var target document.getElementById(tabId); if (target) { target.style.display block; } // 更新标签按钮样式 var tabs document.getElementsByClassName(tab-btn); for (var j 0; j tabs.length; j) { tabs[j].className tabs[j].className.replace( active, ); } document.getElementById(btn_ tabId).className active; }这段 JS 里tabId的命名规则要和后台生成的 HTML 一致否则getElementById拿不到元素。如果你在 IE8 下测试getElementsByClassName是不支持的需要换成document.all或者引入兼容脚本。这也是这套源码跑在旧环境下的一个典型坑。3. 审批流转模块从起草到归档的完整链路怎么配3.1 审批节点与流程设置的数据库映射审批流转是这套系统的核心源码里对应的表大概有OA_Approval审批主表、OA_ApprovalNode审批节点表、OA_ApprovalTemplate审批模板表、OA_ApprovalCategory审批类别表。你打开审批管理下的“审批节点”和“审批流程设置”实际上是在操作这几张表。流程设置的本质是一条审批记录从起草人开始经过若干个节点每个节点指定审批人或者角色审批人通过后流转到下一节点直到归档。源码里大概率用NodeOrder字段控制顺序用NextNodeId或者直接按NodeOrder递增来找下一个节点。配置的时候注意如果某个节点的审批人离职或者角色为空流程会卡住所以最好在业务层加一个默认审批人兜底。-- 审批节点表的核心字段根据源码结构推断 CREATE TABLE OA_ApprovalNode ( NodeId INT PRIMARY KEY IDENTITY, TemplateId INT NOT NULL, -- 关联审批模板 NodeName NVARCHAR(50), -- 节点名称如“部门经理审批” NodeOrder INT NOT NULL, -- 节点顺序从1开始 ApproverId INT, -- 指定审批人 ApproverRole NVARCHAR(50), -- 审批角色为空则用 ApproverId AllowEdit BIT DEFAULT 0, -- 是否允许修改表单 AllowAttach BIT DEFAULT 0 -- 是否允许上传附件 ); -- 查询某个模板的完整流程 SELECT * FROM OA_ApprovalNode WHERE TemplateId TemplateId ORDER BY NodeOrder ASC;参数TemplateId来自审批模板设定页面NodeOrder必须连续如果中间断号流程流转时可能找不到下一节点。我见过有人把NodeOrder设成 10、20、30结果代码里写的是NodeOrder 1直接卡死。所以配置完流程后最好手动跑一条测试审批从起草到归档走一遍看每个节点是否都能正常出现。3.2 起草审批与待我审批的查询逻辑“起草审批”页面负责新建审批单“待我审批”和“经我审批”是查询视图。源码里这两个查询的区别在于待我审批查的是当前节点审批人是我且状态为“待审批”的记录经我审批查的是我已经审批过的记录。实现上通常用EXISTS子查询或者联表查询。-- 待我审批当前节点审批人是我且审批单未归档 SELECT a.* FROM OA_Approval a INNER JOIN OA_ApprovalNode n ON a.CurrentNodeId n.NodeId WHERE n.ApproverId UserId AND a.Status 0 -- 0表示审批中 AND a.IsArchived 0; -- 经我审批我审批过的记录从审批日志表查 SELECT a.* FROM OA_Approval a INNER JOIN OA_ApprovalLog l ON a.ApprovalId l.ApprovalId WHERE l.ApproverId UserId AND l.Action Approve ORDER BY l.ActionTime DESC;这里的关键参数是Status和IsArchived。Status0表示审批中Status1表示已通过Status2表示已驳回。如果你在待我审批里看到已经归档的单子大概率是IsArchived条件没加或者归档时没更新Status。审批日志表OA_ApprovalLog是留痕的关键每次审批动作都要写一条记录包括审批人、时间、意见、动作类型。少了这张表后面“审批监控”和“审批档案中心”就没法做。3.3 审批监控与档案中心的实现要点审批监控是给管理员看的能看到所有进行中的审批单和当前节点。档案中心是已归档的审批单查询。这两个模块的查询逻辑跟待我审批类似但权限控制不同。监控通常要求管理员角色档案中心可能按部门或者时间范围过滤。源码里大概率用角色判断来做权限比如if (CurrentUser.Role ! Admin) Response.Redirect(~/NoPermission.aspx);。这种硬编码的角色名在二次开发时很容易翻车——你改了角色名或者加了新角色忘了同步改判断条件结果要么谁都进不去要么谁都能进。我一般会把角色判断抽成一个方法HasPermission(ApprovalMonitor)里面查权限表而不是写死字符串。// 权限判断的推荐写法 public static bool HasPermission(string permissionCode) { if (CurrentUser null) return false; // 从缓存或数据库查当前用户的权限列表 Liststring permissions PermissionManager.GetPermissions(CurrentUser.UserId); return permissions.Contains(permissionCode); } // 页面调用 if (!HasPermission(ApprovalMonitor)) { Response.Redirect(~/NoPermission.aspx); return; }这样改的好处是加权限只需要在权限表里加一条记录不用改代码。参数permissionCode建议用常量类管理避免拼写错误。4. 公文模板与在线编辑DsoFramer 和 CKEditor 的配合方式4.1 DsoFramer 在线编辑的配置与留痕机制DsoFramer 是一个 ActiveX 控件用来在 IE 里嵌入 Office 文档进行在线编辑。源码里用它支持 Office 2003-2007 的在线编辑和修改留痕。配置的时候需要在客户端注册DsoFramer.ocx并且把站点加到 IE 的信任站点里否则控件加载不了。!-- DsoFramer 嵌入的典型写法 -- object idDsoFramer1 classidclsid:00460182-9E5E-11D5-B7C8-00010261A9C8 width100% height600 codebaseDsoFramer.cab#version1,0,0,1 param nameTitlebar valuefalse / param nameBorderStyle value0 / param nameMenubar valuefalse / param nameToolbars valuefalse / param nameVisible valuetrue / /object参数codebase指向 cab 包IE 会自动下载安装。但现在的浏览器基本都不支持 ActiveX 了所以这套在线编辑只能在 IE 或者基于 IE 内核的浏览器里跑。如果你要在 Chrome 里用得换方案比如用 WebOffice 或者 OnlyOffice 的在线编辑服务。修改留痕是 DsoFramer 自带的功能但需要 Office 开启修订模式并且保存时把修订记录一起存回服务器。源码里大概率是保存整个文档文件而不是只存文本所以数据库里对应的是varbinary(max)或者文件路径。4.2 CKEditor 与 CKFinder 的集成参数源码里用了ckeditor_aspnet_3.6.1和ckfinder_aspnet_2.2.1这两个是配套的富文本编辑器和文件管理器。CKEditor 负责编辑公文内容CKFinder 负责上传图片和附件。集成的时候注意版本匹配3.6.1 的 CKEditor 配 2.2.1 的 CKFinder 是官方推荐组合混用高版本可能报错。// CKEditor 配置示例根据源码还原 CKEDITOR.replace(txtContent, { height: 400, width: 100%, toolbar: [ [Source, -, Bold, Italic, Underline, Strike], [NumberedList, BulletedList, -, Outdent, Indent], [JustifyLeft, JustifyCenter, JustifyRight, JustifyBlock], [Link, Unlink, Image, Table, HorizontalRule], [Styles, Format, Font, FontSize], [TextColor, BGColor], [Maximize, ShowBlocks, -, About] ], filebrowserBrowseUrl: /ckfinder/ckfinder.html, filebrowserImageBrowseUrl: /ckfinder/ckfinder.html?typeImages, filebrowserUploadUrl: /ckfinder/core/connector/aspx/connector.aspx?commandQuickUploadtypeFiles, filebrowserImageUploadUrl: /ckfinder/core/connector/aspx/connector.aspx?commandQuickUploadtypeImages });关键参数是filebrowserBrowseUrl和filebrowserUploadUrl路径必须跟实际部署目录一致。如果你把 CKFinder 放在/ckfinder/下但配置里写的是/ckfinder2/上传就会 404。另外 CKFinder 的config.ascx里要设置CheckAuthentication返回 true否则上传会提示未授权。常见做法是判断Session[UserId]是否存在存在就返回 true。4.3 大文件上传与进度条的实现思路源码里提到“大文件上传加进度条显示”这在 ASP.NET 里通常用HttpModule或者HttpHandler配合XMLHttpRequest的upload.onprogress事件来实现。服务端分块接收客户端显示进度。如果你在源码里看到UploadProgress.ashx或者类似的 handler那就是干这个的。// 大文件分块上传的服务端处理简化示例 public class UploadHandler : IHttpHandler { public void ProcessRequest(HttpContext context) { context.Response.ContentType text/plain; string fileName context.Request[fileName]; int chunkIndex int.Parse(context.Request[chunkIndex]); int totalChunks int.Parse(context.Request[totalChunks]); // 保存分块到临时目录 string tempPath context.Server.MapPath(~/TempUploads/); if (!Directory.Exists(tempPath)) Directory.CreateDirectory(tempPath); string chunkFile Path.Combine(tempPath, fileName .part chunkIndex); context.Request.Files[0].SaveAs(chunkFile); // 如果是最后一块合并所有分块 if (chunkIndex totalChunks - 1) { string finalPath context.Server.MapPath(~/Uploads/ fileName); using (FileStream fs new FileStream(finalPath, FileMode.Create)) { for (int i 0; i totalChunks; i) { string partFile Path.Combine(tempPath, fileName .part i); byte[] bytes File.ReadAllBytes(partFile); fs.Write(bytes, 0, bytes.Length); File.Delete(partFile); } } context.Response.Write(OK); } else { context.Response.Write(ChunkReceived); } } public bool IsReusable { get { return false; } } }参数chunkIndex和totalChunks由前端计算并传递前端用File.slice切块用FormData逐块发送。进度条就是根据已发送的块数除以总块数来更新。注意web.config里的maxRequestLength要调大否则大文件在 IIS 层面就被拦了。默认是 4MB改成 100MB 或者更大同时executionTimeout也要相应调大。5. 避坑与排查这套源码跑起来最容易翻车的五个地方5.1 现象编译报错“找不到类型或命名空间”原因源码里引用了AjaxControlToolkit或者CKEditor的 DLL但你的项目里没加引用或者版本不对。解决打开web.config看assemblies节点里注册了哪些程序集去bin目录确认 DLL 是否存在。如果缺失从源码包的Lib或者packages目录里找对应的 DLL 加引用。常见做法是先用 NuGet 装AjaxControlToolkit再把版本对齐。5.2 现象审批流转到某个节点后卡住待我审批里看不到原因节点的ApproverId为空或者ApproverRole对应的角色下没有用户。解决查OA_ApprovalNode表确认当前节点的审批人配置。如果用的是角色查角色成员表看有没有人。我一般会在流程设置页面加一个校验保存节点时检查审批人或角色是否有效无效就弹提示不让保存。5.3 现象CKFinder 上传图片提示“未授权”原因ckfinder/config.ascx里的CheckAuthentication返回了 false或者 Session 丢失。解决打开config.ascx找到CheckAuthentication方法改成判断Session[UserId] ! null。如果还是不行检查web.config里的sessionState配置确保 Session 模式是InProc或者StateServer并且timeout够长。5.4 现象DsoFramer 控件加载后显示空白或者报“未注册类”原因客户端没有注册DsoFramer.ocx或者 IE 的安全设置阻止了 ActiveX。解决把站点加到 IE 的“受信任的站点”在“自定义级别”里启用“对未标记为可安全执行脚本的 ActiveX 控件初始化并执行脚本”。如果还是不行手动用regsvr32 DsoFramer.ocx注册。注意这个控件只支持 32 位 IE64 位 IE 下可能加载不了。5.5 现象大文件上传到一半失败进度条卡住原因web.config的maxRequestLength太小或者executionTimeout太短。解决在system.web节点下加httpRuntime maxRequestLength102400 executionTimeout600 /单位是 KB 和秒。如果用了 IIS 7还要在system.webServer下加securityrequestFilteringrequestLimits maxAllowedContentLength104857600 //requestFiltering/security单位是字节。两个地方都要改只改一个没用。6. 二次开发前值得先跑一遍的验证清单拿到这套源码别急着改代码。我一般会先花半天时间做一轮“最小验证”确认环境、数据库、核心流程都能跑通再动手加功能。下面这张表是我自己用的检查项你可以直接抄。检查项操作预期结果失败时看哪里数据库连接打开web.config看连接字符串能连上 SQL2005connectionStrings节点编译通过VS2008 里重新生成解决方案0 错误引用列表、App_Code登录用默认账号登录进入主界面用户表、登录页逻辑起草审批新建一条审批单保存成功状态为审批中OA_Approval表待我审批切换到审批人账号能看到刚起草的单子节点配置、查询 SQL审批通过点击通过按钮流转到下一节点或归档审批日志表、流程逻辑在线编辑打开公文模板DsoFramer 加载文档ActiveX 注册、IE 设置富文本上传在 CKEditor 里传图片图片显示路径正确CKFinder 配置、权限大文件上传传一个 50MB 文件进度条走完文件保存maxRequestLength、handler这张表里的每一项我都踩过坑。比如“待我审批”看不到单子十有八九是节点的ApproverId没配对在线编辑打不开基本都是 ActiveX 没注册。跑完这一轮你对整套系统的数据流和配置点就有底了。最后说一个我自己的习惯每次改完审批流程相关的代码我都会强制走一遍“起草 → 审批 → 归档”的完整链路哪怕只改了一个按钮的文字。因为审批流的坑往往不在你改的地方而在你没想到的关联表里。希望这套源码在你手里能跑出比原型更多的东西也希望这份拆解帮你少熬两个晚上。本文还有配套的精品资源点击获取
