《金智教育》

EMAP开发入门教程

 

 

1    前言

首先欢迎你加入我们团队成为其中的一员，为了能使你尽快的融入到工作当中，请你认真的阅读完本文档中的每一章，这样才能避免你在开发的过程中浪费太多的时间去排查问题。

1.1 规范预警

请仔细阅读文档【0. 软件技术规范.docx】

请仔细阅读文档【1. 开发编码规范.docx】

请仔细阅读文档【2. 轻应用开发样式表.docx】

2    开发入门

2.1 连接VPN

2.1.1      安装VPN

运行EasyConnectInstaller.exe，安装好连接vpn的工具。

2.1.2      连接VPN

VPN地址：https://vpn.wisedu.com

用户名/密码：待分配

2.2 登入云桌面

2.2.1      连接云桌面

输入云桌面的地址：https://172.16.60.100

输入登录的信息，下载客户端来使用。

2.2.2      登录云桌面

用户名/密码：待分配

2.2.3      配置代理

打开D:/EMAP/studio/studio.ini

-DproxySet=true

-DproxyHost=172.16.4.111

-DproxyPort=808

2.2.4      IE浏览器配置代理

对SVN的服务器进行过滤，IP为172.16.5.5

2.2.5      安装最新的chrome浏览器

双击/安装包/76.0.3809.100_chrome_installer_32.exe

2.3  配置数据库

2.3.1      配置TNS

C:\oracle\product\10.2.0\client_1\NETWORK_ADMIN下创建tnsnames.ora

CI_LWS   =                           (DESCRIPTION =         (ADDRESS = (PROTOCOL = TCP)(HOST = 172.16.5.14)(PORT = 1521))         (CONNECT_DATA =           (SERVER = DEDICATED)           (SERVICE_NAME = urpdb)         )     )

2.3.2      数据库信息

用户名：dev

密码：admin123

2.4 重新安装emap

2.4.1      下载最新版emap

http://emap.wisedu.com/notifications/page/README.html

点击页面最下方有一个setup.exe的安装文件，安装地址定义为d:\new_emap

2.4.2      配置lombok

将安装包的lombok.jar拷贝到d:\new_emap\studio\下

接着配置studio.ini，在最后一行加上-javaagent:lombok.jar

2.4.3      配置数据源

配置DB_EMAP_BIZ_BASE

配置FUNAUTH_JNDI

记得刷新ROOT/jdbc.properties里的数据源

2.4.4      导入项目

●  funauthapp

●  itpub（svn://172.16.200.10/solution/itpub）

●  lwDemoBizPassportApplication

移动端地址：

http://localhost:8080/emap/sys/${projectname}/*default/index.do#/ 

PC端地址：

http://localhost:8080/emap/sys/${projectname}/index.do#/

授权地址：

http://localhost:8080/emap/sys/${projectname}/auth.do

流程管理地址：

http://localhost:8080/emap/sys/emapflow/tasks/queryMyTask.do

2.4.5      配置页面框架

将/安装包/versions.zip压缩包解压到d:/new_emap/emap_ui_framework/versions下

2.4.6      配置emap.properties

打开ROOT/emap.properties

emap.dao.defaultPageSize   = 999 emapvalidate.domains   = localhost, localhost:8081 funauthapp.styletype=0 funauthapp.func_permission_check=true funauthapp.authorized_user   = admin,ampadmin auth.adminUsers   = admin,ampadmin

2.5 Emap Studio使用

2.5.1      Emap是什么？

http://v.crowd.campusphere.cn/repositry/resource/v/1608/15/2b5f2345028149e1aa132d4bdb14a9be/360p.mp4

2.5.2      Emap架构图

http://v.crowd.campusphere.cn/repositry/resource/v/1608/15/2457a249968c4556a2de3c008212dfbb/360p.mp4

2.5.3      环境搭建

http://v.crowd.campusphere.cn/repositry/resource/v/1609/7/ead893993a7949bfa2657c18ed63d0b9/360p.mp4

2.5.4      创建ROOT工程

http://v.crowd.campusphere.cn/repositry/resource/v/1608/15/c609e57c7f9b43409ee17b2254d15495/360p.mp4

2.5.5      单表开发

●  开发体验

http://v.crowd.campusphere.cn/repositry/resource/v/1608/15/6580d2e2346e46d2af004778369a7180/360p.mp4

●  应用特征

http://v.crowd.campusphere.cn/repositry/resource/v/1608/15/61486a44128d4ec286b9b6fd09a3c98a/360p.mp4

http://v.crowd.campusphere.cn/repositry/resource/v/1608/15/1689714db6fe42a39b984b18d2b7f02c/360p.mp4

●  后端模型

Part1:http://v.crowd.campusphere.cn/repositry/resource/v/1608/15/d126db53bc7e4349a71ab6297e1d0bf8/360p.mp4

