《集成开发手册》doc版.doc

DXP团团赚团购网站2.0源码eform集成开发手册如何集成eform4将eform和用户自己的系统集成在一起4使用eform for .net,数据库为sql server 20004使用eform for java,数据库为oracle9i5系统文件说明6前台文件:7后台文件:10Eform系统文件中的配置信息说明11fcpub.js文件中的配置信息说明11fcconfig.xml文件中的配置信息说明12数据库表结构说明13FC_ATTACH 表结构:13FC_BILLZL表结构:13FC_MAXBH表结构:14FC_DATADICT表结构:14FC_ENTITY表结构:14FC_ENTITYSUB表结构:14FC_QUERY表结构:15数据库连接的集成15eform for .net版 数据源的配置15eform for J2ee版 数据源的配置16引入JS文件及函数17自定义函数17引入JS文件19引用CSS样式19切换Skins皮肤样式20增加业务函数21(1) 将用户的业务函数注册到函数的选择窗口中21(2) 在控件中增加业务函数21定制工具栏22(1) 在eformsysfceformfcpub.js文件中配置信息中设置你所需要的工具栏22(2) 工具栏的用途22打开表单23(1) 打开文件表单23(2) 打开数据库中的表单23定制新建表单向导23运行表单24和用户的权限体系进行集成24(1) 进入表单权限的控制25(2) 自定义表单加权限的使用说明25(3) 表单上控件的权限控制28和工作流集成29(1)表单上控件在流程的不同阶段属性值不一样29(2)在打开表单时加上流程信息29(3)设计流程工具栏29(4)表单加流程的使用说明29(5)一个完整的和工作流相结合的示例说明33eform FAQ41表单属性页的工具栏下拉框没有“流程工具栏”，手册上有，因为我们真是要和流程结合的?41查询工具栏上没用打印和打印预览？41怎么添加函数库,还有增加的函数库放在哪里？41标签好像不能绑定数据项的。41select * from area where sareaid=:key_value :什么意思？41我们的用户信息放在session里的，我怎么取得呢41eForm中，要上传并显示图片，怎么做呀？41如何将控件(如button)加到tab页签控件的页中42dataset关联一个grid，下拉列表框是另外一个表里的内容，该dataset只保存其代码。而在单据输入的时候，怎样才能那个表格显示下拉列表框的内容，而保存的时候保存和他相关联的代码呢42我设计了form以后, 可以离开eform,到visual studio 中开发吗,42设计了form怎么导出到visual studio?42在eform里新建一个表单保存后是存在哪里的? 工程里有没有存?42我想把设计好的页面copy到我现有的工程里面去 可以吗?42我想是在 自定义函数中,调用java类里的方法 怎么实现?42在自定义函数中能写哪写东西? 有什么规范?42我想知道示例里面的正式运行表单和测试运行表单有什么区别42grid 上能放附件吗？43我如果只是做界面设计的试用，不用数据也是可以的吧？43选中表格中怎么把选中数据的值从地址中传到下一个页面？43比如我要在表格中每条记录后面都加上详细的选项按钮，我在这新建了一个详细的字段，在这个字段的每条记录后面显示“详细”43怎么设置文本框最大输入数43我本机现在有修改后的htm文件，而数据库中没有，我能不能把新的文件放到数据库中？43我要修改某个表里的一个字段，不使用数据集行不行？只运行一下修改的SQL语句！43怎样能指定dbimg的图片啊43树控件可以有多个根结点吗43单击事件可以放多个函数吗?43我的表单在执行的时候提示找不到44在做数据验证时，就是在dataset的属性里有两个“数据验证”的地方，还有一个“常规校验”，这3个怎么区别，什么时候用，我有点不太清楚？44最近打开的表单的记录存在那里的，我换了个库，好像还要我以前的打开记录，但是打开是空的。44现在客户那里有一个要求，就是让每个部门来管理自己的表单。每个部门的管理员只能看到，操作自己的表单。你现在整个eform好像只能一个管理员来操作，该怎么弄44打开表单是为什么还要传个djtype，那个djsn不是唯一的吗？能不能去掉啊44就是如何去掉“离开的话数据将丢失.”的提示44我自己做的画面，我用 (略)/fceform/common/djframe.htm?djsn=demoUserinfo1&djtype=TT的方式可以运行起来，而我采用直接在url指定路径的方式却运行不起来，javascript报错：parent.toolbar.location为空或不是对象44我可以改变标签或文件框的位置和大小吗？44如果绑定到了数据集，运行时控件的默认值就不显示吗？44如果在表单中,我让表格控件绑定了数据集.我在数据集中增加一个字段XG,在表格中显示为修改,我想让XG这一列的颜色与其它的列不同,应该怎么设置?45怎么样设置图片的移入和移出事件?45请问可以给dbimg控件设置默认图片吗？让表单在运行时，可以直接看到图片，控件已经绑定数据集了45eform操作保存时，显示成功，但是服务器报null，而且运行的时候，和没改之前是一样的，这可能是什么问题呢？45我用程序代码改变了text1的值后,怎么才能使text1所绑定的数据集相应字段的值也变化.45eform中执行存储过程的函数是哪个45我用 Label7.style.value=aghjg 好象不能修改控件的值，是不是那里写错了？45我在下拉列表中，选出的是两个字段，一个是ID,一个是Name，选择保存时，存到数据库中的是ID还是Name？45我想问一下，eform里面的公共变量pubdjbh(eform5.0后改为fcpubdata.keyValue)到底是干什么用的？45你说userfunc.js文件中直接引入自己的一个js文件，怎么引入啊，那个里面不是只能写函数吗？46我新建分类时如果路径不存在，它好像不会自己生成路径的47我弄了一个dsmain,在数据项中将此字段设默认值1，然后将此字段绑定在一个text上，设计时显示1，一运行显示空47现在我一个表中有5万多条数据，列表显示的时候ie就没有响应了，请问如何优化性能？47在表单属性中的”进入时状态“能不能在表单中动态修改？47我的表单要实现两种功能，一个是录入，一个是修改我是做到一个表单上还是做到两个表单上比较好？47eform中将字符串保存到剪切板的命令是什么？47我想设中的值怎么办？47文本框输入密码怎么设置47我们公司原来有一套自己的css，能不能简单描述一下如何应用到eform中去呢？47树控件的点击事件中对当前选中节点的访问是怎样的481. 将eform和用户自己的系统集成在一起使用eform for .net,数据库为sql server 2000安装好 sql server 2000在sql server中建好用户要开发的数据库,假如数据库名为CRM下载并安装好eform for .net,假如按默认安装到C:Inetpubwwwrootfcbill 目录下.用户已有一个CRM的.net 工程,假如此工程在C:InetpubwwwrootCRM 目录下,虚拟目录的名称为CRM.1 将 C:Inetpubwwwrootfcbillebsys 这个目录复制到 C:InetpubwwwrootCRM 目录下，把C:Inetpubwwwrootfcbillbin中的所有文件复制到C:InetpubwwwrootCRMbin目录下。2 修改C:InetpubwwwrootCRMbinfcconfig.xml文件。数据库连接串保存在此文件中。其文件内容如下：/ebsys用户.ID,用户.名称,部门.ID,部门.名称,系统.单位名称这是一个XML格式的文件，其中节点的内容为所有数据库连接的配置，每一个子节点为一个数据库连接的配置，其中第一个子节点是默认的数据库连接的配置，即如没有选择数据源名称时，用第一个数据库连接的配置。用户需要根据自己的情况来修改数据库连接串。3 在SQL-SERVER查询分析器编辑框内执行：use CRM， 从而进入数据库名为：CRM操作。点击图标，解压databasebak.rar文件，打开其中的sqlserver.sql文件，点击 图标，SQL Server系统自动生成eForm平台上所用的系统表。4 这样用eform for .net 开发用户自己的CRM数据库要用的表单的开发环境就配置好了. 执行 http:/localhost/crm/ebsys/fceform/design/design.htm 就可以进入eform自定义表单设计器.使用eform for java,数据库为oracle9i安装好 oracle9i,下载并解压安装好eform for j2ee,假如安装到d:fcsofttomcatwebappseform 目录下.1 修改web-inf/fcconfig.xml文件，eform for j2ee的数据库连接串保存在此文件中，此文件的内容大致如下: /ebsys用户.ID,用户.名称,部门.ID,部门.名称,系统.单位名称这是一个XML格式的文件，其中节点的内容为所有数据库连接的配置，每一个子节点为一个数据库连接的配置，其中第一个子节点是默认的数据库连接的配置，即如没有选择数据源名称时，用第一个数据库连接的配置。修改其中的数据库名(如:sys)，用户名，口令，以和自己的相匹配。 2 解压databasebak.rar文件，打开其中的oracle.sql文件，将其内容在PL/SQL软件中执行，以生成eForm平台上所用的系统表。3 这样用eform for j2ee 开发用户自己的CRM数据库要用的表单的开发环境就配置好了. 执行 http:/localhost:8070/eform/ebsys/fceform/design/design.htm 就可以进入eform自定义表单设计器。2. 系统文件说明eform系统文件分为前台文件和后台文件。前台文件是指htm js css 图片 xml 等文件。后台文件是指在服务器端运行的文件，如dll和jar包。Eform for java版与 eform for .net版的前台文件是一样的。但后台文件不一样。前台文件:上图是eform前台文件的界面图，它都在ebsys目录下。其中 ebsys/eformaspx/目录下的文件是eform for .net版的后台文件。在eform for java版中不需要此目录。（1）在ebsys目录中eformhelp目录提供在线帮助，在eform设计当中点击问号，提供详细说明。如图：点击第一个问号将出现下图：(2)ebsys/fceform目录是eform的核心文件，在其下的目录：css目录是eform的样式文件，其中dj.css在样式文件中比较重要，所有表单都引用它。此目录的界面图如下：skins目录下定义了多种皮肤文件供用户定义多套样式来切换。Common 有好多常用的页面，如在运行表单时先打开djframe.htm的页面。Design目录是表单要进入设计器用到的文件。如下图进入ListBox互选示例就要用到它。dj目录下放了eform系统本身要用到的表单，这些表单都是用eform设计器来设计的，也可以用eform设计器打开来修改这些表单的功能。Js目录下是一些JS文件。csjsrequest.js 这是用于当超链接的地址是链接到一个htm页面，此时希望取URL的？后的以参数名称=参数值格式的值时，就需要引用此JS，它是实现这样的功能的。design.js 表单设计器中要用到的JSfcbasecont.js 基本控件（如radio checkbox combobox等）中要用到的一些函数。fcdataset.js 数据集控件的一些常用函数。fcebiao.js layout布局控件和ebiao控件的实现函数。fcgensql.js SQL语句生成向导界面的实现函数。fcopendj.js 打开表单用的函数fcother.js 资料选择等杂类函数fcpub.js 全局JS，它是最常用的函数，几乎所有的页面都会引用它。fcrundj.js 表单运行时会用到的函数。fcsavedj.js 表单保存时会用到的函数。fcselfuse.js eform系统表单中会用到的函数。fcskins.js 切换皮肤的函数。fctoolbar.js 自定义表单设计器的工具栏的功能函数。fctorun.js 实现将表单的设计串转换成运行串的功能，它在表单设计器中保存表单时调用。fcupload.js 多附件上传控件的实现函数。fcvalid.js 数据验证的实现函数。fcwebgrid.js grid控件的常用函数。htmlarea.js, table-operations.js 在表单设计器中设计html table的实现函数。MicrosoftAjax.js 微软JS框架。selectdate.js 实现选择日期。tabpane.js tab页签控件的实现函数。xtree.js 树控件的实现函数。Htc目录下是网页控件。它类似于JS文件。dataset.htc 数据集控件的实现fc_code.htc dropdownlist控件的实现。NumEdit.htc spin控件的实现。webgrid.htc grid控件的实现。webmenu.htc 右键菜单功能的实现。Images目录下是eform要用到的图片。(3)fceformext是用户扩展用的。其下的目录：common目录常用来保存用户自定义的工具栏页面。css目录常用来保存用户自定义的CSS文件form_开头的目录是一些示例用的表单。Html目录保存的是layout布局控件要用到的布局页面Js目录保存的是用户自定义的JS文件，其中userfunc.js在默认时表单都会引用它，可以将多个表单上都要使用的JS函数写到此文件中。这样就可以在表单中调用了。Res目录保存了上传附件控件所上传的文件。Xml目录保存XML文件。其中的billpos.xml文件保存的是用有模式窗口打开的表单的打开位置信息。Billtype.xml文件中保存的表单的生成路径分类的信息。(4)samples目录是示例中心的框架所用的文件。(5)zk目录是新建表单向导功能和数据库中的表信息等功能的页面。后台文件:如果是eform for .net版就要用到bin，在bin目录中有fcDCommon.dll是通用的连数据库用的，ebiao.dll是eform系统的后台程序。ebiaoext.dll是供用户集成和扩展时写的后台程序工程。WebBill.dll是当前工程生成的dll，即当前工程的 .aspx.cs文件生成的dll. eform for .net版的后台文件还有 ebsys/eformaspx/下的文件，它只有一个WebBill.aspx，这是由前台JS调用后台DLL的关联性的文件，即前台JS用AJAX方式先调用WebBill.aspx，再由WebBill.aspx.cs文件（此文件编译成WebBill.dll）来调用后台DLL文件中的方法。如果是eform for java版，需要web-inf/目录下的fcconfig.xml文件和perties文件，perties文件是log4j的日志的配置文件。web-inf/lib目录下文件。其中eform.jar是eform运行的包。这个包中的根目录下是WebBill.class文件，这是一个servlet，前台JS用AJAX方式先调用先调用到此servlet，然后再调其它的类。.fcsoft.ajax 这个包下是eform读写后台数据库的主要的类文件.fcsoft.report.ext 这个包下是供用户集成或扩展用的类文件。.fcsoft.util 这个包下是一些常用的工具类。web-inf/lib目录下的下面的文件是一些开源的包及数据库的驱动：commons-fileupload-1.1.jar 和 commons-io-1.2.jar 是用于上传附件dom4j-1.6.1.jar和jaxen-1.1-beta-6.jar dom4j用于分析xml的GUID-OpenTools.jar 用于产生GUID值log4j_128.jar log4j日志ojdbc14.jar oracle库的JDBC驱动sqlserver7jdbc.jar una2000.jar 这是两个sqlserver库的JDBC驱动，可选其中一个使用。3. Eform系统文件中的配置信息说明Eform系统文件中有两个文件是可配置的，用需要根据自己的需要而修改它们，这两个文件是：一个是前台的JS文件，是ebsys/fceform/js/fcpub.js，它用于配置前台JS中要用到的信息。另一个是后台的XML文件，它配置后台程序中要用到的一些配置信息。如果是eform for .net版这个文件是bin目录下的fcconfig.xml文件，如果是eform for .net版这个文件是web-inf目录下的fcconfig.xml文件。fcpub.js文件中的配置信息说明var fcpubdata=servletPath: /ebsys/eformaspx,/调用后台文件的基路径, for .NET的常用写法是: /ebsys/eformaspx ,eform for j2ee的常用写法是: /servletpath: /ebsys,/定位到fceform目录,不含虚拟目录的路径,常用写法是: /eformsysdotnetVersion: .aspx,/=表示为java版本,=.aspx为.net版本databaseTypeName: sqlserver,/数据库类型,sqlserver/mysql/oracle/db2dbStruDict : FC_DBSTRU, /=FC_DBSTRU =FC_FLDLIST = 表示临时从数据库中取.cssFiles : , /在表单中加载的css文件,路径在fceform目录,一般写 /css/xx.css skins : base, /表单skin 可设值为: base/blue/red/yellow/light/green/whitetoolbarStyle: base, /设计器工具栏的样式 可设值为: base/blue/red/yellow/light/green/whiteactionButtonDisplay : , /控件属性框中的设置权限按钮的style.display属性值 none表示不显示db2UserName: DB2ADMIN,/db2数据库的用户名(即模式名)gridNoFieldName : dj_sn,/主子表编辑时子表的顺序号字段名billOpenWinName: rightmain,/运行表单的帧窗口的名称position: absolute,/缺省的定位模式 =absolute/statictoolbar : newempty,opendj,opendjfile,billtype,djpreview,directrun,save,saveas,|,cut,copy,paste,undo,redo,|,align,focus,front,behind,form,|,userfunction,userfunction1,addhtml,execute,showlist,listconfig,setPosition,|,cbozoom,br,button,label,img,div,shape,|,tab,tree,a,spin,checkboxlist,radiolist,|,dataset,grid,htmltable,formattab,|,text,checkbox,radio,listbox,combobox,dropdownlist,textarea,|,dbimg,upload, /表单设计器工具栏按钮,|是分隔符,br是换行formToolbar: 单表输入工具栏多表输入工具栏查询工具栏带工具栏 , /配置用eform画的表单的可用工具栏,内容为格式的XML串,节点属性path表示页面路径，表示fcpubdata.path值,节点属性height表示工具栏占的高度，如不指定，则取默认值为31px,节点值为工具栏名称，在表单设计器的表单属性窗口中以列表形式显示，供操作员选择。sendHttpErrMsg : :与后台连接出错:,/特定的连后台出错信息area : null , / eform的设计区,是个div元素.dsMain: DsMain,/主数据集即未绑定到表格的第一个数据集的IDpubSession: null, /取得session的标识,这是为了用同步方式取session的方法,常用写法是: username=&deptname=autoAddField: no,/为yes表示新建表单时是否自动加一个主数据集，以及加控件时自动加字段。 pubdataSrc: ,/保存各子窗口的url,下同topicSrc: ,keyValue : , /原来的pubdjbh,用于跟踪主键字段的值obj : null, /原来的pubDataSet,用于在表单之间传递对象参数时用.isEdit : false, /原来的pubEdit,判断表单是否手动修改过的标志.enterStatus : OK,/判断能不能进入表单,为OK表示可以进入.arrValidObj : new Array(), /保存校验失败的事件对象,用于在保存前再校验.controls : new Object(), /取表单上的所有控件, popup : window.createPopup() /等待窗口;fcconfig.xml文件中的配置信息说明 /数据源配置列表/ebsys /文件的根路径,用户.ID,用户.名称,部门.ID,部门.名称,系统.单位名称 /配置的全局参数.4. 数据库表结构说明eform可能会用到的系统表有：FC_ATTACH、FC_BILLZL、FC_MAXBH 。FC_ATTACH 表结构:CREATE TABLE FC_ATTACH (extend varchar(255) NULL, /附件的文件扩展名，如：.txtdjbh char(15) NOT NULL, /关联主键值，比如当前附件属于职员张三的，而职员张三的ID为 ZBF00000014，则此字段的值就保存ZBF00000014，由此字段来建立附件与附件所属者之间的关联。因为一次可以上传多个附件（即一个职员可能会有多个附件），所以此字段在当前表中并不是唯一的。dj_sn int NULL, /多附件时的顺序号，可空。filename varchar(255) NULL, /附件的原始文件名，如：D:1.txt ，表示这个附件是从客户端的D:1.txt 处上传而来的。attachid char(11) NOT NULL, /本表的主键字段，唯一标识。bz varchar(255) NULL, /附件备注信息djsn varchar(40) NULL, /表示本附件是由哪张表上传来的，此字段保存表名filepos varchar(250) NULL /附件上传后在服务器端保存的位置，如：/fceformext/res/c7f3dbc4-41ed-453e-a820-91569f2f57d7.txt);FC_ATTACH表用于记录上传的附件的相关信息，如果用户没有用eform中的上传附件控件的话，则这张系统表可以不要。FC_BILLZL表结构:CREATE TABLE FC_BILLZL (djid int NOT NULL, /本表主键，用于唯一标识dj_name varchar(40) NULL, /表单中文名称djlx varchar(20) NULL, /表单分类号xmltext ntext NULL, /表单运行串DjPosition varchar(255) NULL, /表单的位置等信息djsn varchar(40) NULL,/表单SN，即表单的程序调用名称designtext ntext NULL, /表单设计串stmptable varchar(4000) NULL, /用于生成临时表的建表字符串userType varchar(50) NULL /用户自定义的表单分类);FC_BILLZL表用于保存eform设计的表单，每条记录保存一张表单。如果用户将所有的表单直接保存在.dj的文件中的话，则不需要建这张系统表。反之，如果用户需要将表单保存在数据库中的话，则需要建这张表。FC_MAXBH表结构:CREATE TABLE FC_MAXBH (biaoshi char(3) NOT NULL, /三个字母的标识，本表主键recnum int NULL /最大号);FC_MAXBH表用于生成唯一标识号的表，即用此表来生成主键字段的值。如果用户不用这种方式来生成主键字段的值的话，则不用建这张系统表。但要注意，默认时，象FC_BILLZL表的主键字段（djid）的值的生成就要用到这张表。FC_DATADICT表结构:CREATE TABLE FC_DATADICT (id char(11) NOT NULL,typename varchar(50) NOT NULL,dj_sn int NULL,name varchar(50) NULL,code char(10) NULL);FC_ DATADICT表是数据词典表,保存了在eform本身用的数据词典信息，如果用户不用此表，则数据库中的表信息界面上的查询信息会显示不出。FC_ENTITY表结构:CREATE TABLE FC_ENTITY (orgid char(11) NULL,tbname varchar(50) NOT NULL, /表名tbchnname varchar(50) NULL,/表中文名ownerid char(11) NULL,keyPrefix char(3) NULL);FC_ ENTITY表用于保存数据库中的表名和表中文名，也可不用此表。FC_ENTITYSUB表结构:CREATE TABLE FC_ENTITYSUB (orgid char(11) NULL,tbname varchar(50) NOT NULL, /表名fdname varchar(50) NOT NULL,/字段名chnname varchar(50) NULL,/字段中文名fdtype char(4) NULL,/字段类型,取值：字符/整数/实数/文本/图像 fdsize int NULL,/字段长度fddec int NULL,/小数位数type char(10) NULL, /字段详细类型detailxml varchar(7000) NULL /详细信息，XML格式的);FC_ ENTITYSUB表用于保存数据库中的表的字段名和字段中文名和字段类型长度等，也可不用此表。FC_QUERY表结构:CREATE TABLE FC_QUERY (type int NOT NULL, /类别tbname varchar(50) NOT NULL,/表名fdlist varchar(2000) NULL,/字段名列表，用逗号分隔fdchnlist varchar(3000) NULL/字段中文名列表，用逗号分隔);FC_ QUERY表查询信息，即常用的查询的输出字段信息。在极端的情况下，是可以不用建任何eform系统表的。即不用额外建