信创环境下OA文档控件技术选型方案对比
在国产 OA 的开发与实施中,文档编辑往往是返工较集中的一个环节。问题通常不出在产品本身,而是选型时没有先把约束写清楚:公文打印必须与本地 WPS 一致、文档不能出内网、一套代码要同时覆盖 Windows 与国产终端。这三条一旦成为验收项,可选的路线会迅速收窄。
本文按“约束—对象—路线—实施—验收”的顺序,把目前市面上的四条技术路线的原理、能力和代价拆开对比,并给出实施阶段容易忽略的几个点。
一、三条约束,决定了可选范围
信创 OA 的文档编辑需求,表面上都是“在网页里打开并修改文件”,但真正决定选型的,是下面三条验收约束。
第一,打印结果必须与本地 WPS 一致。 公文要盖章、归档、外发,版式差一行都算事故。网页渲染路线在页边距、表格线粗细、版记位置上容易出现差异,套打单据对偏移更敏感。这一条不是“体验优化”,而是能不能交付的问题。
第二,文档不能出内网。 内网与公网物理隔离时,任何需要把文件上传到第三方服务器完成转换、存储的方案都不可行。私有化部署可以解决“不出网”,但服务端资源与运维成本要一并计入。
第三,一套代码覆盖 Windows 与国产终端。 双轨过渡期里,同一套 OA 既要在 Windows 上跑,也要在国产终端上跑。如果服务端接口或前端调用按平台分叉,维护成本会随终端类型线性增加。
约束写清楚,后面才有比较的基准。约束模糊时,功能清单越长,选型会越难收敛。
二、“在线编辑”对应三件事
OA 里被笼统称为“在线编辑”的功能,实际对应三种对象,权重差别很大:
- 编辑 docx 正文:起草、会签、修改、定稿。这是公文系统的主战场,要求编辑能力与版式保真。
- 处理版式文件:盖章、下发、归档,以及归档之后的阅读。这是定稿后的必经环节,但不属于编辑。
- 采集结构化数据:审批单、登记表、报表。要求字段准确、流程可追溯。
三件事对应三种工具,彼此不能替代。常见的误判有两种:拿 OFD 阅读器的演示去套正文编辑的需求,得出“不能用”的结论;或者用表单工具承接公文,上线后一打印就露馅。把对象拆开、把权重写清楚,讨论才不至于跑偏。
三、四条技术路线
按“文档在哪里被打开、由谁渲染”来分,市面上的方案大致是四条路线:
| 路线 | 编辑内核 | 版式与打印 | 客户端 | 协同 | 适用与边界 |
|---|---|---|---|---|---|
| 本地办公内核(控件/中间件) | 终端本地 WPS | 与 WPS 一致 | 需安装 | 中 | 公文正文、合同、套红留痕;要求版式与打印一致 |
| 私有化云文档引擎 | 服务端引擎 | 取决于引擎还原能力 | 无 | 强 | 协同、移动、轻编辑;版式要求不苛刻 |
| 版式文件 | OFD / PDF | 版式固定 | 阅读器或网页 | 弱 | 定稿、盖章、归档、证照 |
| 轻量表单与前端预览 | 字段 / HTML | 不保真原文档 | 无 | 弱 | 表单采集、只读预览 |
四条路线没有天然的优劣,差别在于和约束的匹配度。下面逐条说明原理与代价。
四、云文档引擎:能力与代价
这条路线把文档处理放到服务端:引擎负责解析、转码、渲染与协同,浏览器用 HTML5 呈现结果。代表产品是金山办公的 WPS 365 私有化版本,以及开源的 OnlyOffice——后者的官方文档给出了在麒麟操作系统上以 Docker 部署的方法。
它的优势很明确:零客户端,终端不用装任何东西;天然支持多人同时编辑、评论与提醒;移动端体验完整;版本与模板集中在服务端,运维不碰终端。对以协同为核心的办公场景,这条路线更顺。
但这条路线真正的门槛,一半在技术,一半在运维,后者在选型阶段往往被低估。代价分两类看。
4.1 技术与合规
版式还原。 复杂公文、套打单据、红头版式在引擎里能否 1:1 还原,打印结果是否与本地 WPS 一致,只能拿真实文件逐份比对。评估时建议直接用三类文件:一份红头通知、一份带复杂表格的请示、一份套打单据;比对项包括页边距、表格线粗细、版记位置与套打偏移,而不是只看“能不能显示”。
服务端资源。 转码、渲染、协同会话都要消耗 CPU 与内存。信创服务器上的并发容量必须实测,不能把 x86 环境的经验直接折算过去。
数据边界。 私有化部署可以做到不出内网;但如果采用公有云版本,公文要上传到第三方服务器完成转换与存储,与“数据不出域”的要求直接冲突。选型时要把“私有化”写进合同,而不是停留在口头。
4.2 部署与运维
组件多,链路长。 一套可用的私有化文档服务,通常包含转换与渲染服务、对象存储、缓存、数据库、消息队列、网关等组件,还要与 OA 对接鉴权、回调、文件地址与证书;部署到信创服务器上,又叠加国产操作系统与芯片的依赖适配、公文字体与打印链路。组件越多,故障点越多,一个问题往往要在多个服务之间来回定位。
WPS 365 私有化依赖原厂。 这类产品的实施、版本升级与故障处理,通常需要原厂技术人员介入:升级涉及数据迁移与接口变更,容量调整涉及集群参数,通常需要原厂实施与运维支持。选型时不能只算软件授权,还要把原厂服务、响应级别与升级窗口写进合同。
OnlyOffice 免费,但运维不免费。 社区版不收授权费,Docker 部署看起来也简单,但生产环境同样绕不开数据库、缓存、消息队列、JWT 鉴权、回调地址与中文字体配置。出问题时,需要有人能看日志、理清组件依赖、判断故障在引擎还是集成层;社区版没有原厂 SLA,排障周期取决于团队经验。省下的授权费,往往会以人力成本补回去。
升级不是换镜像。 文档引擎的版本升级往往牵动接口、数据与客户端缓存,停机窗口、回退方案、与 OA 的联调都要提前排。信创环境里这一点更明显:国产系统与芯片的组合多,厂商的验证矩阵不一定覆盖现场环境,升级前通常要自己在测试环境跑一遍。
公平地说,如果协同需求更重、版式要求更低,这条路线更省事——零客户端、集中运维都是实际的好处;它的问题不是能力不足,而是与高版式要求、强内网约束的组合不匹配。前提是运维模式在选型阶段就定下来:要么买原厂服务,要么有能接住这套系统的团队。否则,省下的客户端安装工作,会变成服务端的长期投入。
五、版式文件与轻量表单:定位与边界
版式文件这条线围绕 OFD 与 PDF 展开,代表厂商是数科、福昕、书生等。数科官网列出的支持范围里,国产 CPU 覆盖龙芯、兆芯、飞腾、鲲鹏、海光、申威等,操作系统覆盖银河麒麟、统信 UOS、中科方德。
它的定位是“定稿之后的文档”:版式固定、签章可验、批注与手写签批成熟,适合公文下发、归档、证照、电子发票。党政机关的电子公文交换与归档普遍采用 OFD,因此这类产品在 OA 里几乎是必配项。
但要认清边界:OFD 是“印出来的样子”,不是“可以继续改的稿子”。定稿之前的起草、会签、修改,仍然需要编辑器。选型时要问的是三个问题:OFD 标准符合性如何、签章能否与上级单位互认、网页阅读要不要装插件。
轻量表单与前端预览(表单设计器、docx-preview 一类)同样有明确位置:审批单的字段采集、移动端“看一眼”的预览。它不保真原文档,复杂排版、修订痕迹、盖章套红都做不了,不能放进正文编辑那一格。
六、本地内核路线:原理与能力
6.1 客户端控件/中间件形态
这条路线是把终端上的 WPS 调起来,网页里改的是 .docx 文件本身。以 PageOffice 国产版为例,一次在线编辑可以拆成四步:
- 页面调用:OA 页面通过 JS 调起 PageOffice 客户端;
- 取文件:客户端向 OA 服务端请求文件,把文档取到本地内存;
- 起内核:客户端启动终端上安装的 WPS,把文档交给 WPS 打开;
- 融合呈现:客户端本身内嵌 Chromium 内核,页面与 WPS 窗口在同一个程序内融合,呈现为“嵌在网页里的 WPS 窗口”。
关键点在于:它没有把 docx 转成 HTML 再渲染,而是让 WPS 打开文件本身。版式、字体、行距、页码、表格线、页边距、红头版记全部由 WPS 计算,不需要在转换环节做补偿;套打偏移可以按打印机实测调整。
6.2 为什么不走浏览器插件
在 Windows 上,浏览器这一层要回答的是“装了哪个浏览器、什么版本”;到了国产终端,问题更靠下:文档控件以什么方式进入浏览器。
国产桌面浏览器基本都基于 Chromium,而 Chromium 从 45 版起停止支持 NPAPI,后续版本把相关代码从源码中移除。国产浏览器为兼容存量业务系统,又把这块能力补了回来,代价是每跟进一次内核升级,就要重新适配一轮。对厂商来说,选择只有两个:把内核冻结在某个版本,或者放弃 NPAPI。
对文档控件而言,把“能不能打开文档”押在宿主浏览器的插件接口上,越来越不划算——接口什么时候消失,项目无法预判,目前市面上的某些文档控件产品就存在这个风险。更稳妥的做法是让控件自带运行环境:由产品自己的窗口承载页面与控件,不再经过宿主浏览器的插件接口。PageOffice 6 走的就是这条路。浏览器怎么升级、是否保留 NPAPI,都不再是业务系统的风险项;前端仍是标准 Web 页面,调用的仍是原来那套 JS 接口,业务代码不用改。
6.3 公文控制能力
调用本地 WPS 只是基础,公文场景还需要在打开文档的那一刻施加控制。PageOffice 用四种打开模式区分场景:
| 打开模式 | 用途 | 控制点 |
|---|---|---|
docNormalEdit |
普通编辑 | 全文可编辑,适合起草 |
docSubmitForm |
表单 / 局部编辑 | 仅 PO_ 数据区域可编辑,其余只读 |
docRevisionOnly |
强制留痕 | 修订状态不可关闭,适合会签、核稿 |
docAdmin |
核稿 | 按核稿人权限处理修订 |
局部编辑靠的是 Word 里以 PO_ 开头的书签:模板里把“拟办意见”做成 PO_NiBan,用 docSubmitForm 模式打开,只对这一个区域调用 setEditing(true),其余部分保持只读。可编辑范围由服务端在打开文档之前下发,不依赖用户在使用中自觉。
同一套机制还支撑模板套红(openDataRegion / openDataTag 赋值,setValue("[word]子文档路径[/word]") 插入正文)、数据区域另存为子文档(setSubmitAsFile(true))、以及印章与手写签批。这些能力来自本地 WPS 与文档对象模型,不是网页上模拟出来的效果。
对集成商更实际的一点是:服务端只有一套代码。Windows 版与国产版的服务端被合并为一个组件(Java 平台是同一个 jar 包),接口完全相同,客户端封装的 JS 接口也几乎一致。业务系统里“打开、赋值、保存”的逻辑,不需要为两类终端写两个分支。
6.4 代价
要按平台分别授权。 Windows 版与国产版分开销售、分别注册,双轨期需要在同一个 SysPath 下同时放 license.lic 与 license_gc.lic。但技术方案与维护分支只有一套,省下的是长期适配人力。
交互形态要提前对齐。 文档在 PageOffice 自己的窗口中打开,不是嵌在宿主页面的 iframe 里。弹窗尺寸、关闭后回跳、与主页面的传值,要在方案阶段定下来。
七、选型时容易忽略、实施时集中暴露的四个点
这些点未必影响选哪条路线,却直接影响交付周期,建议在方案评审时就写进去。
1. 终端盘点要按“系统 × 芯片”两个维度。 只按芯片盘点,现场一定会遇到“同样是 ARM64 却装不上”的情况;两种系统都有时,两套安装包都要准备。
2. POC 必须用真实文件和真实打印机。 厂商样例文件排版规整,掩盖不了复杂表格、红头版记、套打偏移的问题。验收时至少覆盖通知、请示、批复、会议纪要四类公文。
3. 浏览器兼容性要按现场实际版本测。 国产浏览器的内核版本与升级节奏并不统一,同一套页面在不同单位的表现可能不同。POC 应覆盖现场在用的浏览器及版本,而不是只测一款最新的。
4. 厂商的业务连续性也是变量。 文档控件需要长期跟着操作系统、浏览器、WPS 的版本走。比如某文档控件厂商曾是 Windows 时代常见的选择,后来并入另一家做电子印章的公司后,业务重心转向电子签章。这类变化提示选型时要看版本更新记录与产品线投入,而不只是历史名气。
八、POC 验收清单
以下十项适合直接拿去开 POC,原则是:真实文件、真实打印机、真实终端、真实流程、真实权限。
- 打开:国产终端首次打开,客户端安装引导是否顺畅,是否需要管理员权限;
- 编辑:复杂表格、域、书签、图片、公式、文本框是否正常;
- 保存:保存回 OA 后文件是否完整,版本与流程是否对得上;
- 只读:能否禁止复制、另存、打印,禁止后是否真的拦得住;
- 局部编辑:非授权区域是否真的改不动,而不只是“看起来灰了”;
- 留痕:修订能否被用户关闭,能否被接受或拒绝,颜色与修订人是否正确;
- 套红与盖章:模板套红位置是否准确,印章位置与骑缝章是否可用;
- 打印:真实打印机、真实纸张、套打单据的偏移量是否可调;
- 升级:服务端升版后,客户端是否按版本号自动更新,而不是逐台重装;
- 回退:双轨期能否回退到上一版本,Windows 与国产终端能否并行。
九、结论:按场景组合,而不是单选
回到选型本身。如果 OA 的核心是公文、合同、红头文件,要求版式与打印和本地 WPS 一致,需要局部编辑、强制留痕、套红盖章,终端以桌面为主且允许安装客户端,本地内核路线是能同时满足这些条件的选项。PageOffice 国产版属于这一格:调用本地 WPS,支持统信 UOS、银河麒麟与 X86_64、ARM64、LoongArch64、MIPS64 四种架构;客户端自带 Chromium 内核,把 WPS 窗口嵌进页面;服务端一套代码覆盖 Windows 与国产两类终端。
如果核心是多人协同、移动审批、轻量编辑,版式要求不苛刻,私有化云引擎更合适;如果目标是定稿后的盖章、下发、归档,版式文件几乎必配;如果只是采集数据或只读预览,轻量表单足够。
多数项目的最终形态是组合:正文用本地内核编辑,定稿转 OFD 归档,审批单与移动端用轻量方案承接。三条链路各司其职,比让一个产品覆盖全部场景更稳妥。
浙公网安备 33010602011771号