金蝶云苍穹，新手初学者小白PC端java插件开发教学示例

注：
1.本文章的面向对象为刚刚接触金蝶云苍穹星空旗舰版，具有PC端Java插件开发需求的新手、小白、与初学者
2.本文章中涉及的开发环境包括：金蝶云苍穹星空旗舰版开发平台、安装了金蝶官方插件的IDEA
3.插件的实际开发涉及表单页面的生命周期，建议对此内容有一定熟悉，页面的生命周期参考文章：
https://vip.kingdee.com/article/403237280594265344?productLineId=29&lang=zh-CN
4.本文档涉及一些金蝶官方的插件代码方法，这些插件代码方法的使用与介绍可以参考SDK文档：
https://dev.kingdee.com/sdk/Cosmic%20V5.0.002/index.html?nav=package
5.文章的代码都是为了方便理解，使用的变量名都尽量简单，实际的业务开发中需要进行代码规范化处理，代码规范参考IDEA中金蝶官方插件的代码分析功能。
6.文章或许哪里讲的不够详细，或者存在疑意，有任何不明白或者不清楚的地方可以在评论区留言，如果我清楚的话会尽量尽快回复的
7.此文章在金蝶官方的开发者社区也有发布，本着能对像我一样熟悉博客园的金蝶开发者起到帮助的想法，所以将文章在园子又发布了一遍，金蝶开发者社区的此文链接：
https://vip.kingdee.com/article/799643532909519872?productLineId=29&lang=zh-CN
一、插件开发思路
对于插件的开发，我们首先要确定的，是插件要实现的功能。
然后根据功能，我们再进一步确定，这个功能包含的事件，事件触发页面的页面类型，事件的触发时机，事件的逻辑。
等到这些都确定完后，我们就可以进行实际开发了。
比如说，我想要开发一个表单插件，插件的功能是批量修改列表某些分录（数据行）的数量字段或者状态字段的值。
那么这时候我会确定，这个功能的流程是：用户选中数据——>点击按钮——>修改选中数据的字段值——>字段列刷新。
这样一来就可以确定，事件触发页面的页面类型（单据列表类型），触发时机（用户点击按钮之后），事件的逻辑（获取到用户选择的数据之后批量修改数据的字段值，最后刷新页面）。

二、新建插件类
在IDEA中新建一个项目，在项目的对应plugin路径下，新建一个插件类，新建时选择继承的插件类名与继承的插件类型，例如：
1.我的插件类为页面插件，所以选择plugin目录下的form文件夹新建插件类（右键点击form文件夹，点击新建，选择金蝶插件的继承插件）

2.命名插件类并选择继承的插件类类型，这里我是列表页面插件，于是我选择标准单据列表插件类型

新建后的插件类内容：

1. package ***.plugin.other;
2. import kd.bos.list.plugin.AbstractListPlugin;
3. import kd.sdk.plugin.Plugin;
4. /**
5. * 标准单据列表插件
6. */
7. public class teacherListPlugin extends AbstractListPlugin implements PLugin {
8. }

复制代码

3.编写代码实现事件的逻辑
3.1，事件按钮添加
因为我的插件事件需要用户点击按钮来触发，所以我在页面上添加了两个新的按钮（状态正常按钮与数量0按钮），
并将按钮的操作代码选择为dothing（空操作），操作后刷新字段一个选择为数量（qty），一个选择为（status）

3.2，编写代码
因为我的事件在用户点击对应按钮后触发，所以首先注册两个按钮的点击监听事件
（添加工具栏按钮点击监听的事件为addItemClickListeners，在生命周期registerListener中添加）

1. private static final String FID_TOOLBAR = "toolbar";//默认的工具栏标识
2.     @Override
3.     public void registerListener(EventObject e) {
4.         super.registerListener(e);
5.         this.addItemClickListeners(FID_TOOLBAR);// 添加工具栏按钮点击的监听事件，监听的工具栏为字段标识对应的工具栏
6.     }

复制代码

插件类全代码：

1. package ***.plugin.other;
2. import kd.bos.list.plugin.AbstractListPlugin;
3. import kd.sdk.plugin.Plugin;
4. import java.util.EventObject;
6. /**
7. * 标准单据列表插件
8. */
9. public class teacherListPlugin extends AbstractListPlugin implements Plugin {
10.     private static final String toolbar = "toolbar";//默认的工具栏标识
11.     @Override
12.     public void registerListener(EventObject e) {
13.         super.registerListener(e);
14.         this.addItemClickListeners(toolbar);// 添加工具栏按钮点击的监听事件，监听的工具栏为字段标识对应的工具栏
15.     }
16. }

复制代码

然后注册两个按钮的监听事件：

