《NTKO控件使用说明书V.doc》由会员分享，可在线阅读，更多相关《NTKO控件使用说明书V.doc（16页珍藏版）》请在金锄头文库上搜索。
1、NTKONTKO 控件使用说明控件使用说明 广州奥格智能科技有限公司 2011 7 文档控制 更改记录更改记录 日期日期作者作者版本版本更改参考更改参考 2011 07 01陈卫光1 0创建 审阅审阅 签字签字 日期日期 审核审核 审批审批 客户确认客户确认 目目 录录 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 文档
2、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 1 1 引言引言 1 11 1 目的目的 本文档的编写目的主要是让工作流平台管理员掌握如何安装和卸载 NTKO 控件 同时也让开发人员掌握 NTKO 控件的开发技巧来解决常见的在线编辑 打印等功能需 求 1 21 2 读者范围读者范围 本文档面向管理员和项目组开发人员 1 31 3 参考资料参考资
3、料 2 2 NTKONTKO 控件安装控件安装 2 12 1 自动安装自动安装 通常的情况下 使用自动安装 其安装步骤如下 1 更改 IE 浏览器的安全设置 即点击 IE 的 工具 菜单 选择 Internet 选项 进入 安全 选项卡 界面如下 再点击 自定义级别 按钮 进入如下界面 把有关 ActiveX 控件和插件 的选项全部启用 点击 确定 后 关闭 IE 浏览器后重新打开 IE 浏览器 界面如下 2 安装 NTKO 控件 当首次打开 NTKO 控件时 在 IE tab 标签页下面会自动提示是否 运行加载项 界面如下图所示 点击 禁用的加载项 A 的子菜单 运行加载项 R 弹出以下对话
4、框 选择 运行 即安装完 NTKO 控件 2 22 2 手动安装手动安装 一般情况下应该让客户端自动安装控件 这样当服务器控件版本更新时 客户端可 以获得自动升级方面的好处 但是 如果因为客户机配置有问题 或者有其它拦截工 具拦截的原因无法自动安装控件 可以采取手动安装 其安装步骤如下 1 把 resources ntko 中的 officecontrol cab 解压 然后拷贝 officecontrol ocx 文件拷贝到 C 盘下 2 从命令行运行 regsvr32 c officecontrol ocx 3 其余的步骤同自动安装 3 3 NTKONTKO 控件开发控件开发 3 13 1
5、 NTKONTKO 控件文件说明控件文件说明 ADS 开发框架中内置了 NTKO 控件 同时具有很多 NTKO 控件使用的 Demo 代码 下 图是 NTKO 控件在 ADS 框架中的位置 从上图中可以看出 NTKO 控件存放在 engine5 WebApp resources ntko 目录下 NTKO 目录下有如下文件 如图 文件清单说明如下表 文件 目录名用途 OfficeControl cabNTKO 控件所包含的动态链接库 genOfficeControl jsIE 浏览器引用 NTKO ActiveX 控件的 JS 代 码 可以在 html 或 jsp 中直接引用该 js 文件 O
6、fficeControlFunctions jsNTKO 控件中常用 javascript 函数 EditOfficeDoc jspADS 中引用 NTKO 的示例代码 templateFileWord Excel Visio 等模板文件 secSignFile电子签章文件 ntkosigntool cabNTKO 控件电子签章所包含的动态链接库 3 23 2 NTKONTKO 控件使用控件使用 3 2 13 2 1 如何在你页面中引用如何在你页面中引用 NTKONTKO 控件控件 在你的页面中引用 NTKO 控件 代码如下 其中 genOfficeControl js 的代码如下 嵌入NTK
7、O文档控件时必须指定控件或者控件所在table div的长度和高度 document write 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 控件目前支持
8、所有的 Microsoft Office 2000 版或以上的文档格式 除此以 外还支持 WPS 等办公软件 如何使用框架中的 NTKO 控件打开 office 文档呢 首先在你的页面中引用 OfficeContorlFunctions js 代码如下 OfficeContorlFunctions js 封装对 NTKO 控 件调用的常用函数 然后 在你的页面中为 body 标签添加 onload 事件处理函数 代码如下 body onload intializePage urlurl 其中 intializePage 将去读取要打开的文件 url 为要打开的文件的地址 url 可 以有两种形
9、式 第一种第一种 直接读取服务器下的文件 比如要打开服务器 tomcat 下 webapps engine5 fawen xxx doc 文件 url 取值为 engine5 fawen xxx doc 第二种第二种 读取二进制文件流 url 通常为一个某一个 Action 的一个方法 该方法 去后台读取某一个 office 文件的二进制流 例如 url 取值为 ctx sysfile sys file readAttachment action sysFileId sysFileId 3 2 33 2 3 保存保存 NTKONTKO 控件打开的控件打开的 OfficeOffice 文件文件
10、如何保存 NTKO 控件打开的 office 文件呢 实际上 NTKO 控件把打开的 office 文件 以 附件 形式上传到后台服务器磁盘 所以同普通附件上传一样 有以下几个注意 事项 1 标签的 enctype 选项的的取值必须为 multipart form data 2 提交方式必须为 post 下面是保存 NTKO 控件打开的 office 文件的代码 其中 url 为你要提交到服务端的访问地址 url 取值请参考附件组件的文档 3 2 43 2 4 NTKONTKO 常用常用 javascriptjavascript 函数介绍函数介绍 在 OfficeContorlFunction
11、s js 中封装了常用的 javascript 函数 如下表 函数名参数功能 intializePageurl在页面打开时 用 NTKO 控件 打开 url 所指向的 office 文 件 saveFileToUrl保存 NTKO 打开的 office 文件 到磁盘 setFileOpenedOrClosedbool把文档标记为 打开 或 关 闭状态 Bool 取值为 true 时把文档标记为 打开 状态 否则标记为 关闭 状态 onPageClose在关闭打开的 office 文件时 提示是否保存 openTemplateFileFromUrltemplateUrl用 NTKO 控件打开 t
12、emplateUrl 所指向的 office 文件 insertRedHeadFromUrlheadFileURL插入红头文件 headFileURL 为红头文件所在的地址 SetReviewModeboolvalue当为 word 文件时 设置文件 的是否保留修改痕迹 当 boolvalue 取值为 true 时保 留修改痕迹 否则不保留 setShowRevisionsboolvalue当为 word 文件时 是否显示 修改痕迹 setFileNewboolvalue是否屏蔽 新建 N 菜单 setFileSaveboolvalue是否屏蔽 保存 S 菜单 setFileSaveAsboo
13、lvalue是否屏蔽 另存为 A 菜单 setIsNoCopyboolvalue是否禁止粘贴 saveFileAsHtmlToUrlurl把打开 office 文件保存为 html 文件 saveFileAsPdfToUrlurl把打开 office 文件保存为 pdf 文件 addServerSecSign插入服务端电子签名 addLocalSecSign插入本地电子签名 addHandSecSign插入手写签名 3 2 53 2 5 常用常用 NTKONTKO 控件事件控件事件 常用 NTKO 控件事件如下表 事件名称功能 OnDocumentOpened打开 office 文档时触发 O
14、nDocumentClosed 关闭 office 文档时触发 如何针对 NTKO 控件的事件进行编程呢 此处添加打开此处添加打开office文件时事件处理函数文件时事件处理函数 此处添加关闭此处添加关闭office文件时事件处理函数文件时事件处理函数 3 2 63 2 6 利用利用 NTKONTKO 控件实现动态打印控件实现动态打印 以前所阐述的都是静态的 在实际应用中经常需要动态打印 如下图所示 显然 每次显示的标题 内容 发布人 发布时间都是动态变化的 如何利用 NTKO 控件实现此功能呢 要实现此功能 步骤如下 1 首先要做一个打印模板 即在制定位置插入四个书签 如下图 插入的书签显示
15、如图 2 在你的页面中调用 js 代码打印书签内容 即在打开 NTKO 控件事件处理函数中 添加打印书签的 js 代码 如打印上面的标题 js 代码如下 打印标题打印标题 OFFICE CONTROL OBJ SetbookmarkValue title 关于中秋节放假的通知 4 4 NTKONTKO 控件在公文流转中的应用控件在公文流转中的应用 4 14 1 痕迹保留痕迹保留 在公文流转过程中 通常需要记录 是谁在什么时候修改了公文的什么内容 即痕迹保留 如何利用 NTKO 控件实现痕迹保留呢 实际上是在用 NTKO 控件打开 word 文档时 把文档设置为 修订 模式 例子代码 如下 设置
16、保留痕迹设置保留痕迹 SetReviewMode true 记录是哪个用户修改的记录是哪个用户修改的 OFFICE CONTROL OBJ ActiveDocument Application Username 登录用户的用户名 4 24 2 制文制文 在办公自动化系统的发文管理中有个常见操作就是制作公文 简称制文 制文需要 以下几个要素 1 红头文件 2 制文模板文件 3 正文 所以制文以前要准备好红头文件 制文模板文件和正文 值得注意的是 在制文模板文件中必须要有值得注意的是 在制文模板文件中必须要有 zhengwen zhengwen 书签 该书签用来预留插书签 该书签用来预留插 入正文的位置 如下图所示 该打印模板中就有入正文的位置 如下图所示 该打印模板中就有 zhengwen zhengwen 书签 书签 制文源代码如下 制文 function makeDocument printData var ntko document all item NTKO OCX 插入正文 ntko AddTemplateFromURL ctx zhengwenPath 插入模板 var te
