PageOffice常用功能之-OA系统中的文档在线编辑及流转

转载自：https://www.twblogs.net/a/5b92933f2b71772002d30b1d/zh-cn/

OA公文流转系统主要用于处理企业日常工作中内外部的各种公文，包括了公文的拟稿、审批、传阅、公告、归档，多层上级可以对下级撰写的公文进行逐级审批或修改，待最高级人员确认无误后即可进行核稿和发文等操作，最后在相关人员中传阅。根据文档在OA系统及其它办公系统的中的流转方式，PageOffice开发平台研发出了文档流转的各个环节对应的文件打开模式及相关实用功能，以便于更好地实现OA系统的需求。下面我们详细论述PageOffice在OA系统中的主要使用方式。

一.文档在OA系统中的简略流程

二.文档流转的各个环节的详细论述

注：PageOffice在文档流转过程中的使用效果请参考Samples示例的高级功能
三、3、在OA或文档系统里文件流转中的使用效果

1.起草文档：

一般文档流转的第一个环节就是起草文档，在此环节文员需要自由编辑文档而不用留下任何痕迹，所以PageOffice为了这个环节开发出来了文档的普通编辑模式(docNormalEdit)。在这个模式下文员可以自由编辑文档内容，并不会留下任何痕迹。

主要代码：

PageOfficeCtrl poCtrl1 = new PageOfficeCtrl(request);
…
poCtrl1.webOpen("doc/"+filePath, OpenModeType.docNormalEdit, userName);

2.领导批阅

一般文档流转的过程中各个阶层的领导都会对文员在第一步中起草的文档进行修改，添加批注等操作，这时对文档所做的任何修订都必须以痕迹的形式保留下来，以便于更高层的领导进行审核，所以PageOffice开发出来了文档的强制留痕模式（docRevisionOnly）。在这种模式下，用户对文档做的任何修订都会被记录下来；不同用户对文档做的修订会自动用不同的颜色标记； 用户不能接受、拒绝其他用户对此文档所做的任何修订；修订记录能够显示修订者的名字，修订时间及修订内容。

主要代码：

PageOfficeCtrl poCtrl1 = new PageOfficeCtrl(request);
……
poCtrl1.webOpen("doc/"+filePath, OpenModeType.docRevisionOnly, userName);

用户在这一环节主要用到的功能有：显示隐藏痕迹，领导圈阅，手写批注，分层显示手写批注，插入键盘批注等。开发人员可以通过添加自定义按钮触发js的方式来实现这些功能。

添加自定义工具栏按钮的方法如下：

//“显示/隐藏痕迹”为自定义按钮的名称，Show_HidRevisions为js的function方法名，5是按钮图标的索引

poCtrl1.addCustomToolButton("显示/隐藏痕迹", "Show_HideRevisions", 5);

pageoffice提供20个图标，开发人员可以从中任意选择合适的图标匹配该功能。详细请参考PageOffice的Samples示例：一、19、在PageOffice自定义工具条上添加一个按钮（以Word为例)

以上相关功能的js代码：
（1）显示隐藏痕迹：（痕迹一般指的是键盘批注和留痕模式用户删除或插入的文档内容，这些统称为痕迹，不包含手写批注）

document.getElementById("PageOfficeCtrl1").ShowRevisions = false|true;

（2）领导圈阅,手写批注：

document.getElementById("PageOfficeCtrl1").HandDraw.Start();

（3）分层显示手写批注：

document.getElementById("PageOfficeCtrl1").HandDraw.ShowLayerBar();

ShowLayerBar(): 显示“分层手写批注”工具栏，在工具栏上显示所有做过手写批注的批注者的用户名。点击指定的用户名，只显示该用户的手写批注，而隐藏其他用户的手写批注。也可以显示全部批注，或隐藏全部批注。

注：上述描述中的该用户指的是webOpen的第三个参数值.具体说明如下,
poCtrl1.webOpen("doc/"+filePath, OpenModeType.docRevisionOnly, userName);
webOpen中的第三个参数userName用来控制分层显示手写批注的用户名和痕迹提示框的用户名。pageoffice的并发控制机制也是用该参数区别是否不同用户打开文档的。一般来说，webOpen的第三个参数都会设置成当前登录系统的用户名。

（4）插入键盘批注：

document.getElementById("PageOfficeCtrl1").WordInsertComment();

（不同的用户的不同痕迹用不同的颜色来表示，颜色是系统默认分配的）

3.文员清稿

在这一环节，文员将对文档进行清稿工作，包括拒绝或者接受修订，清除文档的所有痕迹及手写内容（对文档进行电子签章的环节一般也是使用此模式打开文件的），所以这一环节将用到PageOffice的核稿模式（docAdmin），在这种模式下， 用户能够清理文档流转过程中留下的各种修订、修改、批注及手写批注；用户可以显示或隐藏修订痕迹；用户可以自由编辑文档而不会留下任何痕迹记录；用户还可以移动、删除任何人的手写批注。
主要代码：

PageOfficeCtrl poCtrl1 = new PageOfficeCtrl(request);
……
poCtrl1.webOpen("doc/"+filePath, OpenModeType.docAdmin, “张三”);

