1.界面介绍
1. 新建业务单位，若无需求，默认选用财务组织。
2. 在项目路径下的\metadata\com\kingdee\eas\custom\bill 可改单据名称。
3. 标准：默认先在用户自定义下面建立报表(rpt)、基础资料(basedata)和业务单据(bill)，即在业务组别下面建业务单元，然后再在下面建业务组别，最后再建业务单元。总共四层结构。
rpt里面建一个项目名，再下面自建app和client。
4. 规范布局按钮，位于页面的上方，可一键规范布局。
5. 主要的元数据：
1)entity(实体)：设计开发视图->app->entity->属性。
有两种类型，钥匙图标和园点图标。前者表示自有属性，后者表示关联属性，类似于数据库中的外键。也可以在属性右边的方法里面，添加自定义的方法。
2)table(数据表)：可直接理解为数据库里面的表，在此可以查看对应的字段名称、类型和长度等等。
3)query(查询): 主要就是SQL语句。 在子对象(主对象下面的属性)里面可以选择连接方式，若连接方式为默认类型就相当于于内连接，父对象所有行<---->左连接，子对象所有行<---->右连接。
6. 修改了单据的属性，一定要记得发布业务单元，发布完业务单元之后，接着一定要刷新Java代码。
7.info对象：类似于一般开发中的，POJO对象或者叫entity对象。
8.ListUI和EditUI属于前端页面，ControllerBean.java是负责处理后台的业务逻辑的。前后端所使用的代码不相同。
2.单据
1. 使用钢铁基类后添加组织需要加上的代码：
EditUI编辑界面：
public KDBizPromptBox getMainOrgUnit() {
return prmtFICompany;// 主业务组织控件
}
protected OrgType getMainBizOrgType() {
return OrgType.Company;// 组织类型
}ListUI序时簿界面：
protected OrgType getMainBizOrgType() {
return OrgType.Company;
}
protected String getPropertyOfBizOrg(OrgType orgType) {
return "FICompany.id";
}3.取值和设值
（1）控件：
获取值：
this.控件名称.getValue或get类型(如getText)，
设置值：
this.控件名称.setValue或set类型(如setText)。
（2）分录(kdtEntry):
获取值：
先获取单元格，再定位到列。
this.kdtEntry.getCell(rowIndex, kdtEntry.getColumnIndex("RowName")).getValue(值);或者
this.kdtEntry.getCell(rowIndex, "RowName").getValue(值);设置值：
this.kdtEntry.getCell(rowIndex, kdtEntry.getColumnIndex("RowName")).setValue(值);或者
this.kdtEntry.getCell(rowIndex, "RowName").setValue(值);4.方法
onload()：类加载后调用此方法，在方法里面设置监听事件，设置初始值。操作的是控件。
onshow()：绑定控件。
createNewDate(): 在UI页面添加控件后会进入此方法，用于设置默认值。不能在onload()设置默认值，会被覆盖。操作的是对象。使用字段名称。
createNewDetailData(): 操作分录，也是用来设置默认值。
基本用法：
//此例子为DEP的采购订单
@Override
public IObjectValue createNewDetailData(KDTable arg0) {
//获取到控件
final KDFormattedTextField rate = (KDFormattedTextField)DEPUtils.findComponetByName(this, "控件名称");
PurOrderEntryInfo vo = (PurOrderEntryInfo)super.createNewDetailData(arg0);
vo.put("控件名称", rate.getValue());
return vo;
}storeField() : 将控件的值绑定到数据库，方法触发的时机是在保存前、提交前、窗体关闭前。
beforeStoreFields(): 用于绑定前的事件处理。
verifyInput(): 校验数据，方法里面写保存和提交的操作。
5.事件
最常用的就两个事件：editStarted和editStopped。如果是在分录上，则为kdtEntry_editStarted和kdtEntry_editStopped。
还有mouseClicked、properyChange。
添加事件的步骤：在UI界面的事件里面找到对应的事件名称，双击点进去，然后保存事件，将事件的名称复制到相应的Java代码里面。
6.监听器
（1）addDataChangeListener：
用法：
控件名称.addDataChangeListener(new DataChangeListener(){
@Override
public void dataChanged(DataChangeEvent arg0){
......
}
});(2)addActionListener:
用法：
控件名称.addActionListener(new ActionListener(){
@Override
public void actionPerformed(ActionEvent e) {
......
}
});7. F7
F7类型的控件命名为：pk+自定义的控件名称
F7过滤：
EntityViewInfo viewInfo = new EntityViewInfo();//视图
FilterInfo filterInfo = new FilterInfo(); //过滤
设置过滤条件
filterInfo.getFilterItems().add(new FilterItemInfo("xxx"='yyyy'));//相当于where1
filterInfo.getFilterItems().add(new FilterItemInfo("zzz"='kkkk'));//相当于where2
new FilterItemInfo("number","11111",CompareType.EQUALS);//比较，相当于苍穹的QFilter
filterInfo.setMaskString("#0 or #1");//将and替换成or，下表从0开始
viewInfo.setFilter(filterInfo);
this.控件名称.setEntityViewInfo(viewInfo);8. 序时簿的常用方法
refreshList：刷新页面
refresh：刷新操作
getSeletedValue：获取单据的id
getSeletedList：获取下标
9.Factory
在app下面的ControlBean.java下面操作数据库，在对应的介入点写代码（ _save() 增加 、 _submit 提交、_audit 审核、_unAudit 反审核和 _delete 删除 ），只有要上下文关系，就能调用其它的Factory。
Factory：调用指定的属性，在entity里面查询方法，子类没有去父类查找。
服务端通过工厂获取本地Controller实例：
IProject iproj = ProjectFactory.getLocalInstance(ctx);客户端通过工厂获取远程Controller实例：
IProject iproj = ProjectFactory.getRemoteInstance();10.Experience
获取分录的行数：this.kdtEntry.getRowCount()
获取枚举类型的值：this.枚举类型的字段名称.getSelectedIndex()，返回的是int型，需要和自定义的枚举值比较是否相等。
11.监听器
F7字段：
this.F7字段.addDataChangeListener(new DataChangeListener(){
@Override
public void dataChanged(DataChangeEvent event) {
.......
}
});分录删除行：
this.分录面板.addRemoveListener(new IDetailPanelListener(){
@Override
public void afterEvent(DetailPanelEvent paramDetailPanelEvent)
throws Exception {
.......
}
}
@Override
public void beforeEvent(DetailPanelEvent paramDetailPanelEvent)
throws Exception {
........
}
});12.异常处理
EASBIzException：业务异常。
throw new EASBizException(new NumericExceptionSubItem("error","提示信息的内容"));BOSException：编程时的异常，SQL，空指针......
throw new BOSException(e);handleException：在前端抛出的异常，在createNewDate方法里面，因为其父类没有抛出异常。
ps:在处理异常时，不能e.printStackTrace()，除非自己确保语句没有异常。
也可以用如下方法，来弹出提示信息：
MsgBox.error("warning", "提示内容", this);
或者
MsgBox.info("warning", "提示内容", this);不过此方法有局限性。
13.SQL
利用工厂：
查询数据：
SelectorItemCollection sic = new SelectorItemCollection();
sic.add("id");
sic.add("name");
XXXXXXFactory.getLocalInstance(ctx).getXXXXXXInfo(new ObjectUuidPK(),sic);
XXXXXXFactory.getLocalInstance(ctx).getXXXXXXInfo("此处填写少了from条件的SQL语句，因为已经确定了表对象");
或者
XXXXXXFactory.getLocalInstance(ctx).getXXXXXXInfo("where name = ");
//过滤
EntityViewInfo viewInfo = new EntityViewInfo();//视图
FilterInfo filterInfo = new FilterInfo(); //过滤
XXXXXXFactory.getLocalInstance(ctx).getXXXXXXCollection(viewInfo);
说明：XXXXXX为自命名的单据名称
直接执行SQL：
前端：
增删改：FMIsqlFacadeFactory.getRemoteInstance().executeSql(sqlString);
查：IRowSet selectRowSet = SQLExecutorFactory.getRemoteInstance(sqlString).executeSQL();
后台：
增删改：DbUtil.execute(ctx, sqlString);
查：IRowSet rowSet = DbUtil.executeQuery(ctx, sqlString);
14.标准改造（DEP）
用user登录系统，在动态扩展平台高级版。
在实体类里面添加字段，不会在页面上显示出来，适合开发人员。
在元数据校验或元数据检查里面复制PK（全类名），新建Java类，命名为：名称+CTEx。新建的类会自动进入继承的类的子类的onload方法。
DEP配置：
标准扩展类：
命名：名称+Ex
二开扩展类要继承标准的controllerBean类，并且二开扩展类的路径要和标准类的路径保持一致。
在数据库中，以CF开头的列名为自添加的，以F开头的列名为本来就有。
拿到控件名称：
DEPUtils.findComponentByName(this,"控件名称")获取类型为KDCheckBox的值 ：
int xxx = 控件名称.getSelected();ps:当值为32时， KDCheckBox为勾选状态。
15.WebSocket接口：
在金蝶BOS设计开发工具里面的目标路径下，先新建一个包，再新建功能，名称已Facede结尾，然后点击发布和发布WebSocket，点击发布WebSocket的时候选中路径，勾选追加到配置文件。发布完之后，会生成一个目录，一个wsdd文件，然后将把刚才生成的wsdd文件放到runtime\server\deploy\eas.ear里面的web-inf文件夹，并把wsdd文件里面的service标签内容复制到server-config.wsdd里面，保存，然后启动服务器打开http://localhost:56898/ormrpc/services，找到创建的Facede，右键复制的地址就是接口地址。
16.手工报表
继承检行分析的包。
_createTempTable方法，得到临时表，查询的列和显示的列要一致。
_query方法（四个参数），查询临时表。
新建用户页面，自建一个UI界面。
自定义弹窗：
说明：UrgentMaterial和Cause为分录的某一个列名，UrgentMaterialsUI为自定义的UI界面。aaaa为自定义的key值，get和put时，名称要保持一致。
int rowIndex = e.getRowIndex();
int colIndex = e.getColIndex();
if(colIndex == kdtEntry.getColumnIndex("UrgentMaterial")){
//判断单元格是否为空
ICell cell = this.kdtEntry.getCell(rowIndex,"UrgentMaterial");
if(cell != null){
//判断列是否为空
Boolean value = (Boolean)this.kdtEntry.getCell(rowIndex,"UrgentMaterial").getValue();
if(value){
UIContext context = new UIContext(ui);
context.put("aa","bb");//可往 UIContext 类的实例里 put 参数，这些参数可以带到被打开的界面上
IUIWindow uiWindow = null;
try {
uiWindow = UIFactory.createUIFactory(UIFactoryName.MODEL).create(com.kingdee.eas.custom.bill.client.UrgentMaterialsUI.class.getName(), context, null, OprtState.VIEW);
uiWindow.show();
} catch (UIException uException) {
handUIException(uException);
}
this.kdtEntry.getCell(rowIndex, "Cause").setValue(uiWindow.getUIObject().getUIContext().get("aaaa"));
}else {
this.kdtEntry.getCell(rowIndex, "Cause").setValue("");
}
}
}自定义弹窗的Java代码：
@Override
public void ConfirmButton_mouseClicked(java.awt.event.MouseEvent e) {
getUIContext().put("aaaa", this.kDTextArea.getText());//获取文本里面的内容
this.disposeUIWindow();//关闭窗体
}PS： 如果打开报表显示没有合法的许可而已过期，就在XXXUI.java的onLoad()里面加上
getUIContext().put(UIContext.CHECK_LICENSE, "false");17.修改客户端地址
参考路径如上图所示，更改配置文件里面的服务器地址即可，适用于IP地址发生改变时。
18.常用快捷键
ctrl + e：查看详细的报错信息。
alt + shift + d：打开debug panel 加上 ctrl + f 查找结点，查看返回值类型。
ctrl + shift + q : 分析执行器。
ctrl + alt + ] ：选中要查询的SQL语句，点击录制，暂停，然后就能SQL查看SQL的运行时间。
19.查询分析器
删除查询分析器里面的内容只要删除下面这个文件里面的内容即可：
20.从客户端下载服务器下面的文件
21.操作日志
管理员登录客户端，搜索【上机日志】。
652
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
