应用创建完毕后，如果注册时申请了API，API审核通过后，可获取开发文件，即app_info.xml文件。利用该文件可以在EMAP平台进行应用的开发。应用开发完毕后得到应用包，在云端完成应用包的上传，上传完毕后，可将应用接入到学校（目前是否可接入学校和应用包是否上传无关，比如移动应用没有对应的应用包）。新添加的一项功能是，应用创建时，根据当前用户的默认业务域，向wisedu开发总线给当前应用添加该业务域。

应用接入时，生成发布证书写给总线，向学校对应的门户发送应用信息，向学校对应的门户下发应用资源信息（图标、应用快照图片、发布证书等），更新云端的数据库中的接入记录。应用接入正式学校后，不能编辑相关应用包，防止实施人员获取到不一致的应用包。

3.2创建流程示例

1．登录http://www.campusphere.cn/appcenter/login

2．登录完毕后

3．点击创建应用

目前可以选择3种类型：网页、移动、网页+移动

这里以网页应用为例

4．选择网页后点击确定

保存后的页面

根据提示填写对应表单信息，这里创建应用名称为bldxfw的网页应用。

注意：

a、【缩写名称】与工程名称保持一致；

b、授权地址，如果与funauthapp集成，需要配置如下地址。否则无需配置。

/sys/funauthapp/qxgl.do?appId=4763514653390885&appName=bldxfw&min=1修改

appId与appName;

c、这里选择创建测试应用，即是否测试选择否;

