动态扩展平台标准版使用手册.doc

金蝶EAS 动态扩展平台标准版用户手册
动态扩展平台标准版
产品概述
金蝶EAS动态扩展平台是一个通过整合原有界面配置工具、动态查询以及插件机制等运行期定制能力，提供一体化的，动态的业务定制工具。其主要解决在不需EAS应用重新构建以及重启服务器的情况下，可以由最终用户（End User）、客户的IT专业人员、产品实施人员、二次开发人员对应用系统进行结构和行为调整，开发多套基于核心应用的特性包，以达到行业和个性化特性定制的目的。多个特性包可以相互依赖，并存使用。
动态扩展平台支持日常的客户化开发，开发内容以方案的形式存在，支持导入导出、启用反启用，无需部署安装即可应用于生产环境。其改变了实施现场的二次开发模式，解决了二次开发内容与标准产品间的矛盾，从而简化标准产品维护升级，加快现场实施进程。
技术架构
架构概念
客户化定制以及特性包我们都称为定制。客户化定制是在EAS产品的基础之上的修改定制，是属于某个特定客户的，只适用于该特定客户。
而特性包适用于所有客户或者特定的客户群。特性包是作为EAS产品的一部分的，它是建立在ECS（EAS核心系统）之上的。
BOS系统平台之上的EAS核心系统，动态扩展平台，加上一系列特性包组成了整个EAS系统。如图所示。

动态扩展方案存储和运行
动态扩展平台通过动态扩展方案来对系统进行修改。EAS静态逻辑通过访问加载动态扩展方案来运行定制系统。动态扩展方案使用基于数据库的存储方式存储管理，动态扩展方案存储在数据库帐套中。如图所示。

环境准备
同步菜单
请使用系统管理员（administrator）登陆系统，单击〖系统〗à〖客户化菜单编辑〗，如图所示。

在客户化菜单编辑界面，点击【菜单升级】，弹出客户化菜单升级窗口，选择升级方式为智能升级，点击升级。

完成智能升级客户化菜单后，客户化菜单如系统菜单一样，将动态扩展平台挂在【企业建模】-->【业务对象建模】下。

同步权限
完成客户化菜单升级后，单击〖应用中心〗à〖企业建模〗à〖安全管理〗à〖权限管理〗à〖用户管理〗。在“用户管理”页签，单击系统菜单【文件】，选择同步权限数据。

同步权限数据成功后，用户可以通过以下两种方式对用户进行权限分配。
方式一：请选中需要分配权限的用户，点击菜单【分配权限】。在“分配权限”窗口，左列为可授权项，右列为已分配项，选中〖动态扩展平台〗，点击【增加】，【保存】。

方式二：展开下拉菜单【分配权限】，选择【批量分配权限】，进行批量授权。如图所示，点击【选择组织】，勾选组织单元，点击【确定】。

完成授权分配后，用户需退出系统，重新打开客户端，启动登陆，权限方可生效。
注意事项：
分配组织必须是管理单元，否则可授权树中看不到动态扩展平台的权限项。

71
金蝶EAS 动态扩展平台用户手册
动态扩展方案管理
动态扩展方案是定制存储的基本单位。支持导入，导出，启用，反启用等操作。动态扩展方案间可以存在依赖关系，如果某方案被启用，则被依赖方案必须被启用。动态扩展方案可作为行业特性包或客户个性化开发包。
编辑动态扩展方案
用户点击【动态扩展方案管理】，系统弹出动态扩展方案管理界面，如图所示。

通过点击菜单栏【新增】，【修改】，【删除】按钮，可进行新增，修改，删除动态扩展方案操作。
单击【新增】按钮，在“动态扩展方案”界面，输入名称，别名，选择依赖方案，备注，其中名称，别名不能为空。 如图所示。

温馨提醒：
方案名称只支持录入英文字符和数字，不能录入中文字符。
标准产品的动态扩展方案不允许编辑和删除。
选中某一非启用的扩展方案，单击【修改】按钮，用户可以对别名，依赖，备注进行修改。如图所示。

同样，选中某一非启用的扩展方案，单击【删除】按钮，可以进行删除该扩展方案。
用户可以通过单击【刷新】按钮，重新加载动态扩展方案。
注意事项：
建议用户在执行删除动态扩展方案操作之前，对数据进行备份，避免丢失不可挽回的数据。
快速定位
进入动态扩展管理方案界面，如何在众多的方案中，快速地定位出指定的扩展方案？单击【定位】按钮，系统弹出“快速定位”界面，如图，输入定位内容，点击【定位】按钮。

