应用场景

在一些特殊应用场合，客户希望在服务器上生成文档的同时并填充数据，客户端的页面不显示打开文档。

目前服务器上生成文档第一种就是方案是采用Jacob， 但是局限于windows平台，往往许多Java程序运行于Linux等其他操作系统，在此不讨论该方案。

第二是POI，但是服务器上生成文档对服务器压力很大，而且它的Excel处理勉强可以， Word模块还局限于读取Word的文本内容，写Word文件的功能就更弱；另一个致命的问题是，处理doc格式和处理docx格式的类几乎完全不同，要分开针对不同的格式写不同的代码，这就意味着用户上传的docx格式文件如果使用了doc的扩展名，程序马上崩溃。而且POI结构混，编码比较复杂，开发过程非常消耗时间和精力。

所以针对这一系列的问题，PageOffice开发出来了FileMakerCtrl组件，该组件完全符合PageOffice的架构设计，FileMakerCtrl在客户端生成Office或PDF文档并上传到服务器，但是并不在Web网页里显示Office文档。

FileMakerCtrl对象使用说明

FileMakerCtrl 类是PageOffice开发平台中的核心类。和PageOfficeCtrl控件不同，FileMakerCtrl在Web网页里不显示Office文档，而是直接在线生成Office文档或将Office文档转换成PDF文档，或动态生成PDF文档。

注：以下代码以word为例

1.动态填充word文档并上传到服务器

请参考PageOffice产品开发包中Samples4的示例：
二、13、FileMaker转换单个文档（以Word为例）（专业版、企业版）

   FileMakerCtrl fmCtrl = new FileMakerCtrl(request);
   fmCtrl.setServerPage(request.getContextPath()+"/poserver.zz");	
   WordDocument doc = new WordDocument();
   //给数据区域赋值，即把数据填充到模板中相应的位置
   doc.openDataRegion("PO_company").setValue("北京卓正志远软件有限公司");
   fmCtrl.setWriter(doc);
   fmCtrl.setSaveFilePage("SaveMaker.jsp"); 
   //OnProgressComplete为回调函数,文档生成之后在页面里触发此js事件。
   //如果您需要响应此事件，您需要在当前 JSP 页面里定义一个 JavaScript 函数。
   fmCtrl.setJsFunction_OnProgressComplete("OnProgressComplete()");
   fmCtrl.fillDocument("doc/template.doc", DocumentOpenType.Word);

OnProgressComplete的使用： 比如需要实现文件生成后弹出另存为对话框，让用户保存文件到本地电脑，那么js可以这样写：

function OnProgressComplete() {
	document.getElementById("FileMakerCtrl1").ShowDialog(2); //弹出另存对话框
}

2.动态将word文档转换为pdf文档并上传到服务器

请参考PageOffice产品开发包中Samples4的示例：
二、34、FileMaker转换单个文档为PDF（以Word为例） （专业版、企业版）

    FileMakerCtrl fmCtrl = new FileMakerCtrl(request);
	fmCtrl.setServerPage(request.getContextPath()+"/poserver.zz");
	WordDocument doc = new WordDocument();
	doc.openDataRegion("PO_company").setValue("北京卓正志远软件有限公司");
	fmCtrl.setWriter(doc);
    fmCtrl.setSaveFilePage("SaveMaker.jsp");
	fmCtrl.setJsFunction_OnProgressComplete("OnProgressComplete()");
	fmCtrl.fillDocumentAsPDF("doc/template.doc",DocumentOpenType.Word, "a.pdf");

3.批量生成文档并上传到服务器

请参考PageOffice产品开发包中Samples4的示例：
三、1、FileMaker批量转换文档（以Word为例）（专业版、企业版）

批量生成文档就是基于FileMaker转换单个文档所使用的技术，在OnProgressComplete事件中执行js方法刷新页面中的iframe页面循环的加载生成不同的文件。

FileMakerCtrl和PageOfficeCtrl的区别

FileMakerCtrl本质上就是一个没有界面的PageOfficeCtrl，也是调用客户端Office程序处理文件的，都可以实现对文档进行动态填充、动态转PDF等功能，唯一的区别就是FileMakerCtrl在线打开填充和转换文档的时候客户端页面不显示打开的文档内容，而PageOfficeCtrl显示打开的文档内容。