1. private static final String statusbtn = "statusbtn";//状态正常按钮的对应字段标识
2. private static final String qtybtn = "qtybtn";//数量0按钮的对应字段标识
3. @Override
4.     public void itemClick(ItemClickEvent evt) {
5.         if (statusbtn.equals(evt.getItemKey())) {//监听状态正常按钮的点击事件
6.             status();//状态正常事件逻辑处理方法
7.         } else if (qtybtn.equals(evt.getItemKey())) {//监听数量0按钮的点击事件
8.             qty();//数量重置为0事件逻辑处理方法
9.         }
10.     }
11. private void status(){//状态正常事件逻辑
13. }
14. private void qty(){//数量0事件逻辑
16. }

复制代码

插件类全部代码：

1. package ***.plugin.other;
2. import kd.bos.form.control.events.ItemClickEvent;
3. import kd.bos.list.plugin.AbstractListPlugin;
4. import kd.sdk.plugin.Plugin;
5. import java.util.EventObject;
7. /**
8. * 标准单据列表插件
9. */
10. public class teacherListPlugin extends AbstractListPlugin implements Plugin {
11.     private static final String toolbar = "toolbar";//默认的工具栏标识
12.     private static final String statusbtn = "statusbtn";//状态正常按钮的对应字段标识
13.     private static final String qtybtn = "qtybtn";//数量0按钮的对应字段标识
14.     @Override
15.     public void registerListener(EventObject e) {
16.         super.registerListener(e);
17.         this.addItemClickListeners(toolbar);// 添加工具栏按钮点击的监听事件，监听的工具栏为字段标识对应的工具栏
18.     }
19.     @Override
20.     public void itemClick(ItemClickEvent evt) {
21.         if (statusbtn.equals(evt.getItemKey())) {//监听状态正常按钮的点击事件
22.             status();//状态正常事件逻辑处理方法
23.         } else if (qtybtn.equals(evt.getItemKey())) {//监听数量0按钮的点击事件
24.             qty();//数量重置为0事件逻辑处理方法
25.         }
26.     }
27.     private void status(){//状态正常事件逻辑
29.     }
30.     private void qty(){//数量0事件逻辑
32.     }
33. }

复制代码

然后开始编写事件逻辑方法，（补充：状态字段的字段标识为status，控件类型为下拉列表，状态正常的对应值为"0"，数量字段的字段标识为qty，控件类型为整数）
状态正常事件：

1. private void status(){//状态正常事件逻辑
2.         ListSelectedRowCollection selectedRows = this.getSelectedRows();//获取当前列表选中行的索引
3.         if (selectedRows == null || selectedRows.isEmpty()) {//校验选中行数量是否为空，为空则停止事件并提示
4.             this.getView().showTipNotification("请先选择要操作的数据");
5.             return;
6.         }
7.         //根据选中行的索引获取对应数据的主键值
8.         List<Long> ids = new ArrayList<>();
9.         for(ListSelectedRow row : selectedRows){
10.             ids.add((Long)row.getPrimaryKeyValue());
11.         }
12.         //根据获取到的对应事件主键值批量查询获取数据
13.         DynamicObject[] datas = BusinessDataServiceHelper.load("teacher",//第一个参数：要查询数据的表单的标识
14.                 "id,number,name,status",//第二个参数：要查询的数据的属性名
15.                 new QFilter[]{new QFilter("id", QCP.in,ids)}//第三个参数：要查询的数据的过滤条件
16.         );
17.         //遍历数据数组，对数据的对应字段的值进行修改
18.         for (DynamicObject data : datas){
19.             data.set("status","0");//正常状态的对应值为"0"
20.         }
21.         SaveServiceHelper.save(datas);//保存修改后的结果
22.         this.getView().invokeOperation("refresh");//刷新页面
23. }

复制代码

数量0事件：

1. ListSelectedRowCollection selectedRows = this.getSelectedRows();//获取当前列表选中行的索引
2.         if (selectedRows == null || selectedRows.isEmpty()) {//校验选中行数量是否为空，为空则停止事件并提示
3.             this.getView().showTipNotification("请先选择要操作的数据");
4.             return;
5.         }
6.         //根据选中行的索引获取对应数据的主键值
7.         List<Long> ids = new ArrayList<>();
8.         for(ListSelectedRow row : selectedRows){
9.             ids.add((Long)row.getPrimaryKeyValue());
10.         }
11.         //根据获取到的对应事件主键值批量查询获取数据
12.         DynamicObject[] datas = BusinessDataServiceHelper.load("teacher",//第一个参数：要查询数据的表单的标识
13.                 "id,number,name,qty",//第二个参数：要查询的数据的属性名
14.                 new QFilter[]{new QFilter("id", QCP.in,ids)}//第三个参数：要查询的数据的过滤条件
15.         );
16.         //遍历数据数组，对数据的对应字段的值进行修改
17.         for (DynamicObject data : datas){
18.             data.set("qty",0);//正常状态的对应值为"0"
19.         }
20.         SaveServiceHelper.save(datas);//保存修改后的结果
21.         this.getView().invokeOperation("refresh");//刷新页面

复制代码

插件类全代码：

