金蝶EAS BOS 元数据介绍

元数据归类总结

解决方案

解决方案是元数据的最大载体，对应于一个元数据集合。任一个元数据都必须归属于某个解决方案，譬如，EAS就是一个解决方案。

♢ ♢ 所有客户端加载的元数据都是加载 deployed_meta 文件夹下的元数据这是文件夹发布以后自动生成的文件夹

包

命名规则：不能是中文而且只能是英文而且是全小写
如何建立：设计工具视图->右键新增包
作用
☑ 提供了元数据的Namespace管理
☑ 提供了一种分类和查看的方式
☑ 类似于目录结构的一个树状模型
☑ 元数据必须属于且只属于一个包
☑ 包定义的名称必须与文件的命名一致
☑ 在定义期，包会映射到元数据存储的实际目录

实体介绍 Entity

实体对象是元数据模型的核心内容，数据对象、查询对象、实体界面对象等其他对象均附属或依赖于它。
实体对象是数据存储的一个逻辑视图，它对应于业务系统中的实体类。
实体对象分类：
•“常规”（Normal）：是可永久存储的数据对象
•“抽象”（Abstract）：不定义与数据对象的映射，实体对象可以继承它
自己新建实体的时候要注意命名规范首字母大写（否则不符合java开发规范）
文件结构：分为8块基础信息属性方法事件逻辑建缺省视图图形化编辑源代码
① 基础信息

▶ 类实现信息：

○ 控制器bean是如何构建出来的？先创建实体 再配置是实体里的控制器bean 再发布...

♥ ♥ ♥ 不同情况 使用的控制器和请求方式不一样 分为以下两种情况：① 客户端请求服务端 通过RPC请求（远程服务的调用）  即用到远程控制器（控制器Remote）② 服务端调用服务端通过本地控制器（控制器Local）

不管是本地还是远程都是通过工厂类（实体名称+Factory）来实现的

♥ ♥ ♥ 如何在一个实体对象中调用另一个实体对象的方法？总的思路 : 首先通过工厂类拿到控制器 （工厂类->每个实体名称+Factory） 然后控制层在调用服务端代码  也就是利用了 反射机制 和 工厂方法模式 ① 客户端请求服务端 （远程服务控制器Remote）步骤 1、创建实体业务接口 步骤 2、调用具体实现类里的方法

//返回的是一个接口（就是实体A的业务接口（基础信息里看））
实体A名称Factory.getRemoteInstance().实体A的方法(传参)

  ② 服务端调用服务端（本地服务控制器Local）方法1、通过  this.方法名方法2、实现接口来调用

实体A名称Factory.getLocalInstance(ctx).实体A的方法(传参)

  ▶ 扩展属性：
* 重要的两个属性： 是否使用编码规则（默认true） 以及 BOTP业务对象转换♥ ♥ ♥
* BOTP主要的作用：支持用户在各种业务单据间定义转换关系，并自动/批量地帮助用户将源单据转换生成目标单据，从而大大地减少业务人员的相关工作量；♢ 主要功能，包括：1. 业务数据的自动生成：单据生成凭证，选单生成等2. 基于对象的数据交换：数据交换平台3. 关联关系建立与维护：自动建立并记录关联关系4. 反写及取消反写5. 关联数据的自动维护

假如规定实体要参与业务转换规则BOTP我们就要在扩展属性里面增加它反之删除
假如规定实体不使用编码规则（默认true），我就要修改值为false

* 如何修改 业务单元的所属的业务组织（主业务组织） ？♥ ♥ ♥方法1：业务建模视图->点开我们要修改的业务单元->右键点击界面->选单据信息->即可修改方法2：业务建模视图->右键我们要修改的业务单元目录选中查看关联元数据->点开具体的实体对象->修改扩展属性中的OrgType的值

② 属性

♥ ♥ ♥ 自有属性和关联属性最大的区别？
自有属性是基本数据类型关联属性是引用数据类型？？？？？不是很懂为啥

③ 方法▶ 整体介绍：
方法发布完可以在，就会在基础信息里的 业务接口 里面自动生成，但我们不能直接找到，因为实体对象继承了多个父类，然后那些名字啥啥都自己新建的是在业务接口对应的，但是这里本来自带的在业务接口里就不对应了...(忘了) 总之，去观察一下就知道了。

