白码库 data

John

• 发表于：2022年05月06日 10:55 • 更新于：2022年05月06日 10:55

1483

--data.getData(entity, id)

获取数据库中一条数据（json）

输入参数

参数名称	说明
entity	数据表id
id	数据id，每一条数据中key为”_id”对用的value即为数据id

代码如下: 复制代码

async function runProcess($model, $plugin, $params){
let item = await $plugin.data.getData("5fa8e5fb931f9d126257caf9","5fa8e5fb931f9d126257caf9");
}

若传入的两个参数正确，返回一条数据的json，key为属性id，value为对应的属性值；

若参数不正确，则返回undefined；

注意：获取的数据中关联类型的属性，对应的属性值为关联的数据id，图片/文件类型则为对应的url字符串

--data.removeData(entity, id)

删除数据库中一条数据

输入参数

参数名称	说明
entity	数据表id
id	数据id，每一条数据中key为”_id”对用的value即为数据id

代码如下: 复制代码

async function runProcess($model, $plugin, $params){
await $plugin.data.removeData("5fa8e5fb931f9d126257caf9","5fa8e5fb931f9d126257caf9");
}

无返回值

--data.saveData(entity, form)

指定一个数据表新增一条数据

输入参数

参数名称	说明
entity	数据表id
form	保存数据的属性值
form.key	属性id，不可使用”_id”(新增后会自动生成)
form.value	属性值

代码如下: 复制代码

async function runProcess($model, $plugin, $params){

    await $plugin.data.saveData("5fa8e5fb931f9d126257caf9",{         "5fa8e5fb931f9d126257caf9":100,
        "5fb1fa1ce091f85e9d69fc78":"口罩"
     });
}

返回值

若调用成功，则返回保存数据的json。

--data.updateData(entity,id,form)

修改一条数据的内容

输入参数

参数名称	说明
entity	数据表id
id	数据id
form	要修改的属性内容
form.key	要修改的属性id，不可使用”_id”
form.value	对应的属性值

代码如下: 复制代码

async function runProcess($model, $plugin, $params){
     await $plugin.data.updateData("5fb1fa1473276c5e9b02f06e","5fa8e5f6931f9d126257caf2",{
     "5fa8e5fb931f9d126257caf9":"200",
     "5fa8e5f9931f9d1262af6":"411"
     });
}

无返回值

--data.queryData(entity, query, option)

获取指定数据表的多条数据（可以理解为获取集合的步骤）

输入参数

参数名称	说明
entity	数据表id
query	获取数据的筛选条件
query.key	属性id
query.value	属性值
option	非必须参数，设置获取的数据量，不使用此参数时默认最多获取100条数据
option.page.index	分页获取
Option.page.size	每页多少条数据

代码如下: 复制代码

async function runProcess($model, $plugin, $params){
     let list1 = await $plugin.data.queryData("5fa8e5f9931f9d1262af6",{
       "5fb1fa1473276c5e9b02f06e":"口罩",
         "5fa8e5f6931f9d126257caf2":"kn95"
         },{
            page:{
                 index:1,
                size:100
            }
         });

      let list2 = await $plugin.data.queryData("5fa8e5f9931f9d1262af6",{
            "5fa8e5f6931f9d126257caf2":"kn95"
            });
}

--data.bulk(entity, bulk)

指定一个数据表进行批量操作（新增/修改/删除），运行效率比前面的通过循环调用save/update/remove更高

输入参数

参数名称	说明
entity	数据表id
bulk	操作内容
bulk.insert	批量保存数据操作，key为属性id，value为属性值，不可使用_id
bulk.update	批量修改数据操作，_id为需要修改的属性id（必须参数），key为属性id，value为属性值
bulk.remove	批量删除数据操作，_id为需要删除的数据id（必须参数）

代码如下: 复制代码

async function runProcess($model, $plugin, $params){
        await $plugin.data.bulk("5fa8e5f9931f9d1262af6",{
                insert:[{"5fa8e5fb931f9d126257caf9":"123"},
{"5fa8e5fb931f9d126257caf9":"456"}],
                update:[{_id:"5fb20321e091f85e9d69fe23","5fb1fa1473276c5e9b02f06e":"个"},
{_id:"5fa8e5fb931f9d126257caf9","5fb1fa1473276c5e9b02f06e":"件"}]
                remove:[{_id:"5eb9416bb75b4176eca49a23"},
{_id:"5fa8e53cbda8786925bde095"}]
        });
}

--data.summaryData(entity, summary_field, group_field, query)

分组统计数据表中的数据

输入参数

参数名称	说明
entity	数据表id
summary_field	需统计属性id
group_field	分组属性id
query	非必须参数，筛选条件

示例：

返回值示例：

[ { "_id": "个", "sum": 4800, "avg": 2400, "max": 4200, "min": 600, "count": 2 }, { "_id": "件", "sum": 100, "avg": 100, "max": 100, "min": 100, "count": 1 } ]

返回值参数

参数名称	说明
_id	分组属性值
sum	统计字段的合计值，如统计字段为非数字类型，则默认为0
avg	统计字段的平均值，如统计字段为非数字类型，则默认为0
max	统计字段的最大值，如统计字段为非数字类型，则默认为0
min	统计字段的最小值，如统计字段为非数字类型，则默认为0
count	统计字段的计数值