用户在这一环节主要用到的功能有：接受或者拒绝修订,隐藏所有痕迹,插入手写签名章或者图片章.
以上相关功能的js代码：
（1）接受所有修订：

document.getElementById("PageOfficeCtrl1").AcceptAllRevisions();

（2）拒绝所有修订：

document.getElementById("PageOfficeCtrl1").Document.RejectAllRevisions();

（3）插入印章：

document.getElementById("PageOfficeCtrl1").ZoomSeal.AddSeal();

注：PageOffice的电子签章功能的详细使用可以参考Samples的基本功能
一、15、演示加盖印章和签字功能（以Word为例）,此处不再赘述.

（4）插入手写签名章：

document.getElementById("PageOfficeCtrl1").ZoomSeal. AddHandSign();

（文员清稿模式）

4.正式发文

一般文档流转的最后一个环节就是正式发文环节，在这一个环节，不需要用户再对文档做任何修改，所以就用到了PageOffice的只读模式（docRealOnly）打开文档， 在该模式下用户只能阅读文档内容，不能对文档做任何修改。如果配合 PageOffice的禁止复制、禁止另存、禁止打印等功能，还可以实现安全的文档在线浏览功能。
主要代码：

PageOfficeCtrl poCtrl1 = new PageOfficeCtrl(request);
……
poCtrl1.webOpen("doc/"+filePath, OpenModeType.docReadOnly, "张三");

正式发文(只读模式打开文档)

这一环节用户可能用到的主要功能有：打印,页面设置,禁止复制下载等.
以上相关功能的js代码如下：
（1）打印：

document.getElementById("PageOfficeCtrl1").ShowDialog(4);

（2）页面设置：

document.getElementById("PageOfficeCtrl1").ShowDialog(5);

（3）另存到本地：

document.getElementById("PageOfficeCtrl1").ShowDialog(2);

（4）禁止复制,粘贴：

//服务器端代码。须放webOpen方法之前设置才可以禁止复制、粘贴的功能。

poctrl. setAllowCopy(false);

5.正式发文时还可以转换为htm， mht，pdf等格式的文档

有的用户需要实现没有安装Office客户端的电脑也可以查看正式发文，这就需要把Word文档另存为HTML或PDF了。如果另存为HTML，那么客户端直接就可以用浏览器查看，缺点是另存出来的HTML跟Word原文的格式会有一定的差距；如果另存为PDF，那么由于PageOffice客户端内置PDF阅读器，可以支持PDF文档的在线打开，所以另存为PDF是只读发文的一种比较完美的实现方式，但是只有专业版和企业版才支持此功能，标准版不支持。

（1）将当前文档另存为HTML，MHT类型的文件，并上传到Web服务器端的js代码：

document.getElementById("PageOfficeCtrl1").WebSaveAsHTML();

document.getElementById("PageOfficeCtrl1").WebSaveAsMHT();

（2）将当前文档另存为PDF的js代码：

document.getElementById("PageOfficeCtrl1").WebSaveAsPDF();

三.获取文档中所有痕迹的js方法

一般在文档强制留痕后，有个别用户的需求是获取文档中的所有痕迹并保存到数据库，以便于后期的查找核对。还有一些需求是获取文档中的所有痕迹后以痕迹列表的形式在页面显示出来，具体为什么要这样做呢？因为当文档有几十页甚至更大时，用户不容易知道文档具体哪些页有痕迹，不容易找到文档中所有的痕迹进行处理，当有痕迹列表显示时，用户很容易根据列表信息定位到文档中每一个痕迹的位置并对该痕迹进行处理，这样大大节省了用户的工作时间，提高了用户的工作效率。下面是一个获取Word文档中所有痕迹的代码，开发人员可以利用这个js示例中所调用的痕迹接口实现上述用户需求。

//获取并显示所有痕迹

function jsGetAllRevisions()

{

var docObj = document.getElementById("PageOfficeCtrl1").Document;

var i;

var str="";

for (i = 1;i <=docObj.Revisions.Count;i++){

str=str + docObj.Revisions.Item(i).Author;

if (docObj.Revisions.Item(i).Type=="1"){

str=str+ ' 插入：'+docObj.Revisions.Item(i).Range.Text+"\r\n";

}

else if (docObj.Revisions.Item(i).Type=="2"){

str=str + ' 删除：'+docObj.Revisions.Item(i).Range.Text+"\r\n";

}

else {

str=str + ' 调整格式或样式。';

}

}

alert("当前文档的所有修改痕迹如下：\r\n"+str);

}

//获取痕迹中时间的js：

//Document.Revisions.Item(i).Range.Date;

//Document.Revisions.Item(i).Range.DateTime;

//Document.Revisions.Item(i).Range.Time;

四.总结

综上所述，PageOffice针对文档在OA办公系统或其他文档办公系统中不同流程环节的特点，开发了对应的模式，还提供了显示隐藏痕迹、手写批注、分层显示手写、打印控制、另存控制、保存控制等各种功能，使得开发人员只需关注自身系统的业务逻辑开发，很简单方便的利用PageOffice实现不同流程环节下的控制和功能，代码清晰明了，极大的节省了系统的开发时间，提高开发工作效率。