创建“查询工单”脚本及公共接口

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

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

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

import * as context from 'context';
import * as db from 'db';
import * as decimal from 'decimal';//导入decimal数据类型相关的标准库
 
@useObject(['HW__WorkOrder__CST'])
 
@action.object({ type: "param" })
export class ActionInput {
    @action.param({ type: 'String' })
    title: string;
    @action.param({ type: 'String' })
    status: string;
    @action.param({ type: 'String' })
    createdBy: string;
    @action.param({ type: 'Boolean' })
    isFME: boolean;
    @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', label: 'object', isCollection: true })
    workOrderList: object[];
    @action.param({ type: 'String' })
    total: string;//总共查到几条数据
}
 
@action.object({ type: "method" })
export class QueryWorkOrder {
    @action.method({ input: 'ActionInput', output: 'ActionOutput' })
    public queryWorkOrder(input: ActionInput): ActionOutput {
        let out = new ActionOutput();    //新建出参ActionOutput类型的实例，作为返回值
        let error = new Error();    //新建错误类型的实例，用于在发生错误时保存错误信息
        try {
            let s = db.object('HW__WorkOrder__CST');    //获取HW__WorkOrder__CST这个Object的操作实例
 
            //condition是db标准库queryByCondition方法的入参（查询条件）
            let condition = {
                "conjunction": "AND",
                "conditions": []
            };
            //基本查询条件
            condition.conditions.push({
                "field": "id",
                "operator": "isnotnull",
            });
            condition.conditions.push({
                "field": "id",
                "operator": "ne",
                "value": ""
            });
            //按title查询
            if (input.title && input.title != "") {
                condition.conditions.push({
                    "field": "HW__title__CST",//与对象中的字段名保持一致
                    "operator": "contains",
                    "value": input.title
                });
            }
            //按status查询
            if (input.status && input.status != "") {
                condition.conditions.push({
                    "field": "HW__status__CST",//与对象中的字段名保持一致
                    "operator": "eq",
                    "value": input.status
                });
            }
            //按title查询
            if (input.createdBy && input.createdBy != "") {
                condition.conditions.push({
                    "field": "createdBy",//与对象中的字段名保持一致
                    "operator": "eq",
                    "value": input.createdBy
                });
            }
            if (input.isFME) {
                condition.conditions.push({
                    "field": "HW__assignedFme__CST",
                    "operator": "eq",
                    "value": context.getUserName()
                });
            }
            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;
            }
            let workOrderList = s.queryByCondition(condition, option);
            for (let i in workOrderList) {
                if (workOrderList[i].HW__status__CST == "关闭") {
                    workOrderList[i].isDeal = true;
                }
            }
            out.workOrderList = workOrderList;
            //调用查询符合condition条件的数据总数的接口
            out.total = s.count(condition) + "";
        } catch (error) {
            console.error(error.name, error.message);
            context.setError(error.name, error.message);
        }
        return out;
    }
}

1. 单击编辑器上方的，执行脚本。
2. 在界面底部，查询脚本可以不提供输入参数，直接单击测试窗口右上角执行图标。

   执行成功，会在“输出”页签返回查询结果。

   图1 输出结果示例
   

设置接口参数信息：操作名称为“queryWorkOrder”，版本为“1.0.0”，URL为“/queryWorkOrder”，“类型”选择“脚本”，“资源”为“HW__queryWorkOrder”，方法为“POST”，然后单击“保存”。

图2 新建queryWorkOrder接口