EMAP开发

EMAP 二开开发教程

2020-12-02 11:11

EMAP 二开开发教程

版本记录

序号	修改人	修改内容	批准人	生效日期
1	赵业峰	新建
2		增加各类文件合并或覆盖的说明

第一章各类文件的覆盖或合说明

1、会合并的文件

扩展的数据模型文件：.edmx

扩展的业务模型文件：.epmx

spring的配置文件：config/spring.xml

i18n的配置文件：config/i18n.xml, config/i18n_XX.xml

eterna的配置文件：config/eterna.xml

权限的配置文件：config/permission.xml

2、会覆盖的文件

除了上面这些文件会合并外，二开应用中的其他文件都是覆盖的。

如：未扩展的数据/业务模型文件、java文件、js文件等，都是覆盖同目录下的同名文件。

3、不会生效的文件

新增的jar包：lib/*

应用信息文件：app_info.xml

以上这些文件在二开的应用中是无效的，系统不会读取这些文件。

第二章二次开发扩展功能介绍

4、 EMAP应用扩展

对EMAP应用进行二次开发，需要首先建立扩展应用。步骤如下：

1. 选中需要扩展的工程，右键àEMAP扩展应用

2. 单击弹出信息框（应用名称默认为被扩展应用名加上$A后缀）

3. 点击完成按钮，生成工程

5、数据模型扩展

2.1、新建扩展数据模型

对扩展应用数据模型扩展，需要建立扩展数据模型。步骤如下：

1. 选择扩展应用下的数据模型à右键数据模型扩展

2. 在弹出框中选择需要扩展的数据模型（单选）

3. 单击完成按钮

2.2、扩展数据字段属性

只有扩展字段才能扩展字段属性，非扩展字段和原模型属性保持一致。

在数据模型上选择需要扩展的字段
在工具栏上单击，启用扩展字段按钮

扩展字段图标为绿色

修改字段中文和分组

选中扩展字段，中文名称和分组项可以直接编辑扩展

修改字段属性（具体属性内容，参考属性文档）

选择扩展字段，修改属性。属性视图会提供原始值，便于扩展比较

2.3、删除扩展字段

1. 选择扩展字段

2. 单击工具栏中删除按钮

3. 单击确定（图标成黄色，成为非扩展字段，属性和原模型一致）

2.4、扩展字段排序

扩展数据模型可以通过上下移动按钮，重新调整字段的顺序

2.5、扩展行过滤权限

1. 单击行过滤权限按钮

2. 编辑过滤权限内容，（选中关联角色，只能选择本扩展应用中的角色）

3. 单击完成

2.6、扩展查询排序

1. 单击添加

2. 在弹出的框中，勾选排序列

3. 单击完成

6、业务模型扩展

3.1、新建扩展业务模型

1. 选择扩展应用下的业务模型à右键业务模型扩展

2. 在弹出框中选择需要扩展的业务模型（单选）

3. 单击完成按钮

3.2、扩展业务字段属性

只有扩展字段才能扩展字段属性，非扩展字段和原模型属性保持一致。

在业务模型上选择需要扩展的字段
在工具栏上单击，启用扩展字段按钮

扩展字段图标为绿色

修改字段中文和分组

选中扩展字段，中文名称和分组项可以直接编辑扩展

修改字段属性（具体属性内容，参考属性文档）

选择扩展字段，修改属性。属性视图会提供原始值，便于扩展比较

3.3、添加业务字段

点击新增业务字段按钮

字段列表会新增一条信息，新增字段为灰色图标

3.4、删除扩展字段

通过删除按钮可以删除扩展字段或者自定义添加字段。

选择要删除的字段，单击工具栏删除按钮

在弹出的确认框中，确认删除字段

完成删除字段

如果删除的扩展字段，列不会删除，属性值将重置和原始模型保持一致（图标从绿色还原成黄色）

3.5、扩展字段排序

扩展业务模型可以通过上下移动按钮，重新调整字段的顺序

7、动作模型扩展

4.1、新建动作模型扩展

1. 在扩展应用下自定义动作à自定义动作扩展

2. 在弹出的向导框中选择需要扩展的自定义动作

3. 单击完成按钮，完成动作扩展（扩展文件会把原模型中的内容和目录的层级结构完整复制过来便于开发人员调整）

8、动作流模型扩展

5.1、新建动作流模型扩展

1. 在扩展应用下选择动作流à动作流扩展

2. 在弹出的向导框中选择需要扩展的动作流

3. 单击完成按钮，完成动作流扩展（扩展文件会把原模型中的内容和目录的层级结构完整复制过来便于开发人员调整）

9、页面模型扩展

6.1、新建页面模型扩展

1. 在扩展应用下 web文件夹à页面扩展

2. 在弹出的向导框中选择需要扩展的页面模型

3. 单击完成按钮，完成页面扩展（扩展文件会把原模型中的内容和目录的层级结构完整复制过来便于开发人员调整）

【关闭窗口】

EMAP 二开开发教程

第一章 各类文件的覆盖或合说明

1、 会合并的文件

2、 会覆盖的文件

3、 不会生效的文件

第二章 二次开发扩展功能介绍

4、 EMAP应用扩展

5、 数据模型扩展

2.1、 新建扩展数据模型

2.2、 扩展数据字段属性

2.3、 删除扩展字段

2.4、 扩展字段排序

2.5、 扩展行过滤权限

2.6、 扩展查询排序

6、 业务模型扩展

3.1、 新建扩展业务模型

3.2、 扩展业务字段属性

3.3、 添加业务字段

3.4、 删除扩展字段

3.5、 扩展字段排序

7、 动作模型扩展

4.1、 新建动作模型扩展

8、 动作流模型扩展

5.1、 新建动作流模型扩展

9、 页面模型扩展

6.1、 新建页面模型扩展

第一章各类文件的覆盖或合说明

1、会合并的文件

2、会覆盖的文件

3、不会生效的文件

第二章二次开发扩展功能介绍

5、数据模型扩展

2.1、新建扩展数据模型

2.2、扩展数据字段属性

2.3、删除扩展字段

2.4、扩展字段排序

2.5、扩展行过滤权限

2.6、扩展查询排序

6、业务模型扩展

3.1、新建扩展业务模型

3.2、扩展业务字段属性

3.3、添加业务字段

3.4、删除扩展字段

3.5、扩展字段排序

7、动作模型扩展

4.1、新建动作模型扩展

8、动作流模型扩展

5.1、新建动作流模型扩展

9、页面模型扩展

6.1、新建页面模型扩展