SMARTE智能生成平台v0.1产品使用手册
二〇一四年一月
文档说明
文档类别
编号：
文档密级：
使用人员
本文档使用人员包括：
平台使用人员
版本更新
版本更新记录如下：
版本号修改日期修改人修改内容概述V0.92013.12.26吴渭明初版
V0.12013.1.6吴渭明修改
目录
1.概述 (1)
1.1平台概述 (1)
1.2平台愿景 (2)
1.3平台特性 (2)
2.使用流程 (2)
3.安装部署 (3)
3.1所需要的软件 (3)
3.2D ATA B ASE脚本安装 (3)
3.3系统全局参数配置 (4)
3.4系统启动测试 (4)
4.SMARTE通用用户权限系统 (5)
4.1用户组织数据的导入 (5)
4.2角色权限设置 (7)
5.SMARTE代码生成系统 (8)
5.1字段可视化设计 (8)
5.2前后端代码生成 (9)
5.3表单可视化设计 (10)
6.SMARTE流程管理系统 (13)
6.1流程定义 (13)
6.2流程与表单的集成 (13)
7.SMARTE二次开发指南 (15)
7.1模块管理 (15)
7.2增加表单组件 (16)
7.3后台数据的CURD和前台的处理 (17)
8.SMARTE常用API (17)
8.1界面控制类 (17)
8.2数据类 (17)
1.概述
1.1平台概述
SMARTE是一款基于JAV AEE的跨平台、数据库和浏览器的WEB应用开发平台。
实现“标准功能可复用、通用模块可配置、业务流程可定义、快速响应行业需求”的目标。
1.2平台愿景
希望通过项目的积累，平台能够满足客户的各种信息化需求,实现开发人员的零编程、一键跨平台、快速响应需求的智能开发平台！
1.3平台特性
支持多种数据库
平台能够使用mysql,oracle,db2,sqlserver作为数据源。
自动的代码生成模块
平台能够生成项目90%的前、后台代码。
丰富的组件库
包含了复杂的树、下拉树、下拉表格、附件管理组件等。
通用权限管理模块
基于最新的RBAC模型，实现了用户、组织、角色、权限的管理。
开发应用简单快速
项目组只需要关注业务需求。
2.使用流程
SMARTE平台的使用，使研发阶段更加强调与客户的沟通，通过SMARTE平台的使用，能够快速形成一个可用原型，使得用户能够成为开发的参与者，提高客户满意度。
并且通过平台的使用，使公司能够快速响应市场需求，并把握研发节奏，保障产品质量。
图1SMARTE平台使用流程
3.安装部署
3.1所需要的软件
JDK6+
SMARTE平台支持jdk1.6\1.7。
下载地址:Oracle Java SE downloads
Eclipse Juno
SMARTE平台能够在Eclipse Juno SR2版本中运行.
下载地址:Eclipse Juno SR2
Graphiti0.8+
在安装SMARTE流程设计器插件之前先要安装Graphiti框架。
下载地址:Graphiti框架安装连接
Groovy Eclipse Plugin4.2and3.8(Juno)
在安装SMARTE流程设计器插件之前先要安装Groovy Eclipse Plugin。
下载地址:Groovy Eclipse Plugin安装连接
FixFlow Eclipse Plugin(Juno)
完成Graphiti及Groovy Eclipse Plugin安装之后就可以安装SMARTE流程设计器的Eclipse插件。
下载地址:Eclipse Eclipse Plugin
Tomcat6+
为了完成平台的发布，eclipse需要对tomcat进行配置，SMARTE平台支持tomcat6+以上版本。
下载地址：tomcat
3.2DataBase脚本安装
获取平台安装包后，可在db目录下获取对应数据库所要执行的脚本，执行完即可。
3.3系统全局参数配置
数据库连接接配置
打开src目录下的smarte.properties,如图：
对如下进行配置：
3.4系统启动测试
导入到eclipse上，发布、启动tomcat，在浏览器输入:localhost/smarte（若tomcat 端口不是80，请加上端口）
若看到这样的界面，表示您的平台搭建已经完成。
4.SMARTE通用用户权限系统
4.1用户组织数据的导入
为了保证数据的正常运行，请先导入组织的数据。导入流程如下：
1)下载导入模版
打开平台的“组织管理”模块，如下图：
点击“组织分类”栏中的excel图标，会弹出如下对话框：
点击“导入模版下载”,打开模版后，请保持第一列不变（第一列数据说明：organid 是组织id(6位数字)，uporganid是父组织id（顶级组织的父组织id是000000）,organname 是组织名称（不能为空），后面的routeid及routename置空)。下面是一个填写的例子：
上传导入后，得到如下结果表示导入成功：
用户表的导入同上，下面附上用户表的导入模版说明：
userid为登录名(不能为空，不能重复)，password为md5值（可以为空，为空时密码是123456），username是系统显示的名称(不能为空)，organid是用户所属组织的id（不能为空，且必须存在），其它项可以不填。下面是一个填写的例子：
4.2角色权限设置
角色的创建和设置。打开位于“系统管理”下的“角色管理”，如图所示：
点击“角色管理”的工具栏可对角色进行增删改查。特别注意角色的模版访问编辑在“模块权限分配”和“数据权限分配”栏。
模块权限的分配。选中需要分配模块权限的角色行。该角色可视的模块上打上勾，点击“模块权限分配”标题旁的保存按钮即可。
数据权限分配。选择需要分配数据权限的模块，勾选该模块对应的“增删改查”，点击“模块权限分配”标题旁的保存按钮即可。
举例：该图，显示了为“普通用户”的“日志测试”模块，增加“改”的数据权限。
5.SMARTE代码生成系统
5.1字段可视化设计
字段可视化设计。打开位于“开发视图”下的“业务模块设计”，如图所示：
在“数据库表列表”中选择并且点击你所要进行字段设计的数据表。
在“字段列表”中选中你所要设计的字段。
依次对字段列表中的字段进行设计。
设计步骤：
在“控件类型”中选择该字段所需要的控件类型。
选择“控件类型”后，对弹出的属性进行填写。（注：点击“帮助”按钮可查看填写说明）
点击“更新”按钮，对字段的设计进行保存。
5.2前后端代码生成
后端代码的生成。打开位于开发视图的“业务模块设计”模块。在“数据库列表”
中选择需要生成后端代码的表，然后勾选“表设计”工具栏中需要生成的代码模块，如“数据模型、服务接口、控制器”，然后点击“生成代码”。刷新eclipse项目代码目录，即可出现您想要生成的代码。
前端代码生成，在选择“数据库列表”中对应的表后，选择“字段列表”中对应的字段，进行“字段设计”（参考字段可视化设计），完成所有字段设计后，勾选“表设计”工具栏的“页面、系统路由”，点击“生成代码”,刷新eclipse项目代码目录，即可出现您想要生成的代码。
完成以上步骤，重启tomcat或者其它web服务软件，然后，打开“系统管理”的模块管理模块，在任意父模块下新建模块，输入链接“/sys/syParameter_Go_表名首字母大写”（每个单词的首字母都需大写，并除去下划线），即可访问到你生成的页面。
如图，下面是生成的“日志测试”模块：
5.3表单可视化设计
在进行完以上操作后，您还不能对表单进行“增删”操作，因为您在点击“新建”
时，会出现空表单，如图：
接下来的步骤，我们进行表单的设计，首先打开“开发视图”的“表单设计”模块：
填入表格ID值及字段数据值，我们打开eclipse的项目目录，打开页面，如图：
填入后，会出现以下结果：
平台会统计，字段数、显示隐藏字段。然后您可以根据您表单的设计输入，表单的“行”、“列”值，因为例子为6个字段，3个为隐藏字段（显示红色），表单设计为2列、3行:
拖入数据菜单的字段到设计区域的表格中：
然后，点击“设计表格”，进行样式编辑后，点击“html数据表格”,ctrl+a全选拷贝：
拷贝代码到页面：
“”和“”
之间即可，然后刷新页面，点击“新建”即可看到您设计的表单：
编辑表单同上。
6.SMARTE流程管理系统
6.1流程定义
请参考附件的《SMARTE中流程引擎的使用》
6.2流程与表单的集成
所有平台生成的代码默认与流程引擎是集成的，在流程引擎的任意地方都可以调用，当然调用最多的是表单，新建表单的调用，只需要在系统路由的链接后面加上pview=add即可。例如：
当然pview还有很多参数，list是数据列表，edit是编辑界面（需带id参数）。
在流程控制方面，表单可自定义任意按钮，定义界面如下，例如定义一个“测试按钮”：
发布流程后，执行到该节点：
可以看到该按钮。该按钮执行的命令可以是：
当然也可以自定义。（详情请参阅附件《SMARTE中流程引擎的使用》）。7.SMARTE二次开发指南
7.1模块管理
平台处于用户易用角度，主菜单采用二级目录，平台开发使用者可任意增加自己的模块，并设置权限。
7.2增加表单组件
假如您需要增加表单组件，请先熟悉平台已有的组件，假如真的不能满足您现在的需求的话，请按一下步骤：
增加组件类型
平台代码core.js中的eType定义了控件类型，如下：
请不要重复。
增加set,get方法
在平台代码core.js中的eSet、eGet方法中定义该组建的get和set方法。
增加样式
在平台代码core.js中的getEtypeClass方法中，返回该组件的样式类名。
增加生成html构建方法
在平台代码SyFormDesign.jsp中的gFieldhtml方法增加html构建方法。
7.3后台数据的CURD和前台的处理
同ssh操作。
8.SMARTE常用API
8.1界面控制类
在生成的页面链接中加入pview参数，可控制页面显示的视图：
pview作用参数
add跳转到页面的新建视图无
edit跳转到页面的编辑视图附加Id参数，表明编辑哪一
项
list跳转到页面的数据列表视图
8.2数据类
data(url,dataobj,datatype,callback)：作用获取后台数据，url是action的fweurl，dataobj 为参数，datatype为返回值的类型，callback为服务器响应后前台的回调函数。