金蝶云苍穹-插件开发（一）加载数据

🕗 发布于 2024-07-07 11:44 金蝶云苍穹

前言

此系列博客是进行金蝶云苍穹开发时的插件开发的教程，一是在明年要是还要参加软件杯金蝶A6赛题的话，可以看此系列教程的博客来进行复习，同时如果要是我实验室的学弟学妹要参加的话，我这个系列的博客可以给他们提供学习参考，因为插件开发学习的路上很艰难，我学习的时候，能参照的讲解少，要花费大量工夫去猜测去调试才能学会那些语法。在插件开发上，希望我这个系列的博客能帮助到别人。

这个系列的博客只专门讲解插件开发，基本的那些金蝶云苍穹的知识点在这里不多作讲解。

对于插件的事件，金蝶官方文档中更为详细，我这只对一些常见的插件做业务处理的代码作一些笔记。

加载指定基础资料/单据的数据

在插件中，我们想要获得想要的基础资料/单据的信息，是通过load操作。

load操作常见的有两种：

```
BusinessDataServiceHelper.load()
```
```
BusinessDataServiceHelper.loadSingle()
```

二者的区别是，load是加载指定基础资料/单据的一些数据，loadSingle是加载一个数据。前者的返回值类型是DynamicObject[]，后者的返回值类型为DynamicObject。基础资料和单据的实体在插件中都是放在DynamicObject类型的对象中。

QFilter过滤器

我也不清楚它的官方叫法，我喜欢叫它过滤器（不是web里面那个Filter）。在load操作时，要确保加载的是一些数据还是一个数据，就是对基础资料/单据中的数据进行过滤操作。在最常用的QFilter的构造器中，有三个参数：

第一个是要过滤的属性，第二个是属性过滤要的操作，第三个是如果操作涉及到另一个值，这个值就放到第三个参数里面。

第二个参数通常使用枚举类QCP类的枚举对象的方式，也可以使用操作对应的字符串。

例：

String name = "xxx";
QFilter qfilter = new QFilter("name", QCP.equals, name);

QFilter qfilter = new QFilter("name", QCP.is_notnull, null);

加载数据

接下来就可以讲解如何加载自己想要的基础资料/单据的数据了。

load和loadSingle方法有三个参数，第一个是基础资料/单据的标识，第二个是指定要加载那些字段，第三个是一个QFilter类型的数组，数组里面是一个个的QFilter过滤器。

第二个参数是一个字符串，里面写着一个一个的字段的标识名，每个标识名之间由逗号隔开，例：

"field1,field2,field3,field4"

具体的加载数据的代码案例：

DynamicObject[] dynamicObjectArray = BusinessDataServiceHelper.load("abq2_schedule_form", //日程安排的基础资料的实体名
                            "name," +  //任务名
                            "abq2_done_time," + //执行时间
                                    ///单据体部分
                            "abq2_task_context," +  //任务内容
                            "abq2_expect_minute," +  //预期时间
                            "abq2_diff," +  //任务难度
                            "abq2_true_minute," +  //真实花费时间
                            "abq2_finish," +   //完成情况
                            "abq2_task_entryentity"   // 加载单据体
                    ,new QFilter[]{new QFilter("name", QCP.is_notnull, null)});

DynamicObject thisCourse = BusinessDataServiceHelper.loadSingle("abq2_my_course",
                        "abq2_my_course_stu," + //课程内码
                                "name," + //课程名称
                                "abq2_textfield3," + //星期
                                "abq2_textfield1," + //教室
                                "abq2_textfield," + //教师
                                "abq2_textfield4," + //年级
                                "creator," + //学生
                                "abq2_textfield2",  //课节
                        new QFilter[]{new QFilter("id", QCP.equals, primaryKeyValue)});

获取指定的基础资料/单据实体的字段值

一级字段

获取到对应的实体的DynamicObject类型的对象后，只要是以上load中第二个参数中加载过的字段，都可以获取到其对应的字段值。

若其对象的变量名为dynamicObject

文本类型的字段：dynamicObject.getString("字段标识")

整型类型的字段：dynamicObject.getInt("字段标识")

其他类型的比如getDate、getLong也是以此类推

要额外说的是getDynamicObject，这个是用来获取基础资料字段的字段值，返回值是DynamicObject，就是获取到了这个字段对应的实体了，是默认所有的一级字段都获取到了，可以直接get它的所有一级字段。

单据体的字段

如果不是一级字段，又该如何获取呢？这里以单据体的里面的二级字段为例。

要想获取一个基础资料/单据里面的单据体的信息，首先要先加载出其基础资料/单据的实体的信息，再获取其实体的单据体的信息，类似于先进大门才能进卧室的意思，还有，在load中的第二个参数中，不管要写好单据体的标识，也要写好单据体中的要加载的二级字段的标识，如上面的第一个例子