启用 反启用
启用：使某个动态扩展方案中的定制内容生效。选中反启用的动态扩展方案，支持按住[Ctrl]键进行多选，单击【启用】按钮。
反启用：反启用某个动态扩展方案中的定制内容。选中启用的动态扩展方案，支持按住[Ctrl]键进行多选，单击【反启用】按钮。
如果动态扩展方案处于反启用状态时，用户对元数据进行添加，删除，修改等操作，系统只是对元数据执行相应的操作，并不会对业务数据进行修改。只有当动态扩展方案处于启用状态时，系统才会在物理数据库真正地添加、删除、修改数据表字段。
注意事项：
在生产环境请谨慎使用方案反启用功能，务必在确认该方案没有被其他内容引用的情况下再反启用。
导入 导出
导入：导入某个导出的动态扩展方案包。单击【导入】按钮，系统弹出“打开”窗口，选中需要导入的特性包，点击【打开】按钮。
导出：导出某个动态扩展方案包。方案包可导入到其他环境，且支持使用版本管理工具进行管理。选中动态扩展方案，单击【导出】按钮，系统弹出“保存”窗口，选择需要存放的路径，点击【保存】按钮。
注意事项：
一次只能导出一个方案。
建议用户在执行导入动态扩展方案操作之前，对原有的方案包进行备份，避免无法对数据进行回滚，减少不必要的麻烦。因为如果导入的方案包名已存在，系统将会覆盖原有的方案包。

金蝶EAS 动态扩展平台用户手册
扩展单元
在动态扩展平台中，进行定制的单元称为扩展单元，扩展单元作为现场定制的基本单元，是业务定制的最小范围，并提供相关的导航。
用户可以通过三种方式创建扩展单元：
1） 导入：导入标准产品的业务单元进行扩展；
2） 从模板复制：从动态扩展模板库复制新增扩展单元；
3） 空扩展单元。
导入
导入：导入已有的业务单元并对其进行扩展操作。
单击选中动态扩展方案，右击选择〖导入〗，系统弹出“选择业务单元”窗口，用户可以通过三种方式定位需要导入的业务单元。如图所示。

新建常用扩展单元
新建：从动态扩展模板库复制新增扩展单元。
单击选中动态扩展方案，右击选择〖新建〗à各种类型的模板，录入名称、别名，点击【确定】按钮。

新建空扩展单元
新建扩展单元：单击选中动态扩展方案，右击选择〖新建〗à〖空扩展单元〗，录入名称、备注，点击【确定】按钮。

目录操作
新建目录：单击选中动态扩展方案，右击选择〖新建〗à〖目录〗，系统弹出“目录”对话框，输入目录名称，点击【确定】按钮，将创建目录节点。
用户可以在新建目录中导入扩展单元。

修改目录：单击选中目录节点，右击选择〖修改〗，系统弹出“目录”对话框，可以对目录名称，备注进行修改，点击【确定】按钮。

删除目录：单击选中目录节点，右击选择〖删除〗，系统弹出确认删除提示信息对话框，点击【确定】按钮，将删除当前目录节点。

编辑界面
编辑界面布局分两类：标准界面和个性化布局方案。标准界面是每个编辑界面都存在的，可以查看和修改，没有组织属性。标准界面中，可以添加控件，删除控件，调整控件位置，扩展定义等。个性化布局方案可以调整控件位置，定义事件规则，按组织、用户分配等。通俗的讲，标准界面控制有没有的问题，个性化布局方案控制怎么展示的问题。
标准界面
属于系统级的，修改后对所有用户和组织生效。可新增控件、工具栏按钮、菜单项，设置控件属性，调整布局，添加绑定关系等。
新增字段
在编辑界面中，所有的控件罗列出在标准界面的右侧，称为控件树。只要单击所需的组件，并在编辑区域单击即可。

修改字段
选中字段，在界面底部的属性页签中，修改其属性值。

删除字段
单击选中控件或者按住键盘[Ctrl]键单击选择多个控件，点击【删除】按钮或者按键盘[Delete]键。系统会提示是否确认删除字段。
温馨提醒：
请小心使用这项功能。系统将会清除所有与该控件相关的引用信息。
设置Tab顺序
点击【设置Tab顺序】按钮，可设置运行EAS业务时按下[Tab]键，系统将光标聚焦到下一个控件的顺序。界面如下：

