强制留痕模式编辑
# 强制留痕模式编辑
- 查看本示例演示效果（Windows版）
- 查看本示例演示效果（国产版）
- 本示例关键代码的编写位置，请参考“开始 - 快速上手”里您所使用的开发语言框架的最简集成代码
注意
本文中展示的代码均为关键代码，复制粘贴到您的项目中，按照实际的情况，例如文档路径，用户名等做适当修改即可使用。
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, "张三");
PageOfficeNetCore.PageOfficeCtrl poCtrl = new PageOfficeNetCore.PageOfficeCtrl(Request);
poCtrl.WebOpen("D:\\documents\\test.docx", PageOfficeNetCore.OpenModeType.docRevisionOnly, "tom");
// Make sure to add code blocks to your code group
# 前端代码
- 在OnPageOfficeCtrlInit事件中添加隐藏和显示痕迹的按钮（根据实际业务需求处理即可）；
OnPageOfficeCtrlInit() {
pageofficectrl.AddCustomToolButton("隐藏痕迹", "hideRevision", 18);
pageofficectrl.AddCustomToolButton("显示痕迹", "showRevision", 9);
},
// Make sure to add code blocks to your code group
- 实现自定义按钮所调用的js函数；
function showRevision() {
pageofficectrl.ShowRevisions = true;
}
function hideRevision() {
pageofficectrl.ShowRevisions = false;
}
// Make sure to add code blocks to your code group