**PageOffice版本：V6.6.1.3版本**

- [查看本示例演示效果（Windows版）](https://www.bilibili.com/video/BV1M34y1A7qL?p=11)
- [查看本示例演示效果（国产版）](https://www.bilibili.com/video/BV1eM4m167Lc?p=11)
- 本示例关键代码的编写位置，请参考“开始 - 快速上手”里您所使用的开发语言框架的最简集成代码

> 注意
> 本文中展示的代码均为关键代码，复制粘贴到您的项目中，按照实际的情况，例如文档路径，用户名等做适当修改即可使用。

Word中的“痕迹”功能可以跟踪文档中所做的更改。痕迹可以包括添加、删除、移动和格式更改等。Word提供了“痕迹保留”功能，可以保留这些痕迹并在文档中显示出来。痕迹保留对于多人协作编辑同一份文档时非常有用，可以清楚地了解每个人对文档所做的修改。同时，痕迹保留也可以用于审阅和修改文档，帮助用户更轻松地进行修改和校对工作。用户可以通过“审阅”选项卡中的“修订”按钮来开启和关闭痕迹保留功能。
既然Word中的痕迹保留功能已经可以满足多人协作编辑同一份文档的需求，那为什么还需要强制留痕功能呢？原因主要有以下两点：
- 很多普通用户不清楚留痕功能如何使用，不知道点击“审阅”选项卡中的“修订”按钮就可以开启留痕功能；
- 部分的用户知道留痕功能，但是不愿意使用，故意关闭“审阅”选项卡中的“修订”状态；
- 用户可以随意修改和处理其他人的痕迹，不受系统控制；

PageOffice通过封装Office的API，实现了强制留痕模式，PageOfficeCtrl对象webOpen方法的第二个参数使用`docRevisionOnly`就是强制留痕模式，在这种模式下，用户对文档做的任何修订都会被记录下来，无需用户手动开启留痕功能，并且用户也不能关闭留痕功能。不同用户对文档做的修订会自动使用不同的颜色标记。用户不能接受、拒绝或删除其他用户对此文档所做的任何修订。修订记录能够显示修订者的名字，修订时间及修订内容。痕迹所显示的用户名就是webOpen方法第三个参数所传递的用户名，一般使用真实的用户名，比如“张三”，不要用“zhangsan”这样的登录名。
由于强制留痕模式下用户不能接受、拒绝或删除其他用户对此文档所做的任何修订，所以经过多人审阅后的Word文档，需要进行核稿处理，清理文档中用户编辑过的所有痕迹。此时，可以使用PageOffice提供的核稿模式，PageOfficeCtrl对象的webOpen方法的第二个参数使用docAdmin，打开文档即可进入核稿模式，此时在痕迹上点右键，右键菜单中的“接受修订”、“拒绝修订”、“接受删除”、“拒绝删除”等项就都是可用状态了，核稿人员就可以根据文档中各用户的意见，对文档做修改并清除文件中的所有痕迹，整理为可发布的正式文件。有些办公系统需要将用户留痕审阅过的文件归档保存，以便后期查阅。因此开发人员可以编写程序，在进入核稿环节时，自动备份留痕文档。
### 后端代码

在后端编写代码调用webOpen方法以强制留痕模式打开文件。

```
PageOfficeCtrl poCtrl = new PageOfficeCtrl(request);
//webOpen的第一个参数支持能够输出下载文件的Url相对地址或者文件在服务器上的磁盘路径两种方式
//查看详细，请在本站搜索“PageOffice属性或方法中涉及到的URL路径或磁盘路径的说明”
poCtrl.webOpen("D:\\documents\\test.docx", OpenModeType.docRevisionOnly, "张三");
```
### 前端代码

1. 在OnPageOfficeCtrlInit事件中添加隐藏和显示痕迹的按钮（根据实际业务需求处理即可）；

```
OnPageOfficeCtrlInit() {
  pageofficectrl.AddCustomToolButton("隐藏痕迹", "hideRevision", 18);
  pageofficectrl.AddCustomToolButton("显示痕迹", "showRevision", 9);
},
```
2. 实现自定义按钮所调用的js函数；

```
function showRevision() {
    pageofficectrl.ShowRevisions = true;
}
function hideRevision() {
    pageofficectrl.ShowRevisions = false;
}
```
参考链接：[强制留痕模式编辑 | PageOffice 开发者中心](https://pageoffice.cn/pages/0605b8/)


本示例关键代码的编写位置，请参考“开始 - 快速上手”里您所使用的开发语言框架的最简集成代码

PageOffice V6.6.1.3 强制留痕模式打开编辑 Word 文件

开发工具

后端

PageOffice V6.6.1.3提供Word强制留痕功能，通过docRevisionOnly模式自动跟踪用户修订，无需手动开启且不可关闭，支持不同用户颜色区分及修订记录显示。核稿时使用docAdmin模式可接受或拒绝修订并清理痕迹，便于归档和发布正式文件。

代码解释

服务器

Windows

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

PageOffice V6.6.1.3 强制留痕模式打开编辑 Word 文件-腾讯云开发者社区-腾讯云

PageOffice V6.6.1.3 强制留痕模式打开编辑 Word 文件

PageOffice V6.6.1.3 强制留痕模式打开编辑 Word 文件

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