左边是界面控件列表；右边是功能按钮，供用户进行【向上】、【向下】、【置顶】和【置底】等操作。操作方式相同，下面以【向上】为例说明操作顺序：
1） 在左边列表选择某个需要修改顺序的控件；
2） 点击【向上】按钮；
3） 点击【确定】按钮；
4） 操作完成。
格式刷
1) 选择具有要复制格式的控件
2) 在工具栏上，点击【格式刷】，指针会变成一个刷子图标
3) 单击要设置格式的控件，如果要将格式应用到多个控件，请选择“格式刷”后按住[Ctrl]键依次选择它们
4) 按住[Esc]键或点击鼠标右键取消格式刷。
字段扩展属性
选中动态控件，切换至“字段扩展属性”页签，可新增、修改、删除其扩展属性。静态控件扩展属性不允许编辑。

1) 新增扩展属性：

2) 修改扩展属性值：

3) 删除扩展属性：

实体扩展属性
切换至“实体扩展属性”页签，可新增、修改实体扩展属性。

1) 新增实体扩展属性：

2) 修改实体扩展属性：

数据绑定
设置控件绑定的实体字段。这样在界面加载和保存时可以自动完成该字段的取值和保存。右击选择【数据绑定】，系统将返回“数据绑定”界面。
添加数据绑定信息：
在左控件树中，选中未添加数据绑定的控件，再点击选中右实体字段树中需绑定的字段，点击【】添加数据绑定信息。

温馨提醒：
右实体字段树中，蓝色高亮显示的字段为动态实体字段。
删除数据绑定信息：
在已绑定的控件列表中，选中动态绑定关系，点击【】删除数据绑定信息。

温馨提醒：
静态绑定关系不允许删除。
字段常用属性
修改控件显示文字
在“属性”页签中，用户可修改<显示文字>属性。

设置控件为必录项
在“属性”页签中，用户可修改<是否必录>属性，如果勾选，则运行时，该控件没有录入数据，点击【保存】或者【提交】时，系统返回“不能为空”错误提示信息。

设置格式化字符串
若要设置带小数点的数字的格式，请在格式化字符串的相应部分中包含下面的数字位置标识符。如果某一数字小数点右侧的位数大于所设定格式中位置标识符的位数，该数字将按位置标识符位数进行舍入。如果数字小数点左侧的位数大于位置标识符的位数，那么多余的位数也会显示出来。如果所设定的格式中小数点左侧只有一个数字符号 (#)，那么小于 1 的数字将以小数点开始。
Ø # （井号）：只显示有意义的数字而不显示无意义的零。
Ø 0（零）：如果数字位数少于格式中的零的个数，则 0（零）将显示无意义的零。
Ø .(点)：小数分隔符或货币小数分隔符。
Ø -（减号）
Ø ，（逗号）：分组分隔符。
Ø E：分隔科学计数法中的尾数和指数。
Ø %（百分号）：乘以 100 并显示为百分数。
Ø \u2：乘以 1000 并显示为千分数。
Ø ¤：货币记号，由货币符号替换。如果两个同时出现，则用国际货币符号替换。如果出现在某个模式中，则使用货币小数分隔符，而不使用小数分隔符。
Ø '（单引号）：用于在前缀或或后缀中为特殊字符加引号，例如 "'#'#" 将 123 格式化为 "#123"。要创建单引号本身，请连续使用两个单引号："# o''clock"。
举例：
若要
实现格式化字符串
将 1234.59 显示为 1234.6
####.#
将 8.9 显示为 8.900
#.000
将 .631 显示为 0.6
0.#
将 12 显示为 12.0 以及 1234.568 显示为 1234.57
#.0#
格式化字符串一般常用于以下两种场景：
1) 单据头数字类型控件：

2) 分录数字类型控件：

设置列表界面是否可见
列表界面是否可见：如果勾选，则系统会自动在列表界面添加同名列信息。

通用过滤
用户如果勾选“通用过滤”属性值，则运行期可在通用过滤界面上使用该字段自定义的过滤条件。

个性化布局方案
编辑界面支持多种布局，仅可以在个性化布局方案中进行特性设置，如：控件的可见/可用性，位置，大小等，并将个性化布局方案分配到特定的组织或用户，实现个性化展示。
注意事项：
个性化布局方案需启用并分配后才能运行生效。
新增
点击【新增】，录入个性化布局方案名称，点击【确定】。即可显示个性化布局方案维护界面。新增个性化布局方案默认置为启用状态。

修改
选中状态为反启用的个性化布局方案，点击【】，来维护个性化布局方案。

