单据有多个单据体的情况下，单据列表如何设置显示默认单据体

关键词：单据列表、多分录

一、需求

        在一些费用模块的页面，比如差旅报销单,出差申请单,费用报销单,借款单,费用申请单,对公报销单,这些页面都是多分录的,说的就是一个单据下面有多个单据体, 因为列表默认只支持单据上的第一个单据体的字段展示，第一个单据体的信息根据实体元数据的位置决定的，那如果想默认展示的是另外一个分录的,该如何设置这个默认分录？

二、思路与方案

        因为列表默认只支持单据上的第一个单据体的字段展示，第一个单据体的信息根据实体元数据的位置决定的，那如果想默认展示的是另外一个分录的,又如何设置这个默认分录,下面有两种方法实现.

三、实现过程

         我们先来构建一下我们的测试页面.

1 新建一个单据页面,单据列表控件是需要有单据才能创建的，单据使用默认的模板就可以,

这里主要是添加了两个单据体,两个单据体里面又有两个子单据体.

2 编辑列表页面把这些字段都添加上，

3 预览列表页面,我们可以看到单据列表的可以通过这个查询范围来切换查询结果.

这里有两种实现方式：

方案一：

通过插件实现,插件代码如下：

public  class TestListPlugin extends AbstractListPlugin {
        @Override
        public void initialize() {
                 ListShowParameter o =(ListShowParameter) this.getView().getFormShowParameter();
                 o.setSelectedEntity("kded_entryentity1");// kded_entryentity1是单据体标识
                 super.initialize();
        }
}

方案二：

通过配置实现,在应用的应用菜单里面针对这个页面的列表入口菜单栏添加参数即可.

四、效果图

进入列表页面,会默认显示单据头和当前设置单据体的字段,如果当前设置的是子单据体,同样会把它的父单据体的字段展示出来.

五、开发环境版本

COSMICV4.0.003.0

六、参考资料

【开发平台】指导手册

学习成长中心