添加一个方法的命名规则：首字母小写，另外设置好别名、访问级别（访问修饰符）。

▶ 详细信息：

业务功能需要事务保护就一定要设置required
Required 要求有事务：如果已有事务，则在当前事务中进行；如果没有，就新建事务；
RequiredNew 要求有事务：不管原来有没有事务，都新建事务，在新事务环境中执行。
Mandatory 要求有事务：如果原来没有事务，即抛异常。
Supports 可支持事务：如果原来有事务，就在当前事务中进行；如果没有，就不新建事务，即可在事务环境中进行。
NotSupports 无事务：如果原来有事务，则先挂起事务，继续在无事务环境中执行；如果原来没有事务，则可继续执行。
Never 不支持事务：如果原来有事务，则抛异常；如果没有，则可继续执行。

④ 事件   配置工作流的时候需要使用  平时不太用的上⑤ 源代码源代码就是实体发布以后生成的xml文件

select newBosid(“bodType唯一标识”) from dual // 通过这个来找到我们指定的实体

实体关系（以 .relation 结尾的文件）

命名规则：R_源对象名称_目标对象名称_字段名称
怎么通过实体关联属性找到他的目标对象？
Ctrl+点击 SupplierEntity 文本框部分可实现跳转

数据表

可以称为数据对象，数据表可以对应于关系数据库中的数据表，是物理模型，相对的ER模型是逻辑模型。
◐ 数据表的2种建立方式：
✔ 手工新增…
命名规则：CT_实体前三个英文字母_实体名称
（实体名称过长就拼接实体的每个单词的首字母）

✔ 从数据库导入…
首先必须准备好导入需要的sql文件
其次按照下图操作：

查询（以 .query 结尾的文件）

查询是实体的查询视图，可以在数据访问过程中只获取视图中指定属性的数据，并按照过滤、排序条件进行数据的过滤和排序
查询的数据组织形式是二维模型的，可以分为：连接查询、联合查询

** 注意下图蓝字解析另外蓝字解析是针对1个单头和1个分录来说的
假如有1个单头 2个分录（这两个分录没有关联）我们的主键定义部分不能写3个id
写三个id是无法实现的因为无论如何都会产生多余的笛卡尔积统计条数都不对

【tips】* 主键设置错的话前端页面可能会出现还有数据却滚动不下去。
* 单头579条单头+分录1995条
如果主键只定义单头主键
那么数据只有579条两个都加才有1995条。

【现在我们双击 entries.id 添加别的字段到计算式下方的框框中并设置计算式为#1 如图3 最后可以看到SQL代码如图4】

【接下来可以修改计算式查看SQL效果这里分别修改计算式为#0 or #1 效果如图5 修改计算式为#0 and #1 效果如图6 但是这样的sql语句都是错误的只是为了效果查看才这样子写计算式应该是定义我们指定字段显示的值是怎样的？因为写成#0+#1 不会有语法错误只是没东西显示…】

列表所有数据都是用query查的
如何修改该页面选项卡代码中sql代码？

步骤：
【修改连接符】
切换至文件结构-> 定义（下方选项卡）操作
首先找到需要修改的子对象，双击会跳出窗口，选择连接类型进行修改。
默认 inner join in 内连接
父对象所有行 letf join in 左连接
子对象所有行 right join in 右连接

【修改查询Select后现实的字段】
切换至文件结构-> 字段（下方选项卡）进行操作即可

♣ 假如数据库有一条数据A 而列表上没有数据A 出错的地方大致有两个：
① 我们先把query文件我们需要的代码复制到金蝶EAS客户端中的查询分析进行查询
a、假如查得到数据没有报错说明是权限问题
b、假如查询不到 70-80%可能是 SQL语句中连接类型有错误

A left join in B
3条 a1 b1 | a1 b2 | a2 null
A right join in B
2条 a1 b1 | a1 b2

业务功能 Function

是对Entity对象、UI对象的方法提供封装，供其他模块或二次开发使用（目前业务功能的主要使用对象为工作流）
命名规则：首字母大写+Function结尾
如何新建：设计工具视图->右键单击新增->选择业务功能
文件结构：分为3块基础信息操作定义源代码