1. package ***.plugin.other;import kd.bos.dataentity.entity.DynamicObject;import kd.bos.entity.datamodel.ListSelectedRow;import kd.bos.entity.datamodel.ListSelectedRowCollection;import kd.bos.form.control.events.ItemClickEvent;import kd.bos.list.plugin.AbstractListPlugin;import kd.bos.orm.query.QCP;import kd.bos.orm.query.QFilter;import kd.bos.servicehelper.BusinessDataServiceHelper;import kd.bos.servicehelper.operation.SaveServiceHelper;import kd.sdk.plugin.Plugin;import java.util.ArrayList;import java.util.EventObject;import java.util.List;/** * 标准单据列表插件 */public class teacherListPlugin extends AbstractListPlugin implements Plugin {    private static final String toolbar = "toolbar";//默认的工具栏标识    private static final String statusbtn = "statusbtn";//状态正常按钮的对应字段标识    private static final String qtybtn = "qtybtn";//数量0按钮的对应字段标识    @Override    public void registerListener(EventObject e) {        super.registerListener(e);        this.addItemClickListeners(toolbar);// 添加工具栏按钮点击的监听事件，监听的工具栏为字段标识对应的工具栏    }    @Override    public void itemClick(ItemClickEvent evt) {        if (statusbtn.equals(evt.getItemKey())) {//监听状态正常按钮的点击事件            status();//状态正常事件逻辑处理方法        } else if (qtybtn.equals(evt.getItemKey())) {//监听数量0按钮的点击事件            qty();//数量重置为0事件逻辑处理方法        }    }    private void status(){//状态正常事件逻辑        ListSelectedRowCollection selectedRows = this.getSelectedRows();//获取当前列表选中行的索引        if (selectedRows == null || selectedRows.isEmpty()) {//校验选中行数量是否为空，为空则停止事件并提示            this.getView().showTipNotification("请先选择要操作的数据");            return;        }        //根据选中行的索引获取对应数据的主键值        List ids = new ArrayList();        for(ListSelectedRow row : selectedRows){            ids.add((Long)row.getPrimaryKeyValue());        }        //根据获取到的对应事件主键值批量查询获取数据        DynamicObject[] datas = BusinessDataServiceHelper.load("teacher",//第一个参数：要查询数据的表单的标识                "id,number,name,status",//第二个参数：要查询的数据的属性名                new QFilter[]{new QFilter("id", QCP.in,ids)}//第三个参数：要查询的数据的过滤条件        );        //遍历数据数组，对数据的对应字段的值进行修改        for (DynamicObject data : datas){            data.set("status","0");//正常状态的对应值为"0"        }        SaveServiceHelper.save(datas);//保存修改后的结果        this.getView().invokeOperation("refresh");//刷新页面    }    private void qty(){//数量0事件逻辑        ListSelectedRowCollection selectedRows = this.getSelectedRows();//获取当前列表选中行的索引
2.         if (selectedRows == null || selectedRows.isEmpty()) {//校验选中行数量是否为空，为空则停止事件并提示
3.             this.getView().showTipNotification("请先选择要操作的数据");
4.             return;
5.         }
6.         //根据选中行的索引获取对应数据的主键值
7.         List<Long> ids = new ArrayList<>();
8.         for(ListSelectedRow row : selectedRows){
9.             ids.add((Long)row.getPrimaryKeyValue());
10.         }
11.         //根据获取到的对应事件主键值批量查询获取数据
12.         DynamicObject[] datas = BusinessDataServiceHelper.load("teacher",//第一个参数：要查询数据的表单的标识
13.                 "id,number,name,qty",//第二个参数：要查询的数据的属性名
14.                 new QFilter[]{new QFilter("id", QCP.in,ids)}//第三个参数：要查询的数据的过滤条件
15.         );
16.         //遍历数据数组，对数据的对应字段的值进行修改
17.         for (DynamicObject data : datas){
18.             data.set("qty",0);//正常状态的对应值为"0"
19.         }
20.         SaveServiceHelper.save(datas);//保存修改后的结果
21.         this.getView().invokeOperation("refresh");//刷新页面    }}

复制代码

3.3，注册插件
插件类编写完成后，需要将代码绑定到对应页面上才能生效：

示例：

然后点击保存页面

三、页面运行测试插件
点击页面预览按钮进入预览模式，然后测试对应功能

我的：
点击状态正常按钮前与点击正常状态按钮后：

点击数量0前与点击数量0按钮后：

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

懂技术并乐意极积无私分享的人越来越少。珍惜

用心讨论，共获提升！

感谢，下载保存了

分享、互助 让互联网精神温暖你我

感谢分享，学习下。

喜欢鼓捣这些软件，现在用得少，谢谢分享！

鼓励转贴优秀软件安全工具和文档！

热心回复！

热心回复！

感谢分享，学习下。

收藏一下   不知道什么时候能用到

热心回复！

感谢分享，学习下。

感谢，下载保存了

谢谢分享，试用一下

谢谢楼主提供！

分享、互助 让互联网精神温暖你我

谢谢分享，辛苦了

这个有用。