NTKO控件使用说明书V1.0.docVIP

NTKO 控件使用说明书 NTKONTKO 控件使用说明控件使用说明 广州奥格智能科技有限公司 2011.7 NTKO 控件使用说明书 广州奥格智能科技有限公司 1 文档控制 更改记录更改记录 日期日期作者作者版本版本更改参考更改参考 2011-07-01陈卫光1.0创建 审阅审阅 签字签字/日期日期 审核审核 审批审批 客户确认客户确认 NTKO 控件使用说明书 广州奥格智能科技有限公司 I 目目 录录 1引言2 1.1目的2 1.2读者范围2 1.3参考资料2 2NTKO 控件安装 .3 2.1自动安装3 2.2手动安装5 3NTKO 控件开发 .6 3.1NTKO 控件文件说明 .6 3.2NTKO 控件使用 .7 3.2.1如何在你页面中引用 NTKO 控件.7 3.2.2用 NTKO 控件打开 office 文档8 3.2.3保存 NTKO 控件打开的 Office 文件9 3.2.4NTKO 常用 javascript 函数介绍 9 3.2.5常用 NTKO 控件事件10 3.2.6利用 NTKO 控件实现动态打印11 4NTKO 控件在公文流转中的应用 12 4.1痕迹保留.12 4.2制文.13 NTKO 控件使用说明书 1 1 引言引言 1.11.1 目的目的 本文档的编写目的主要是让工作流平台管理员掌握如何安装和卸载 NTKO 控件， 同时也让开发人员掌握 NTKO 控件的开发技巧来解决常见的在线编辑、打印等功能需 求。 1.21.2 读者范围读者范围 本文档面向管理员和项目组开发人员。 1.31.3 参考资料参考资料 NTKO 控件使用说明书 3 2 2 NTKONTKO 控件安装控件安装 2.12.1 自动安装自动安装 通常的情况下，使用自动安装，其安装步骤如下： 1、 更改 IE 浏览器的安全设置，即点击 IE 的“工具”菜单，选择“Internet 选项” ， 进入“安全”选项卡，界面如下： 再点击“自定义级别”按钮，进入如下界面，把有关“ActiveX 控件和插件” 的选项全部启用。 NTKO 控件使用说明书 4 点击“确定”后，关闭 IE 浏览器后重新打开 IE 浏览器，界面如下： 2、 安装 NTKO 控件，当首次打开 NTKO 控件时，在 IE tab 标签页下面会自动提示是否 “运行加载项” ，界面如下图所示： NTKO 控件使用说明书 5 点击“禁用的加载项(A)”的子菜单“运行加载项(R)” ，弹出以下对话框： 选择“运行” ，即安装完 NTKO 控件。 2.22.2 手动安装手动安装 一般情况下应该让客户端自动安装控件，这样当服务器控件版本更新时，客户端可 以获得自动升级方面的好处。但是，如果因为客户机配置有问题，或者有其它拦截工 具拦截的原因无法自动安装控件，可以采取手动安装。其安装步骤如下： 1、 把/resources/ntko 中的 officecontrol.cab 解压，然后拷贝 officecontrol.ocx 文件拷贝到 C 盘下； 2、 从命令行运行： regsvr32 c:officecontrol.ocx； NTKO 控件使用说明书 6 3、 其余的步骤同自动安装。 3 3 NTKONTKO 控件开发控件开发 3.13.1 NTKONTKO 控件文件说明控件文件说明 ADS 开发框架中内置了 NTKO 控件，同时具有很多 NTKO 控件使用的 Demo 代码。下 图是 NTKO 控件在 ADS 框架中的位置： 从上图中可以看出，NTKO 控件存放在”engine5/WebApp/resources/ntko”目录下。 NTKO 目录下有如下文件，如图： NTKO 控件使用说明书 7 文件清单说明如下表： 文件/目录名用途 OfficeControl.cabNTKO 控件所包含的动态链接库 genOfficeControl.jsIE 浏览器引用 NTKO ActiveX 控件的 JS 代 码，可以在 html 或 jsp 中直接引用该 js 文件 OfficeControlFunctions.jsNTKO 控件中常用 javascript 函数 EditOfficeDoc.jspADS 中引用 NTKO 的示例代码 templateFileWord、Excel、Visio 等模板文件 secSignFile电子签章文件 ntkosigntool.cabNTKO 控件电子签章所包含的动态链接库 3.23.2 NTKONTKO 控件使用控件使用 3.2.13.2.1 如何在你页面中引用如何在你页面中引用 NTKONTKO 控件控件 在你的页面中引用 NTKO 控件，代码如下： 其中 genOfficeControl.js 的代码如下 /嵌入NTKO文档控件时必须指定控件或者控件所在table/div的长度和高度 document.write(“); NTKO 控件使用说明书 8 document.write(“不能装载文档控件。请在检查浏览器的选项中 检查浏览器的安全设置。“); document.write(); document.write(); document.write(“); document.write(“); document.write(“); 从上面的代码可以看出，genOfficeControl.js 实际上是在 IE 浏览器中创建一个 ActiveX 对象NTKO 控件。 3.2.23.2.2 用用 NTKONTKO 控件打开控件打开 officeoffice 文档文档 NTKO 控件目前支持所有的 Microsoft Office 2000 版或以上的文档格式，除此以 外还支持 WPS 等办公软件。 如何使用框架中的 NTKO 控件打开 office 文档呢？首先在你的页面中引用 OfficeContorlFunctions.js，代码如下。OfficeContorlFunctions.js 封装对 NTKO 控 件调用的常用函数。 然后，在你的页面中为 body 标签添加 onload 事件处理函数，代码如下， 标签的 enctype 选项的的取值必须为“multipart/form-data” ； 2、 提交方式必须为“post” 下面是保存 NTKO 控件打开的 office 文件的代码： 其中 url 为你要提交到服务端的访问地址，url 取值请参考附件组件的文档。 3.2.43.2.4 NTKONTKO 常用常用 javascriptjavascript 函数介绍函数介绍 在 OfficeContorlFunctions.js 中封装了常用的 javascript 函数，如下表： 函数名参数功能 intializePageurl在页面打开时，用 NTKO 控件 打开 url 所指向的 office 文 件 saveFileToUrl保存 NTKO 打开的 office 文件 到磁盘 setFileOpenedOrClosedbool把文档标记为“打开”或“关 闭状态” 。Bool 取值为 true 时把文档标记为“打开”状态， 否则标记为“关闭”状态 onPageClose在关闭打开的 office 文件时 提示是否保存 openTemplateFileFromUrltemplateUrl用 NTKO 控件打开 NTKO 控件使用说明书 10 templateUrl 所指向的 office 文件 insertRedHeadFromUrlheadFileURL插入红头文件，headFileURL 为红头文件所在的地址 SetReviewModeboolvalue当为 word 文件时，设置文件 的是否保留修改痕迹。当 boolvalue 取值为 true 时保 留修改痕迹，否则不保留。 setShowRevisionsboolvalue当为 word 文件时，是否显示 修改痕迹。 setFileNewboolvalue是否屏蔽“新建(N)”菜单 setFileSaveboolvalue是否屏蔽“保存(S)”菜单 setFileSaveAsboolvalue是否屏蔽“另存为(A)”菜单 setIsNoCopyboolvalue是否禁止粘贴 saveFileAsHtmlToUrlurl把打开 office 文件保存为 html 文件 saveFileAsPdfToUrlurl把打开 office 文件保存为 pdf 文件 addServerSecSign插入服务端电子签名 addLocalSecSign插入本地电子签名 addHandSecSign插入手写签名 3.2.53.2.5 常用常用 NTKONTKO 控件事件控件事件 常用 NTKO 控件事件如下表： 事件名称功能 OnDocumentOpened打开 office 文档时触发 OnDocumentClosed()关闭 office 文档时触发 NTKO 控件使用说明书 11 如何针对 NTKO 控件的事件进行编程呢？ /此处添加打开此处添加打开office文件时事件处理函数文件时事件处理函数 /此处添加关闭此处添加关闭office文件时事件处理函数文件时事件处理函数 3.2.63.2.6 利用利用 NTKONTKO 控件实现动态打印控件实现动态打印 以前所阐述的都是静态的，在实际应用中经常需要动态打印，如下图所示： 显然，每次显示的标题、内容、发布人、发布时间都是动态变化的。如何利用 NTKO 控件实现此功能呢？ 要实现此功能，步骤如下： 1、 首先要做一个打印模板，即在制定位置插入四个书签，如下图： NTKO 控件使用说明书 12 插入的书签显示如图： 2、 在你的页面中调用 js 代码打印书签内容，即在打开 NTKO 控件事件处理函数中 添加打印书签的 js 代码， 如打印上面的标题，js 代码如下： /打印标题打印标题 OFFICE_CONTROL_OBJ.SetbookmarkValue(title, 关于中秋节放假的通知); 4 4 NTKONTKO 控件在公文流转中的应用控件在公文流转中的应用 4.14.1 痕迹保留痕迹保留 在公文流转过程中，通常需要记录“是谁在什么时候修改了公文的什么内容” ， 即痕迹保留。如何利用 NTKO 控件实现痕迹保留呢？ NTKO 控件使用说明书 13 实际上是在用 NTKO 控件打开 word 文档时，把文档设置为“修订”模式。例子代码 如下： /设置保留痕迹设置保留痕迹 SetReviewMode(true); /记录是哪个用户修改的记录是哪个用户修改的 OFFICE_CONTROL_OBJ.ActiveDocument.Application.Username=登录用户的用户名; 4.24.2 制文制文 在办公自动化系统的发文管理中有个常见操作就是制作公文，简称制文。制文需要 以下几个要素： 1、 红头文件； 2、 制文模板文件； 3、 正文 所以制文以前要准备好红头文件、制文模板文件和正文。 值得注意的是，在制文模板文件中必须要有值得注意的是，在制文模板文件中必须要有“zhengwen”“zhengwen”书签，该书签用来预留插书签，该书签用来预留插 入正文的位置。如下图所示，该打印模板中就有入正文的位置。如下图所示，该打印模板中就有”zhengwen”zhengwen”书签。书签。 NTKO 控件使用说明书 14 制文源代码如下： /制文 function makeDocument(printData) var ntko = document.all.item(“NTKO_OCX“); /插入正文 ntko.AddTemplateFromURL(“$ctx/$zhengwenPath“); /插入模板 var templateFilePath = “$ctx/$printTp