卓正PageOffice在OA系统文档在线编辑及流转

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示例：1、1九、在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的基本功能
1、1五、演示加盖印章和签字功能（以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实现不一样流程环节下的控制和功能，代码清晰明了，极大的节省了系统的开发时间，提升开发工做效率。