查看
点击【】查看个性化布局方案。
删除
选中状态为反启用的个性化布局方案，点击【】删除个性化布局方案。
启用
选中状态为反启用的个性化布局方案，点击【】启用个性化布局方案。
反启用
选中状态为启用的个性化布局方案，点击【】反启用个性化布局方案。
设置优先级
选中需要配置优先级的个性化布局方案，点击【】进行设置。优先级从1到10逐级递减。
分配
选中需要分配的个性化布局方案，点击【】进行分配，系统以向导的形式供用户选择。
分配类型包括：
1） 用户分配：分配给该用户后，其在所有的组织下运行，该方案有效。
2） 组织分配：分配给该组织后，登录该组织的所有用户运行该方案。
3） 组织加用户分配：对被分配的用户登录到指定的组织后，该方案有效。
对于一个界面的多个用户方案，运行时选择哪个方案的优先级为：
1） 当存在“组织加用户分配”方案时，其优先级最高；
2） 如不存在“组织加用户分配”方案时，且“组织分配”和“用户分配”并存时，按个性化布局方案设置的优先级来判定。

温馨提醒：
个性化布局方案按组织分配时，所选组织类型是由单据的主业务组织决定的，而单据的主业务组织是由单据决定的，具体应用时是指只有在已分配的组织下，单据方案才能应用。
查看分配明细
选中个性化布局方案，点击【】查看分配明细。

取消分配
在“用户分配明细查看”界面，选中分配信息，点击【取消分配】来取消已被分配的信息。

属性设置
选中控件，可设置其各项属性值。

属性名称
属性用途
可见
控件在运行期是否为可见状态
可用
控件在运行期是否为可编辑状态
必录
控件在运行期是否为必录项
通用过滤
运行期是否可在通用过滤界面上使用该字段自定义的过滤条件
显示文字
控件显示文字
显示文字下划线
控件是否展示下划线
显示文字长度
设置显示文字和控件之间的长度
显示文字方向
显示文字的方向，包括：左、右、上、左上、右上
水平对齐方式
设置运行期录入控件文字的显示方向，包括：左对齐、居中、右对齐
X坐标
设置控件的x坐标值
Y坐标
设置控件的y坐标值
宽度
设置控件的宽度
高度
设置控件的高度
锚定
外层容器布局为KDLayout时，可设置该控件与其所在容器的边距锚定。
格式化字符串
字符串格式化
默认值
当控件已经完成数据绑定，可设置其默认值
事件
当控件已经完成数据绑定，可对该控件设置事件规则
绑定实体字段
查看数据绑定信息
事件管理
事件目前有保存事件、更新事件和加载事件。各个事件的触发时刻和主要用途如下表：
规则事件
事件触发时刻
事件主要用途
加载
在界面打开显示时
定义界面初始化逻辑。如设置菜单属性；设置界面初始化属性等。
更新
当界面控件内容修改后，失去焦点时
定义在控件的值更新后需要处理的一些逻辑。如通过计算公式，计算出另一个字段的值；携带基础资料的相关属性到另一个字段上。
保存
当前界面保存时
对录入数据的合法性及完整性做检查。
单据头控件：
单击选中控件，在“属性”页签中，点击【事件】属性，系统将弹出“事件”界面。

分录字段：
单击选中分录，右击选择【编辑表信息】；
在“表格设置”界面，选中需要添加事件的字段，点击【事件】。

下面我们将用一个例子介绍如何使用事件管理器。
操作包含如下五种：
1. 定义指定字段计算公式：指定字段的值是通过定义的计算公式计算得出的结果。

2. 单据合法性校验：事件触发时，根据规则事件定义的处理设置，弹出信息提示框。

3. 携带关联资料属性到指定字段：指定字段的值是通过F7控件键入关联资料的来源字段，由其携带相关属性值传入的。详情请查看实例。
4. 设置字段属性：定义字段属性是否可见、是否锁定。

运行结果：

5. 根据关联资料属性设置字段精度：将关联资料的属性值赋予要设置精度的字段。
可设置精度的字段类型为：数量、单据和单价。

举例：
背景：物料基础资料包含物料编码、物料名称、规格型号等字段。物料基础资料与采购订单关联，实现把相应的单据信息传过来。
实例：定义“规则事件”来实现用户手工录入物料编码，物料名称、规格型号根据物料编码自动携带得到相应的值。
步骤一：单击选中分录，右击选择【编辑表信息】，并在“表格设置”界面，选中需要添加事件的字段，点击【事件】。
步骤二：点击【新增】按钮，新建一项规则事件。

