alkacon oamp webform的使用

Alkacon OAMP Webform为Alkancon为opencms开发的一个表单模块

下载地址：

http://www.alkacon.com/en/products/oamp/（可以下载到webform和comments）

webform 最新版本为1.4.1 文件为：com.alkacon.opencms.formgenerator.jar

适用于opencms7.5.0之后的版本，不兼容之前的版本。如果是opencms7.0.5之前的版本，使用comments1.0.0 和webform1.3.0

注：如果下载webform1.3.1版本，在使用过程中将出现异常：

javax.servlet.ServletException: javax.servlet.jsp.JspException:

javax.servlet.jsp.el.ELException: An error occurred while getting property "comments" from an instance of class com.alkacon.opencms.comments.CmsCommentsAccess

目前还不清楚解决情况，并且1.3.1版本中，表单还没包括密码域，因此不推荐使用。

2.webform的使用介绍

2.1安装

2.1.1 打开opencms，进入系统管理视图

2.1.2进入模块管理页面，如果webform模块在你opencms安装的web-inf/packages/modules/的目录下，请选择从服务器模块导入，或者在系统文件中使用HTTP导入

2.1.3 在打开的页面中，选择你“com.alkacon.opencms.formgenerator_xxx.zip" 进行导入

2.1.4 安装成功后，检查”com.alkacon.opencms.formgenerator.jar“在安装之后是否已经部署在了web-inf/lib目录下，

2.1.5 在web-inf/lib/ 目录下，请删除ehcache-1.0.jar和jcaptcha-all-1.0.RC2.0.1.jar这2个jar包，如果存在

2.1.6 重启tomcat

2.2 配置模块

2.2.1 登录opencms，进入系统管理视图

2.2.2 进入模块管理页面

2.2.3 在模块列表中，请选择”com.alkacon.opencms.formgenerator"(即刚才所安装的模块）

2.2.4 点击模块参数，设置db-pool和uploadfolder这2个参数，（如果需要在opencms VFS中保存文件，那么也需要配置uploadvfs和uploadproject参数）其他参数可选。

主要参数说明：

1.db-pool:该参数需要根据web-inf/config/opencms.properties文件，默认参数值为“default，如果想要表单数据在专用的数据库上，需要在

opencms.properties中配置起pool值，然后为其配置相应的值。

2.uploadfolder:这个参数是必须的，可以存在opencms VFS文件中，也可以保存到系统文件夹中。

当uploadfolder设置为opencms vfs路径时，其他配置uploadproject=offline，uploadvfs=true

导出的几个参数配置：

3.export.timeformat:导出的时间格式，语法解释参考，可以查看java关于时间的API格式

4.export.encoding:导出的编码方式；默认为utf-8，如果导出为Excel2003-compatibility可选择“windows-1252”

5.export.lineseparator:换行方式，值为windows=\r\n,unix或excel：在excle中为“\r”，在cvs文件中为“\n";

权限的配置

6.usergroup：一般为users，可以再用户模块中配置

数据库的配置

7.db-provider和index-tablespace：目前只支持数据库MySql和Oracle,默认为MySQL，如果想使用oracle配置为，db-provider=oracle,index-tablespace=你的表空间（即当初安装opencms时设置的表空间)，默认为users

样式

8.css:css样式表，默认为”/system/modules/com.alkacon.opencms.formgenerator/resources/css/webform.css“，当然也可以改变自定义的路径下的css表

9.font-prefix：为页面中产生的验证码图片的字体设置样式，默认为：Rial|Courier|Monospaced|SansSerif|Serif

使用的参数格式为：字体|字体|...

注：如果想使用其他的配置文件来代替默认的（com.alkacon.opencms.formgenerator/classes/com/alkacon/opencms/formgenerator/workplace.
properties），你必须设置模块参数的“message”属性，去绑定你设置的配置文件，如：该文件命名为“workplace2.properties“，那么message参数

2.3webform中几个常用的域的使用介绍

2.3.1  checkbox:

在default value中的配置为：value1:displayname1|value2:displayname2|....

所对应的html为  <input type="checkbox" value="value1" >displayname1

2.3.2  privacy

实质也是checbox的类型，只是displayname具有了一个链接效果，格式为：linktext：url

2.3.3  radio buttons

default value配置：value1|value2|value3|...

2.3.4  select box

default value配置： value1:displayname1|value2:displayname2|...与checkbox一致

2.3.5  table filed

default value配置：%(column1,column2,...|row1,row2,...)column_element1,column_element2,...row_element1,row_element2,...