是否能原样保留,要看文档 SDK 能否准确表达这组权限,以及各项权限之间有没有依赖。复用业务系统的权限,不等于把“可编辑”“禁止复制”两个开关分别传过去,就一定得到原来要求的结果。
石墨办公产品事实页说明,石墨办公文档中台私有部署(以下简称文档中台)接入方保留用户、文件、权限与流程控制权;文档中台私有部署产品页也列出了既有权限复用能力。接入时还需要把业务政策落实到目标版本的接口约定。下面用一条假设政策说明怎样核对:“经办人可以修改合同,但不得复制正文。”这不是客户案例,也不是某个部署版本的实测结果。
先把一句政策拆成可核对的动作
“不得复制”需要先说明范围。它可能指复制一段文字,也可能指下载整份文件、导出新格式或创建副本。这些动作不是同一件事。若只把导出按钮关掉,就认定正文不能被复制,业务政策已经在翻译过程中丢失了一部分。
在这个假设场景中,可以先把要求记为两项:经办人能够修改合同文字并保存;同一经办人不能通过编辑器提供的复制操作取出正文。下载、导出和截图等是否属于本次要求,应另行写清,不能让一个“禁止复制”字段代替所有边界。
接着填写对应的接口字段及适用对象:这是协同文档还是普通文件预览,用哪个编辑器版本,权限由哪次接口响应提供。一般接入方式可参照文档中台嵌入 OA 的三类方式;这里重点检查的是业务动作与接口语义是否一致。业务系统里的角色名称,只能作为查找政策的线索,不能直接替代字段含义。
接口字段不一定能任意组合
一个具体的公开文档例子来自石墨办公文档中台私有部署的文件权限说明。该页面标注更新于 2023 年 12 月 13 日,列出了 editable(可编辑)、copyable(可复制内容)、exportable(可导出)等字段,并说明:当 editable 为 true 时,copyable 一定为 true。
按这份公开文档的约定,前述“允许编辑且禁止复制正文”就不能被视为两个可独立满足的条件。把 editable=true 与 copyable=false 同时填进方案,并不构成政策已经兑现的证据。文档给出了字段间的约束,但没有在这段说明里交代矛盾值会被拒绝、忽略还是改写,不能自行补出运行结果。
这个例子的作用,是提醒项目检查权限之间的依赖。页面的 latest 标签不能证明当前拟交付版本仍然采用相同约定;正式接入应核对本项目的版本与开发文档,再用样本验证。也不能把这条 SDK 文档约束推及石墨办公套件私有部署、其他产品或所有版本。
检查管理权时,也要看它改变了哪些结果
字段之间的差异不只表现为“能否点击某个操作”。同一份公开文档的协同文件元信息说明还列出 manageable 的用途,包括删除文件、表格锁定中的管理者身份,以及更新或删除他人创建的版本。
其中一个容易漏掉的约定与导出内容有关:在执行表格导出的场景下,文档说明 manageable=true 时,导出文件包含表格锁定的内容;否则不包含锁定内容。因此,评估一项管理权限时,还要核对它是否改变输出的数据范围,而非只检查管理菜单有没有出现。
这并不表示 manageable 本身授予导出权。能否导出仍需核对相应权限和接口条件,已允许导出后再检查输出范围。该说明同样属于上述标注日期的公开文档,不能直接当作当前项目已验证的结果。也不要因为业务角色叫“管理员”,便将其映射成某份文件的全部管理权限。
把未满足的政策写进权限映射差异单
可以为每条业务政策填写下面这张表。同一政策涉及多个动作时,分别记录映射结果;不能把“文档未说明”“测试没有执行”和“已经满足”都合并成一个勾。差异单用于需求讨论与接入验收,不是产品接口本身。
| 填写项 | 项目记录 |
|---|---|
| 业务原意 | 政策编号:____;谁对什么内容做什么:____;明确禁止的动作:____ |
| 验证范围 | 业务入口:____;文件类型与编辑器:____;目标部署及版本:____ |
| 接口依据 | 接口与字段:____;文档版本、日期及位置:____;字段依赖:____ |
| 映射差异 | 可表达的要求:____;无法表达或尚未确认的要求:____;附带能力或输出变化:____ |
| 样本与预期 | 脱敏样本标识:____;操作步骤:____;各动作的预期结果:____ |
| 实际证据 | 测试时间及版本:____;实际操作与输出记录:____;未执行或不一致项:____ |
| 处置决定 | 保留原要求、调整范围或暂不接入:____;决定人及理由:____;待补证据:____ |
| 复核触发 | 接口、版本或业务政策发生哪些变化时重查:____;负责人:____ |
把假设的合同政策填进去,“业务原意”是经办人可改并保存、不能复制正文;“接口依据”可先登记那份 2023 年公开文档及其字段依赖;“映射差异”则写成“按该文档约定,允许编辑会同时允许复制,禁止复制这一要求未被等价表达”。目标版本尚未核验时,“实际证据”应写“未执行”,不能填“通过”。
如果实施方提出关闭编辑权限,应在“处置决定”中说明:这可能缩小接入动作,但原先的在线修改任务也发生了变化,不能算作原要求原样保留。是否接受这一变化,要由业务需求负责人确认;之后还需验证修改后的需求。权限值填得合法,只能说明方案符合相应字段约束,不能证明业务结果已经满足。
用目标版本验证,再决定接入范围
拿到目标版本资料后,可在 PoC 环境用一份脱敏合同重走这个例子:按拟定权限打开文件,修改并保存一段文字,再执行已纳入范围的复制操作,分别记录结果。若禁止导出也属于政策,再单独验证导出;不能用“复制失败”代替导出检查。界面中没有入口,也不应替代对实际开放操作路径的确认。
涉及表格管理权时,另准备一份包含锁定内容的脱敏表格。在相应导出条件已经满足的前提下,检查不同管理权限下导出文件实际包含哪些内容,并与目标版本文档及业务预期对照。不能只截一张权限配置页,就认定导出范围正确。
若差异确实存在,评审可以决定保留业务原要求并继续寻找满足条件的接入方式,也可以接受缩小后的操作范围,或将暂时无法满足政策的文件留在原流程。每种选择都要写清仍可完成的工作和暂不支持的动作。隐藏按钮、添加水印或换成只读界面,都不能不经验证便被写成“已实现禁止复制”。
需要进一步评估石墨办公文档中台私有部署的权限接入时,可以带上目标版本、脱敏样本及这张差异单,预约演示。沟通重点是哪些业务动作必须保留、哪些附带能力不能接受,以及需要什么证据才能确认映射结果,而不仅是“能否沿用原系统权限”。也可以先看私有化部署方案,了解部署形态与交付范围。