步骤三：定义业务规则。

步骤四：启用个性化布局方案。

步骤五：启用动态扩展方案。
步骤六：使用已被分配该布局方案的用户登陆系统，打开采购订单菜单，当键入物料编码后，系统将根据物料编码自动携带物料名称和规格型号的值，而无需手工录入。
列表界面
列表界面包含三个部分：标准界面、个性化布局方案、动态查询设置。可设置表格列隐藏，和表格列格式等。
标准界面

温馨提醒：
双击页签可以关闭。
编辑表信息
单击选中表格，右击选择【编辑表信息】，系统弹出“表格设置”界面，可进行属性设置。

属性
用途
列宽
设置列宽大小。
隐藏
设置列为显示或者隐藏。
锁定
设置是否被锁定。
显示格式
格式化字符串，可参考<设置格式化字符串>小节相关介绍。
对齐方式
文本对齐方式，其中包括：左对齐；居中；右对齐。
融合
前置条件：设置分组。
缩放
可拖放调整列的大小比例。
拖动
支持鼠标拖动表头移动表列和交换表列功能。
分组
是指对哪些列进行分组。
必录
设置是否为必录项。
功能菜单：
新增：新增一列信息；
删除：可删除多行列信息；
向上：向上移动一行；
向下：向下移动一行；
置顶：移动到最顶行；
置底：移动到最后一行。
数据绑定
右击选择【数据绑定】，系统弹出“数据绑定界面”。
添加数据绑定信息：
1） 选中控件；
2） 选中属性；
3） 点击【】添加数据绑定信息。

删除数据绑定信息：
1） 选中动态绑定关系；
2） 点击【】删除数据绑定信息。

个性化布局方案
具体操作可以参考前面编辑界面个性化布局方案的介绍。
属性设置
单击选中表格，右击选择【编辑表信息】，系统弹出“表格设置”界面，可设置各项属性。

属性名称
属性用途
列名
列名
标题
列标题
可见
设置在运行期该列是可见或者隐藏
可用
设置在运行期该列是否可编辑
必录
设置在运行期该列为必录
合计
是否参与合计
事件
可对该控件设置事件规则
功能菜单：
向上：向上移动一行；
向下：向下移动一行；
置顶：移动到最顶行；
置底：移动到最后一行。
动态查询设置
动态查询设置：

动态查询设置集成了原有列表配置功能“动态查询方案”，负责列表列的展现方式。动态查询方案的增删改查可参考文档《动态查询方案使用说明》。
【分配到用户】：查询方案支持分配到用户，这样在不同用户登陆时，可看到不同的界面展示。
温馨提醒：
分配时注意组织的类型选择，比如销售订单的主业务组织类型为销售组织，则应该选择销售组织，然后再进行相关分配。
动态查询方案支持在运行期扩展查询的字段，通过关联其他实体，将其他实体的字段添加到当前query中，参与过滤和显示。
【方案检查】：检查当前查询方案是否可用。
还原
还原：清除扩展单元中使用动态扩展平台定制的内容，还原到初始导入或新增状态。
选中扩展单元，右击选择【还原】。

定位
用户在扩展对象时，左边扩展单元较多时，可以通过定位功能直接找到当前编辑的对象。

业务场景
套打
EAS中的套打，并不仅仅是指在印刷好的票据、单据上打印内容的。更为全面而准确的定义，应该是指：自定义格式的票据、单据、报表等数据的打印。其中，自定义格式是指用户可以自己制作模板。由于名称的沿袭，一直采用套打一词。
下面介绍动态扩展平台自定义的业务单据如何配置套打：
l 单击选中动态扩展方案，右击选择【新建】---->【业务单据】，录入名称、别名。

l 进行二次开发
l 启用动态扩展方案：选中动态扩展方案或者扩展单元，点击【启用】。

l 新建套打文件夹：进入【系统平台】-->【业务工具】-->【套打】-->【套打管理】。在套打管理界面中，点击【】，录入名称，别名。

注意事项：
新建文件夹名称必须为：DEP

l 新增ReportOne套打模板：选中文件夹节点，点击【】，录入名称，别名。

l 添加数据源：
1） 点击【】：

2） 选择元数据类型，点击【下一步】：

3） 选择业务数据源，点击【完成】

l 制作模板
l 重命名数据为baseInfo

注意事项：
必须修改数据源名称为baseInfo
l 运行业务单据时，选择【套打】，选择模板。