DynamicObject[] dynamicObjectArray = BusinessDataServiceHelper.load("abq2_schedule_form", //日程安排的基础资料的实体名
                            "name," +  //任务名
                            "abq2_done_time," + //执行时间

                                    //以下下是单据体部分
                            "abq2_task_entryentity,"   // 加载单据体
                                    //以下是单据体的二级字段的标识，即单据体的“列”的标识
                                    "abq2_task_context," +  //任务内容
                                    "abq2_expect_minute," +  //预期时间
                                    "abq2_diff," +  //任务难度
                                    "abq2_true_minute," +  //真实花费时间
                                    "abq2_finish" +   //完成情况
                            
                    ,new QFilter[]{new QFilter("name", QCP.is_notnull, null)});

在get单据体中的二级字段的时候，也要讲究步骤。要先getDynamicObjectCollection("单据体标识")，获取单据体中的分录（就是单据体的行）的数据的集合，集合中的一个元素就是一个分录（就是一行），再对应去get获取其行的字段的数据即可，例：

//获取DynamicObject列表，即获取学生的单据头的信息
            DynamicObject[] dys = BusinessDataServiceHelper.load("abq2_int",
                    "abq2_billnofield," +
                            "abq2_textfield5," +          //学校
                            "abq2_textfield2," +            //学生的班级
                            "stu_name," +     //学生姓名
                            "abq2_textfield3," +      //学生学号
                            "abq2_decimalfield1111," +   //学生成绩总分
                            "abq2_textfield8," +     //考试名称


                            //把单据体和单据体里的字段加进load里面
                            "abq2_entryentity," + //科目成绩的单据体
                                "abq2_textfield," +   //考试科目
                                "abq2_decimalfield111," +   //科目对应的成绩
                                "abq2_daterangefield_startdate",           //考试日期
                    (new QFilter("stu_name", QCP.is_notnull, null)).toArray());

            //创建一个JsonArray
            JSONArray jsonArray = new JSONArray();
            for (DynamicObject dynamicObject : dys) {
                //将学生的考试基本的信息加入JSONArray
                    JSONObject jsonObject = new JSONObject();
                    jsonObject.put("stu_name", dynamicObject.getString("stu_name"));
                    jsonObject.put("school_name", dynamicObject.getString("abq2_textfield5"));
                    jsonObject.put("stu_id", dynamicObject.getString("abq2_textfield3"));
                    jsonObject.put("class_name", dynamicObject.getString("abq2_textfield2"));
                    jsonObject.put("exam_time", new SimpleDateFormat("yyyy-MM-dd").format(dynamicObject.getDate("abq2_daterangefield_startdate")));
                    jsonObject.put("exam_name", dynamicObject.getString("abq2_textfield8"));
                    jsonObject.put("exam_all_score", dynamicObject.getBigDecimal("abq2_decimalfield1111"));
                    jsonArray.add(jsonObject);
                    //获取学生的成绩信息中的单据体信息，获取学生的各门科目的成绩信息
                    //先把单据体的collection创建出来，再获取这个单据体的collection的字段（按照字段名），如下

                    DynamicObjectCollection dynamicObjectCollection = dynamicObject.getDynamicObjectCollection("abq2_entryentity");
                    for (DynamicObject dynamicObject2 : dynamicObjectCollection) { //遍历分录数据
                        //将各科目的的信息加入JSONArray
                        JSONObject jsonObject2 = new JSONObject();
                        jsonObject2.put("subject", dynamicObject2.getString("abq2_textfield"));  //考试科目
                        jsonObject2.put("sub_score", dynamicObject2.getBigDecimal("abq2_decimalfield111"));  //考试成绩
                        jsonArray.add(jsonObject2);
                    }
                }
            }

案例

以一个GPT的自定义操作为例，展示数据的加载和获取：

