更新时间:2024-06-25 GMT+08:00
分享

创建“查询设备”脚本

管理设备页面中,实现输入设备的信息,查询出对应设备的全部信息功能,需要开发“查询设备”脚本和服务编排。

操作步骤

  1. 进入创建“设备维修管理系统”应用中创建的应用。
  2. 在“Equipment”目录中,将鼠标放在“Script”上,单击界面上出现的,在弹出菜单中选择“脚本”。
  3. 在弹窗中,选中“创建一个新脚本”,在“名称”文本框中输入“queryEquipments”,单击“添加”。

    系统实际创建的脚本名称为“HW__queryEquipments”,“HW__”前缀由租户命名空间namespace决定。新建创建的脚本,默认是当前用户锁定状态,可以进行编辑保存等操作。

    当编辑已有脚本时,为防止编辑时多人篡改,编辑前请单击进行锁定。

  4. 在代码编辑器中,插入如下脚本代码。

    脚本中红色内容请替换为实际的对象名、字段名。

    /****************************
     * 本脚本用于按条件查询设备列表
     * **************************/
    import * as db from 'db';//导入处理object相关的标准库
    import * as context from 'context';//导入上下文相关的标准库
    import * as decimal from 'decimal';//导入decimal数据类型相关的标准库
    //定义入参结构
    @action.object({ type: "param" })
    export class ActionInput {
        @action.param({ type: 'String' })
        name: string;//设备名称,需要按设备名称查询时传入
        @action.param({ type: 'String' })
        fullAddress: string;//完整地址,需要按完整地址查询时传入
        @action.param({ type: 'Number', min: 0 })
        start: decimal.Decimal;//分页信息,表示从第几条数据开始查询
        @action.param({ type: 'Number', min: 0 })
        limit: decimal.Decimal;//分页信息,表示一次查询几条数据
    }
    //定义出参结构
    @action.object({ type: "param" })
    export class ActionOutput {
        @action.param({ type: 'Any', isCollection: true, label: 'object' })
        equipments: object[];//设备列表
        @action.param({ type: 'String' })
        total: string;//总共查到几条数据
    }
    @useObject(['HW__Equipment__CST']) //使用数据库对象HW__Equipment__CST
    @action.object({ type: "method" })
    export class QueryEquipments {
        @action.method({ input: 'ActionInput', output: 'ActionOutput' })
        public queryEquipments(input: ActionInput): ActionOutput {
            let out = new ActionOutput(); //新建出参ActionOutput类型的实例,作为返回值
            try {
                //获取HW__Equipment__CST这个Object的操作实例
                let s = db.object('HW__Equipment__CST');
                //option是db标准库queryByCondition方法的入参(选项选项),用于对查询结果排序、分组、聚合计算等
                //这里构造的是按创建时间逆序返回查询结果
                let option = {
                    "options": {
                        "orderby": [
                            {
                                "field": "createdDate",
                                "order": "desc"
                            }
                        ],
                    }
                };
                //如果有分页
                if (input.start && input.limit) {
                    let start = decimal.toNumber(input.start);//将decimal类型转换为接口需要的number类型
                    let limit = decimal.toNumber(input.limit);
                    option.options['limit'] = limit;
                    option.options['skip'] = start;
                }
                //condition是db标准库queryByCondition方法的入参(查询条件)
                let condition = {
                    "conjunction": "AND",
                    "conditions": []
                };
                //基本查询条件
                condition.conditions.push({
                    "field": "id",
                    "operator": "isnotnull",
                });
                condition.conditions.push({
                    "field": "id",
                    "operator": "ne",
                    "value": ""
                });
                //按设备名称查询
                if (input.name && input.name != "") {
                    condition.conditions.push({
                        "field": "name",//与对象中的字段名保持一致
                        "operator": "contains",
                        "value": input.name
                    });
                }
                //按设备地址查询
                if (input.fullAddress && input.fullAddress != "") {
                    condition.conditions.push({
                        "field": "HW__fullAddress__CST",
                        "operator": "contains",
                        "value": input.fullAddress
                    });
                }
                //调用按条件查询HW__Equipment__CST的接口
                out.equipments = s.queryByCondition(condition, option);
                //构造实时监控页面需要的属性字段longitude__CST、latitude__CST、fullAddress__CST和equipmentSn__CST
                for (let equip of out.equipments || []) {
                    equip['longitude__CST'] = equip['HW__longitude__CST'];//与对象中的字段名保持一致
                    equip['latitude__CST'] = equip['HW__latitude__CST'];
                    equip['fullAddress__CST'] = equip['HW__fullAddress__CST'];
                    equip['equipmentSn__CST'] = equip['HW__equipmentSN__CST'];
                }
                //调用查询符合condition条件的数据总数的接口
                out.total = s.count(condition) + "";
            } catch (error) {
                console.error(error.name, error.message);
                context.setError(error.name, error.message);
            }
            return out;
        }
    }

  5. 单击编辑器上方的,保存脚本。
  6. 测试脚本能否正常执行。

    1. 单击编辑器上方的,执行脚本。
    2. 在界面底部,直接单击测试窗口右上角,执行脚本。

      执行成功后,会在“输出”页签返回全部设备信息。

  7. 测试成功,单击编辑器上方的,启用脚本。

相关文档