① 基础信息： 定义名称和别名 ② 操作定义：是整个业务功能的核心♦ 操作列表：列举了每个操作，点击列表任意一项 右侧可以看到对应操作的详细信息。♦ 详细信息：这些操作的具体描述如：名称、别名等 ♦ 引用（配置哪个页面需要引用这个操作）：用来设置操作的引用信息 包括UI及实体、事件的引用。引用包括实体引用和业务引用。♡ 提交操作和审核操独特的区别？  “ 提交需要引用界面对象 审核不需要引用界面对象 ”因为在editUI并没有提交按钮，所以只能通过绑定事件进行提交。但有审核按钮，所以不需要绑定。（大概好像是这样..）

PS: 整个业务功能是为我们的工作流服务的，工作流配置一般是由实施人员进行配置的

功能 Facade

是一个public方法的集合类，是用以定义类似“凭证过账”操作的与实体无关的逻辑方法
命名规则：首字母大写+Facade结尾
如何新建：设计工具视图->右键单击新增->选择功能
文件结构：分为3块基础信息方法源代码
① 基础信息：和实体很像也有一个类实现信息但它少了一个对应的表对象和子对象类等也就是没有实体这么多的文件结构（需要关注业务接口和控制器bean）
② 方法：也是和实体一样可以创建方法然后保存发布属性（新建方法会被创建在业务接口里面存在完以后我们就自己去实现它；新建方法会在控制器bean里面被重写），另外里面的事务属性和实体的是一样的，当业务功能需要事务保护就一定要设置required

☆ editui和listui投如何调用控制器bean里面的方法？
功能名Factory.getRemoteInstance().方法名

枚举 Enum

枚举值的类型可以是：Integer、Long、Float、Double、String
命名规则：首字母大写+Enum结尾（只要源数据要生成.java文件都要首字母大写）
如何新建：设计工具视图->右键单击新增->枚举一定要创建在app和client的同级目录下面
文件结构：分为2块枚举定义源代码
① 枚举定义：

发布的类名：也就是发布完以后生成的.java文件所在的地方
值定义（一个枚举可以定义多少个值）名称大写命名值建议用数据

枚举对象一旦定义完以后枚举的值就不可以变了
因为它全局变量使用的是static final

♥ 比较某个枚举值是不是等于男？（两种方式）（注意用equals还是== 尽量用equals）
方法1、通过枚举的值也就是我们定义的Sting类型的全局变量比较（值比较）
//自己创建枚举对象 TestEnum a 取到他的值来比较
//XXXEnum本类名 xx是Sting类型静态变量
XXXEnum.XX.equles(a.getValue())//XXXEnum对象

方法2、用final修饰的枚举值对象（枚举类创建的一个构造器）（引用比较） 固定值写在equals前面 变量写在equals后面

异常 Exception

异常元数据提供异常信息的规范化和多语言显示
自定义的异常类信息，包括异常号、错误信息等
命名规则：首字母大写+Exception结尾

权限

如何创建：左上方菜单选项卡方案点击权限管理
文件名: .permission结尾
常规的权限管理区创建权限项，可以选择绑定业务单元也可以不选择，我们有两种实现方式。

方法1：我们就可以点击新建权限项里创建
方法2：设计视图中bim.permission文件中添加

每一个权限的上级都要有一个包，用于更好管理好每个权限（和建立业务单元是一个道理）

自定义的权限项名字：别名一定要是中文名称可以使英文

bim.permission是系统自带的一个系统会有很多个permission 我们不要把所有权限都放到bim.permission 中我们可以为每个部分创建一个单独的权限文件（PS.权限管理->我们可以选择我们自己独立创建的权限文件/也可以不选（新建权限项默认在bim.permissio中）

日志

日志文件是用来记录事务对数据库更新操作的文件
如何创建：左上方菜单选项卡方案点击日志管理
文件名: .log结尾
日志管理中添加的日志项，想要添加到非默认的bim.log文件下的画
话只能设计视图里面的窗口新建完以后一个新的log文件再一个个添加

多语言资源

多语言资源的值定义，采用字典形式存储多远信息
根据解决方案中定义的语言种类，在多语言资源中增加相应的语言信息定义
文件名: .resources结尾
系统支持英文、简体中文、繁体中文
这里需要注意的是eas实体中属性的name如果勾选了多语言属性
数据库中对应的字段里不是以FName存储了
而是以 FName_l1 FName_l2 FName_l3 存储的 L1英文 L2简体中文 L3繁体中文