public class ScoreSumAnalysis implements IGPTAction {
    @Override
    public Map<String, String> invokeAction(String action, Map<String, String> params) {
        Map<String , String> result = new HashMap<>();
        if ("GET_ALL_Score".equalsIgnoreCase(action)) {
            //获取DynamicObject列表，即获取学生的单据头的信息
            DynamicObject[] dys = BusinessDataServiceHelper.load("abq2_int",
                    "abq2_billnofield," +
                            "abq2_textfield5," +          //学校
                            "abq2_textfield2," +            //学生的班级
                            "stu_name," +     //学生姓名
                            "abq2_textfield3," +      //学生学号
                            "abq2_decimalfield1111," +   //学生成绩总分
                            "abq2_textfield8," +     //考试名称
                            "abq2_entryentity," + //科目成绩的单据体
                            "abq2_textfield," +   //考试科目
                            "abq2_decimalfield111," +   //科目对应的成绩
                            "abq2_daterangefield_startdate",           //考试日期
                    (new QFilter("stu_name", QCP.is_notnull, null)).toArray());

            //创建一个JsonArray
            JSONArray jsonArray = new JSONArray();
            for (DynamicObject dynamicObject : dys) {
                //将学生的考试基本的信息加入JSONArray
                JSONObject jsonObject = new JSONObject();
                jsonObject.put("stu_name", dynamicObject.getString("stu_name"));
                jsonObject.put("school_name", dynamicObject.getString("abq2_textfield5"));
                jsonObject.put("stu_id", dynamicObject.getString("abq2_textfield3"));
                jsonObject.put("class_name", dynamicObject.getString("abq2_textfield2"));
                jsonObject.put("exam_time", new SimpleDateFormat("yyyy-MM-dd").format(dynamicObject.getDate("abq2_daterangefield_startdate")));
                jsonObject.put("exam_name", dynamicObject.getString("abq2_textfield8"));
                jsonObject.put("exam_all_score", dynamicObject.getBigDecimal("abq2_decimalfield1111"));
                jsonArray.add(jsonObject);
                //获取学生的成绩信息中的单据体信息，即获取学生的各门科目的成绩信息
                DynamicObjectCollection dynamicObjectCollection = dynamicObject.getDynamicObjectCollection("abq2_entryentity");
                for (DynamicObject dynamicObject2 : dynamicObjectCollection) {
                    //将各科目的的信息加入JSONArray
                    JSONObject jsonObject2 = new JSONObject();
                    jsonObject2.put("subject", dynamicObject2.getString("abq2_textfield"));  //考试科目
                    jsonObject2.put("sub_score", dynamicObject2.getBigDecimal("abq2_decimalfield111"));  //考试成绩
                    jsonArray.add(jsonObject2);
                }
            }

            System.out.println(jsonArray.toJSONString());
            //加入resultDynamicObject参数，将JsonArray加入到这个参数当中，然后返回
            result.put("resultDynamicObject", jsonArray.toJSONString());
        }
        return result;
    }
}

加载数据的插件到此讲解结束，有疑问可以在评论区提出。

原文地址：https://blog.csdn.net/2302_79468488/article/details/140229864

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

上一篇：泛微开发修炼之旅--33基于ecology实现附件上传接口，提供给外部应用使用
下一篇：【JVM系列】Full GC（完全垃圾回收）的原因及分析

数据库管理-第252期深入浅出多主多活数据库技术- Cantian存储引擎（二）（20241017）
本篇文章从目录来看就比较复杂，可以说是现在最完善的Cantian存储引擎部署与MySQL对接文档，看着挺复杂实际也不简单，也希望我的意见和建议能够帮助Cantian引擎发展。
阅读更多2024-10-18
模型部署教程 | 第一章 | 模型部署简介 | 术语解释、加载第一个模型
OpenMMLab 的算法如何部署？这是很多社区用户的困惑。而模型部署工具箱 MMDeploy的开源，强势打通了从算法模型到应用程序这“最后一公里”！中间表示 ONNX 的定义标准。PyTorch 模
阅读更多2024-10-18
C++11标准 future异步线程库
c++标准有很多的版本,比较知名的如c++98是第一版c++标准,提供了c++最底层的支持. 后面的c++11和c++20每个版本都会给c++带来新特性.而线程就是是c++11最重要的特性.虽然c++
阅读更多2024-10-18
Apple提出MM1.5：多模态大型语言模型微调的方法、分析和见解
Apple提出MM1.5：多模态大型语言模型微调的方法、分析和见解
阅读更多2024-10-18
Linux的HBASE数据库集群部署
命令: tar -zxvf /export/server/hbase-2.5.10-bin.tar.gz -C /export/server/ln -s /export/server/hbase-2
阅读更多2024-10-18
LeetCode刷题日记之贪心算法（二）
在上一篇贪心算法的学习中，我们探讨了贪心算法的基本思路和逻辑框架。在这篇文章中，我将继续分享几道经典的LeetCode贪心算法题，并探讨其背后的解题思路和技巧。希望通过这些题目的实践，能加深我对贪心算
阅读更多2024-10-18
秀丽隐杆线虫的基础认识
秀丽隐杆线虫（Caenorhabditis elegans，）是一种非寄生性线虫，以大肠杆菌等微生物为食，，主要分布在温带地区的土壤中。秀丽隐杆线虫有和两种性别，在自然条件下，雌雄同体占大多数，可自体
阅读更多2024-10-18
简单认识Maven 2-Maven坐标
例如，对于一个名为 “myproject” 的项目，由 “com.mycompany” 组织开发，版本为 “2.5.0”，其 Maven坐标就是 “com.mycompany:myproject:2.
阅读更多2024-10-18
利用 HandBrake 压制视频
这是一款全桌面平台的开源免费软件，在 Windows、macOS、Linux 下均有对应的应用程序界面。HandBrake 基于鼎鼎大名的 FFmpeg 多媒体框架。FFmpeg 本身是命令行程序，可
阅读更多2024-10-18
less和sass基本使用
在LESS和SASS中，嵌套规则的写法非常相似，都使得CSS的结构更加接近HTML的结构。通过导入，我们可以将庞大的CSS项目分解为多个模块，提高代码的可读性和可维护性。嵌套规则允许你将CSS规则嵌套
阅读更多2024-10-18