d、入口地址/sys/bldxfw/*default/index.do默认修改bldxfw为工程名称.

5.接口注册，如果需要用到公共数据，打开ＡＰＩ申请开关，选择相应ＡＰＩ接口，

比如：人员基本信息、单位信息、消息信息、权限信息等。

接口说明文档请参看《ＡＰＩ接口说明》

接口使用方式，请参看《服务总线-API服务调用开发手册_V1.0》

5．填写完毕后，点击保存。

6.点击获取开发文件，如果注册应用时申请了API并审核通过或者没有申请API，均可下载对应的开发文件

7.下载完毕后，获取到了app_info.xml文件，使用该文件在EMAP平台进行开发。开发完毕得到应用包（打包方法见第5章）。

8.在该界面上传点击应用包管理，添加应用包。

9.使用接入管理菜单，可将该应用接入到“项目测试部”。

10.如果在注册时选择的是非测试应用，则应用注册后，实施人员便可在正式环境中进行应用接入，没有走上述测试应用在云端开发环境中应用包上传、接入测试学校、回推发布到正式环境的过程。

11.在云端开发环境下，可以进行应用包多次上传，不受是否已经接入到测试学校的约束以及应用是否已经下载的约束。应用从开发环境发布到运行环境后，表明已经发布，不能修改该版本的应用的测试状态。首次创建应用，如果由于误操作导致创建了测试应用，想修改为正式应用，可直接点击编辑应用编辑该状态（在开发环境中没有进行上传应用包的情形下可编辑该状态）。

12.应用进行新版本的开发时，可在appcenter正式环境下点击创建新版本的链接

新版本的应用创建和应用第一次创建类似，这里不再赘述。

4开发

4.1开发规范说明

1、app命名，中文名工程名自定义，工程名统一小写，可包含下划线。避免其他字符。

2、开发人员打包前，所有源码上传至http://172.16.1.91/outproject/op/02branches/学校名称/项目名称svn账号，请找吴芳开通。

3、开发前端框架及组件，请遵循金智前端开发框架Ubase开发规范，前端支持网站res.wisedu.com.公开账号tt/Hill.请尽量使用公司已有的公共组件进行开发，使用非前端公示的组件平台拒绝提供技术支持。

4.2公共数据

公共数据有一下两种处理方式，在开发前，开发方、平台放、需求方共同选择方案

方案一、统一使用总线接口获取公共数据

方案二、使用现场数据集成的方式获取公共数据,平台提供的公共数据结构如下:

序号	表名称	表含义	所在文件	说明
1	T_CROWD_DW	单位表	T_CROWD_DW.sql	现场实施人员操作该表实时同步数据
2	T_CROWD_RY	人员信息表	T_CROWD_RY.sql	现场实施人员操作该表实时同步数据
3	T_ZXBZ_XZQH	行政区划	T_ZXBZ_XZQH.SQL	脚本中有发版时的国标数据，现场实施操作该表与主数据进行同步
4	T_ZXBZ_MZ	民族	T_ZXBZ_MZ.sql	脚本中有初始化数据，现场实施操作该表与主数据进行同步
5	T_CROWD_ZD	字典表	T_crowd_zd.sql	脚本中有初始化数据
5	T_ZXBZ_XB	性别	T_ZXBZ_MZ.sql	脚本中有初始化数据，现场实施操作该表与主数据进行同步
6	T_CROWD_ZY	专业	T_CROWD_ZY.sql	现场实施人员操作该表实时同步数据
7	T_CROWD_BJ	班级	T_CROWD_BJ.sql	现场实施人员操作该表实时同步数据
8	T_CROWD_ZC	职称	T_CROWD_ZC.sql	现场实施人员操作该表实时同步数据
9	T_ZXBZ_XSLB	学生类别	T_CROWD_XSLB.sql	现场实施人员操作该表实时同步数据

请下载

4.3权限集成

权限统一使用funauthapp进行权限集成。请从下载funauthapp开发包，放到底座公共应该用所在的workspace中。

集成步骤:

Step1:确认app已经在amptests.wisedu.com注册成功，已接入到测试环境，上线，并且已经部署基础包。（此步骤由平台完成）；

Step2:拿到开发文件app_info.xml，根据文件创建本地应用。

Step3:创建app工程后修改3个配置项

（1）index.epg,如下图所示，添加4个参数。ROLEID、USERNAME、USERID、CURRENTDATE

（2）index.jsp，拷贝下面内容覆盖index.jsp

<%@pagelanguage="java"contentType="text/html; charset=UTF-8"pageEncoding="UTF-8"%>

<%@pageimport="java.util.*"%>

<%@tagliburi="/WEB-INF/tags/emap.tld"prefix="e"%>

<%

String appname= com.wisedu.emap.pedestal.core.AppManager.currentApp().getName();

String appId = com.wisedu.emap.pedestal.core.AppManager.currentApp().getId();

String path = request.getContextPath();

String ROOT_PATH = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/sys/"+appname;

%>

<e:callid="ProDataLoad"method="server_path"var="server_data"/>

<%

String SERVER_PATH= (String)request.getAttribute("server_data");

%>

<!DOCTYPEhtml>

<htmllang="zh-CN">

<head>

<metacharset="UTF-8">

<metaname="renderer"content="webkit">

<metahttp-equiv="X-UA-Compatible"content="IE=edge">

<metaname="viewport"content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">

<scriptsrc="<%=SERVER_PATH%>/fe_components/commonlib.js"></script>

<scriptsrc="<%=SERVER_PATH%>/fe_components/appcore-min.js"></script>

<scripttype="text/javascript">

var pageMeta = <e:page/>;

var contextPath = "<%=request.getContextPath()%>";

var serverPath = "<%=SERVER_PATH%>";

window.WIS_CONFIG = {

ROOT_PATH: "<%=ROOT_PATH%>",

PATH: "<%=path%>",

APPID: "<%=appId%>",

APPNAME:"<%=appname%>"

}

var roleId = pageMeta.params.ROLEID;

var userId = pageMeta.params.USERID;

var userName = pageMeta.params.USERNAME;

</script>

</head>

<body>

</body>

</html>

3、config.js拷贝下面内容覆盖config.js

define(function(require, exports, module) {

varconfig = {

业务线开发模式，转测时置false

"DEBUG_MODE":true,

资源服务器地址

"RESOURCE_SERVER": serverPath,

*主题blue purple

"THEME":"purple",

服务器端生成配置API(API_BASE_PATH目录下)

@example "/config.do" ./mock/serverconfig.json

"SERVER_CONFIG_API": WIS_CONFIG.PATH +"/sys/funauthapp/api/getAppConfig/"+ WIS_CONFIG.APPNAME +"-"+ WIS_CONFIG.APPID +".do",

APP默认路由

'APP_ENTRY':"",

APP标题

"APP_TITLE":"学生基本信息管理",

应用底部说明文本

"FOOTER_TEXT":"",

头部配置

"HEADER": {

"dropMenuCallback":function(item){

if(item.id == roleId){

returnfalse;

}

varurl = WIS_CONFIG.PATH +"/sys/funauthapp/api/changeAppRole/"+ WIS_CONFIG.APPNAME +"/"+ item.id +".do";

$.ajax({

url: url,

type:'post',

async:false,

error:function() {

$.bhDialog({title:'切换失败',iconType:'warning'});

success:function(data) {

if(data && data.success ==true) {

location.href = WIS_CONFIG.PATH +"/sys/"+ WIS_CONFIG.APPNAME +"/*default/index.do";

}else{

$.bhDialog({title:'切换失败',iconType:'warning'});

window.location.reload();

}

});

}

};

returnconfig;

});

4、创建config目录，创建permission.xml文件。以下是demo,请参考permisson的配置手册进行各个属性配置。

<permissionsprefix="">

<permissionname="qxgl"cn="权限管理"menu="true">

<attributename="LX"value="1"/>

<attributename="GNBS"value="qxgl"/>

<attributename="PX"value="99"/>

<pathvalue="/sys/funauthapp/qxgl.do"type="other"needLogin="true">

<paramname="min"value="1"/>

<paramname="appId"value="4827350524723290"/>

<paramname="appName"value="crowdggfw"/>

</path>

</permission>

<permissionname="jbxxwh"cn="基本信息维护"menu="true">

<attributename="LX"value="1"/>

<attributename="GNBS"value="jbxxwh"/>

<attributename="PX"value="1"/>

<pathvalue="/sys/studentmanage/modules/jbxxwh.do"type="normal"needLogin="true"/>

<pathvalue="/sys/studentmanage/modules/jbxxwh/T_PXXX_XSJBXX_SAVE.do"type="normal"needLogin="true"/>

<pathvalue="/sys/studentmanage/modules/jbxxwh/T_PXXX_XSJBXX_QUERY.do"type="normal"needLogin="true"/>

<pathvalue="/sys/studentmanage/modules/jbxxwh/T_PXXX_XSJBXX_DELETE.do"type="normal"needLogin="true"/>

</permission>

<pathvalue="/sys/crowdggfw/*default/index.do"type="global"/>

<pathvalue="/sys/funauthapp/qxgl.do"type="global"/>

<pathvalue="/sys/crowdggfw/message/sendToUser.do"type="global"/>

<pathvalue="/sys/crowdggfw/message/sendToGroup.do"type="global"/>

<pathvalue="/sys/crowdggfw/message/sendToDw.do"type="global"/>

</exclude>

</permissions>

5、配置结束后，启动或重启tomcat,访问：

http://localhost:8080/emap/sys/funauthapp/qxgl.do?appId=4835228248643398&appName=hjgl

appId与appName换成需要开发的appId与appName;

4.4报表开发

EMAP中集成的是帆软报表（http://www.finereport.com/products/trial），帆软报表的设计器需要自己下载、帆软报表使用，下载工具后可从帆软报表官网获取使用手册，开发好的报表文件拷贝到工程配置的目录中使用。

4.4.1报表安装

1、拷贝frReport2目录到emap环境的应用目录下。如果是压缩包，请先解压，然后再拷贝；如果原来的应用目录下有frReport2，请先删除。

2、启动后，请访问【服务器地址】/emap/sys/frReport2/show.do，确保frReport2已经成功安装并启动。

4.4.2运行环境配置

4.4.2.1设置报表访问权限配置- fr_app_mapping.properties (必须)

在ROOT目录下，必须有fr_app_mapping.properties文件，否则访问任何报表时都会报无权限错误。详细功能请参考帆软报表功能说明书。

4.4.2.2帆软授权文件- FineReport.lic（必须）

位于frReport2\WEB-INF\resources目录

4.4.2.3业务数据源配置- datasource.xml（必须）

位于frReport2\WEB-INF\resources目录，帆软报表需要直接访问业务系统的数据，必须在datasource.xml中指定数据库访问信息。

注意：报表的数据名称与app数据源的编号保持一致。

4.4.2.4外部cpt文件目录设置- JZReportletConfig.xml（可选）

位于frReport2\WEB-INF\resources目录，由业务系统在设计器中制作的cpt文件，可以放置在frReport2目录之外，通过JZReportletConfig.xml中路径设置来指定。

配置报表文件放置的目录，目录统一设置在工程目录/web/cpts

报表接入工程JS代码中显示报表，例如：

function printBz(){

var url = "../frReport2/show.do?reportlet=com.fr.JZ&cpt=gwjd.cpt&wid="+jbxx_wid;

var html = '<iframe width="100%" height="800px" src="' + url + '" frameborder="no" border="0" marginwidth="0" marginheight="0" scrolling="no"</iframe>';

window.open(url)

}