Record数据表

概述

数据表相关函数

getById

返回查询的数据表记录信息

Record.getById(tableId, recordId)

参数	类型	描述
tableId	String	数据表的标识符
recordId	String	记录ID

返回值

类型 Object 数据表记录信息，如果不存在则返回null

示例

Record.getById('order', 'z2koxrkxtp854')//{amount=11, name=测试采购单, id=z2koxrkxtp854}

getFieldValue

返回数据表记录的字段值

Record.getFieldValue(tableId, recordId, fieldId)

参数	类型	描述
tableId	String	数据表的标识符
recordId	String	记录ID
fieldId	String	字段标识符

返回值

类型 Object 数据表记录的字段值，如果记录不存在则返回null，如果属性不存在则返回null。 如果数据表不存在则抛出异常

示例

//{amount=11, name=测试采购单, id=z2koxrkxtp854} 
Record.getFieldValue('order','z2koxrkxtp854','amount')//11

getByField

根据单个字段过滤数据表记录列表

Record.getByField(tableId, fieldId, opt, value)

参数	类型	描述
tableId	String	数据表的标识符
fieldId	String	过滤的字段
opt	String	操作符，关于操作符参见ConditionOpt
value	Object	过滤条件的值

返回值

类型 Array<Record> 返回满足条件的记录列表，最多返回10000条记录，如果没有满足条件的数据，返回空数组。 如果数据表不存在则抛出异常

示例

//{amount=11, name=测试采购单, id=z2koxrkxtp854} 
Record.getByField('order', 'amount', 'eq', 11)//[{amount=11, name=测试采购单, id=z2koxrkxtp854}]

getByFields

根据多个字段过滤数据表记录列表

Record.getByFields(tableId, conditions)

参数	类型	描述
tableId	String	数据表的标识符
conditions	Array	过滤条件，关于过滤条件参见Condition

返回值

类型 Array<Record> 返回满足条件的记录列表，最多返回10000条记录，如果没有满足条件的数据，返回空数组。 如果数据表不存在则抛出异常

示例

//{amount=11, text=13, id=z2koxrkxtp854} 
Record.getByFields('tab', [{ "fieldId": 'text', "opt": "eq", "value": '13' }])//[{amount=11, text=13, id=z2koxrkxtp854}]

getRecordOptionName

返回单个选项值的名称

Record.getRecordOptionName(tableId, fieldId, value)

参数	类型	描述
tableId	String	数据表的标识符
fieldId	String	字段的标识符
value	String	选项值

返回值

类型 String 返回选项值的名称，如果选项值在选项列表中不存在，则返回传入的选项值 如果数据表不存在则抛出异常

示例

//选项值列表：a:'选项1',b:'选项2'
//{amount=11, name=测试采购单, id=z2koxrkxtp854,type=a} 
Record.getRecordOptionName('order', 'type', 'a')//选项1
Record.getRecordOptionName('order', 'type', 'c')//c

getRecordOptionNames

返回多个选项值的名称并且拼接到一起

Record.getRecordOptionNames(tableId, fieldId, valueList, join)

参数	类型	描述
tableId	String	数据表的标识符
fieldId	String	字段的标识符
valueList	Array<String>	选项值列表
join	String	拼接的字符串

返回值

类型 String 返回拼接的选项值的名称，如果选项值在选项列表中不存在，则使用选项值拼接。 如果数据表不存在则抛出异常

示例

//选项值列表：a:'选项1',b:'选项2'
//{amount=11, name=测试采购单, id=z2koxrkxtp854,type=a} 
Record.getRecordOptionNames('order', 'type', ['a', 'b'], ',')//选项1,选项2
Record.getRecordOptionNames('order', 'type', ['a', 'b', 'c'], ',')//选项1,选项2,c

getRecordOptions

返回选项值列表

Record.getRecordOptions(tableId, fieldId)

参数	类型	描述
tableId	String	数据表的标识符
fieldId	String	字段的标识符

返回值

类型 Array<Option> 返回选项值列表，如果字段不是列表选择 树形选择 级联选择则返回null。 如果数据表不存在则抛出异常

示例

//选项值列表：a:'选项1',b:'选项2'
Record.getRecordOptions('order', 'type')//[{id:'a',name:'选项1'},{id:'b',name:'选项2'}]

getRelationList

返回查询的数据表关联列表字段的值

Record.getRelationList(tableId, fieldId, recordId)

参数	类型	描述
tableId	String	数据表的标识符
fieldId	String	字段的标识符
recordId	String	记录ID

返回值

类型 Array<Record> 返回关联列表的值，如果字段不是关联列表则返回空数组。 如果数据表不存在则抛出异常

示例

Record.getRelationList('order','orderDetail','z2koxrkxtp854')