Part2:http://v.crowd.campusphere.cn/repositry/resource/v/1608/15/351b136002fa4e40843831e4d05d0eec/360p.mp4

Part3:http://v.crowd.campusphere.cn/repositry/resource/v/1608/15/eb222c8c5e90411aad7ab32947e40f4b/360p.mp4

Part4:http://v.crowd.campusphere.cn/repositry/resource/v/1608/17/79eaf537390449149031f93ba344fef2/360p.mp4

Part5:http://v.crowd.campusphere.cn/repositry/resource/v/1608/17/fb1777ae30834a36b3a3beca624becdc/360p.mp4

2.5.6      前端开发

前端开发的组件是基于RequireJS + jQuery + jqxwidgets，组件库可以通过以下地址访问：

http://res.wisedu.com/FS/docsite/

●  开发框架

http://v.crowd.campusphere.cn/repositry/resource/v/1608/22/2d132360853342da87f63dc90141f4af/360p.mp4

2.5.7      多表开发

●  自定义动作

Part1:http://v.crowd.campusphere.cn/repositry/resource/v/1608/17/d1fd88c3a5d142cca136cb7b38cd1399/360p.mp4

Part2:http://v.crowd.campusphere.cn/repositry/resource/v/1608/17/7766640c7e7747d0af00f5e9863307f1/360p.mp4

●  业务模型

Part1:http://v.crowd.campusphere.cn/repositry/resource/v/1608/17/ae913950a0314ec2800a0def6766b1a1/360p.mp4

Part2:http://v.crowd.campusphere.cn/repositry/resource/v/1608/17/69c69f67d9914bc1b6bda513f2e7bf93/360p.mp4

●  应用打包

http://v.crowd.campusphere.cn/repositry/resource/v/1704/7/8b96ca49c0b84726ad19c9bf44effb2b/360p.mp4

3    注意事项

3.1 项目创建

项目必须依赖于itpub，itpub是一个公共类库，里面集成了一些后端公共类和前端的公共页面与组件。

3.1.1      底座更新

请将版本更新至B159

3.2 数据模型维护

表命名请参考《开发编码规范.docx》

表模型设计不需要优先在数据库中创建对象，因为底座会根据我们的配置文件利用hibernate对数据表进行反向生成，所以我们只需要配置相应的映射文件即可。

举例：项目名称lwDemoBizPassportApplication

1）        在src下创建db.lwDemoBizPassportApplication

2）        在包下创建versionX.xml文件，其中X表示每一次更新的版本号。例如第一次就是1，如果你的数据库结构发生了变化，请继续在此目录下添加version2.xml文件，以此类推。

3）        在versionX.xml中设计表结构。谨记：表名、字段名、主键名、索引名称不允许超过30个字符

4）        启动服务，用以生成数据表。

如果生成失败，需要清除版本执行的数据

delete  from  emap_sys_version_info where versionname like '%lwDemoBizPassportApplication/lwDemoBizPassportApplication%'; delete  from  emap_sys_version_log where versionname like '%lwDemoBizPassportApplication/lwDemoBizPassportApplication%'; delete  from  emap_sys_version_script where versionname like '%lwDemoBizPassportApplication/lwDemoBizPassportApplication%'; delete  from    emap_sys_version_opt_log where versionname like '%lwDemoBizPassportApplication/lwDemoBizPassportApplication%';

3.3 打印报表集成

3.3.1      配置报表

●  创建ROOT/fr_app_mapping.properties文件，并配置以下参数

●  修改报表文件存放位置frReport2/WEB-INF/resources/JZReportletConfig.xml

●  设置数据源frReport2/WEB-INF/resources/datasource.xml

3.4 流程发布

4    发包流程

4.1 项目打包

4.1.1      打包结构

4.1.2      导出zip包

右击项目->导出->EMAP应用->XX.zip格式

4.1.3      替换app_info.xml

找接入的人获取云端的app_info.xml

替换掉XXX.zip包中app_info.xml

4.1.4      重新打包

创建一个与应用名称一直的文件夹，例如lwDemoPassportApplication，并在目录中创建好pc_deploy，将之前打包好的lwDemoPassportApplication.zip放到pc_deploy目录，再将app_info.xml文件也放入到与pc_deploy同一目录。

对pc_deploy目录和app_info.xml进行重新打包，生成lwDemoPassportApplication.zip

4.2 发包平台

代理过滤

地址：http://172.16.7.60:9080/package/sys/dzyyfbpt/login/index.do

4.3 登录信息

用户名：27151402@qq.com

密码：123456

4.4 发包操作

4.4.1      搜索学校

先根据自己的项目搜索到具体的学校，例如：浙江师范大学

4.5 上传应用包

点击学校下的“其他”，再点击右边部分的“上传应用包”按钮。

请参考如下图提交相关的信息