函数介绍

您现在所在位置:首页>平台功能介绍>函数介绍>系统业务函数介绍
 

3  系统业务函数介绍

1. ArgsToArray()函数介绍

将参数列表转换成数组。

代码示例:ArgsToArray(args0,args1,args2,...)

参数:不定类型

返回值类型:数组类型。

注:该函数的返回值只能作为其他函数的参数,不能赋值给某个变量。

2. AvgColumn()函数介绍

计算指定实体的字段的平均值并返回。

代码示例:AvgColumn("EntityName","ColumnName") 返回值为实体"EntityName""ColumnName"字段的字段平均值。

参数1--实体名(字符串类型)

参数2--字段名(字符串类型)

返回值为数字类型。

3. AvgColumnFunc()函数介绍

计算实体某个字段的平均值。

代码示例:AvgColumnFunc("BR_IN_PARENT.xiaoshu","price") 返回实体字段price的平均值。

参数1--活动集实体(字符串类型)

参数2--计算平均值的字段名称(字符串类型))

返回值类型:数字类型。

4. Convert()函数介绍

格式转换,将指定值转换成指定格式返回。

代码示例:Convert(3,2) 返回值为"3"

参数1--传入的数据(各种类型)

参数2--转换的类型,1-数字,2-字符串,3-布尔值;

返回值为不确定的类型,根据参数2的格式而定。

5. ConvertFunc()函数介绍

格式转换,将指定值转换成指定格式返回。

代码示例:Convert(3,2) 返回值为"3"

参数1--传入的数据(各种类型)

参数2--转换的类型,1-整数,2-字符串,3-布尔值,4-小数;

返回值为不确定的类型,根据参数2的格式而定。

6. ConvertPageNumber()函数介绍

转换页码,将记录开始数转换成页码。

代码示例: ConvertPageNumber (3,4) 返回值为1

参数1--记录开始数(整形)

参数2--分页显示数(整形)

返回值为整形类型。

7. DecodeURIComponent()函数介绍

将字符串作为URI组件进行解码。

代码示例:

DecodeURIComponent("www.baidu.com%2Fs%3Fwd%3D%E5%90%8C%E6%9C%9B%E7%A7%91%E6%8A%80")返回值为经过js原生方法解码的字符串。

参数1--需要解码的字符串。

8. DeleteCookie()函数介绍

根据名称删除cookie,成功删除返回True,删除出错返回False

代码示例:DeleteCookie("cookieName")返回值为true

参数1--想要删除的Cookie名称;

返回值为布尔类型。

9. EncodeURIComponent()函数介绍

将字符串作为URI组件进行编码。

代码示例:EncodeURIComponent("www.baidu.com/s?wd=同望科技")返回值为经过js原生方法编码的字符串。

参数1--需要编码的字符串。

返回值为字符串类型。 

10. EvalExpression()函数介绍

校验执行表达式的函数

代码示例:EvalExpression("@@userName") 返回系统变量userName的值。

参数1--为字符串表达式。

返回值为不定类型。

11. GenerateUUID()函数介绍

生成一个uuid

代码示例:GenerateUUID()返回一个uuid字符串。

无参数;

返回值为字符串。

12. GetContextPath()函数介绍

获取当前应用上下文

代码示例:GetContextPath() 获取当前应用上下文;

无参数;

返回值为字符串。

13. GetCookie()函数介绍

从客户端获取cookie值。

代码示例:GetCookie("cookieName","default")返回值为Cookie的内容。

参数1--cookie名称(字符串类型);

参数2--cookie为空使用默认值(字符串类型);

返回值为字符串类型。

14. GetCurrentCalendarMonth()函数介绍

获取日历控件当前月份

代码示例:GetCurrentCalendarMonth("JGCalendar1")返回值为"201509"

参数1--日历控件ID(字符串类型);

返回值为字符串类型。

15. GetCurrentRecordIndex()函数介绍

根据实体名称获取当前行,并返回索引值(目前为id字段值)。

代码示例:

GetCurrentRecordIndex("EntityName") 返回实体EntityName当前行id字段的值。

参数一:实体名称(字符串类型)

返回值类型:字符串类型。

16. GetCurrentWindowInstanceCode()函数介绍

获取当前窗体实例的code

代码示例:GetCurrentWindowInstanceCode()返回一个窗体实例code的字符串。

无参数;

返回值为字符串。

17. GetConditionColumnValue()函数介绍

1、根据条件查询指定数据源中某个字段的值 2、如果该条件下返回多条记录,则取第一条记录的值。

代码示例:GetConditionColumnValue("sys_user","account","id=1")

参数1--dataSourceName:数据源名称(字符串类型)

参数2--columnName:数据源中的字段名(字符串类型)

参数3--condition:查询条件(字符串类型)

18. GetEntityCurrentColumnValue()函数介绍

从指定的实体获取当前记录的某字段值。

代码示例:

界面实体:GetEntityCurrentColumnValue("EntityName","ColumnName")

活动集实体:GetEntityCurrentColumnValue(BR_IN_PARENT.EntityName,"ColumnName"),返回当前行该字段值。

参数1--实体名(字符串类型/活动集变量)

参数2--字段名(字符串类型)

返回值类型:与参数二所选字段的类型一致。

19. GetEntityRowCount()函数介绍

从指定的实体获取记录数。

代码示例:

界面实体:GetEntityRowCount("TableName","[TableName].[FieldValue]==1")

活动集实体:GetEntityRowCount("BR_IN_PARENT.TableName","[TableName].[FieldValue]==1"),返回符合条件的实体记录数。

参数1--实体表名(字符串类型)

返回值为整型。

参数2是一个字符串,其运算结果应该是布尔值。如果该参数省略,则返回实体总记录数。

20. GetEntitySelectedRowCount()函数介绍

获取界面实体选中行数。

代码示例:

GetEntitySelectedRowCount("TableName") 

参数1--实体名称,字符串类型。

返回值类型:整型。

21. GetEntityRowCountFunc()函数介绍

从指定的方法输入、方法输出,方法变量实体获取记录数。

代码示例:GetEntityRowCountFunc("BR_IN_PARENT.aa"),返回实体的记录数。

参数1--实体表名(字符串类型)

返回值为整型。

22. GetFirstRowColumnValue()函数介绍

获取实体变量首行记录字段值。

代码示例:

活动集实体:GetFirstRowColumnValue("BR_VAR_PARENT.interView","id")

界面实体:GetFirstRowColumnValue("entity","id"),返回值为该实体变量首行记录的id字段值。

参数1--实体变量名(字符串类型)

参数2--字段名(字符串类型)

返回值为字段对应的类型。

23. GetHost()函数介绍

获取当前域名。

代码示例:GetHost() 返回值为"www.baidu.com"

返回值为字符串类型。

24. GetImageUrl()函数介绍

根据图片的文件id获取图片的URL路径。

代码示例:GetImageUrl("8a819ab551c2421c0151c3b597b80ddf"),返回值为图片的URL路径。

参数1--图片的文件id(字符串类型)

返回值为字符串类型。

25. GetLoactionPlace()函数介绍

根据经度纬度获取地理位置

代码示例:GetLoactionPlace(22.280539000,113.5719410),返回值:珠海。

参数1--纬度(小数类型);

参数2--经度(小数类型);

返回值类型:字符串类型。

26. GetIPAddress()函数介绍

返回当前客户端的IP地址(注意返回的是服务器端获取到的请求IP地址)

代码示例:GetIPAddress()返回当前客户端的IP字符串;

无参数;

返回值为字符串。

27. GetloginUserNum()函数介绍

返回当前的在线用户数(实时获取)

代码示例:GetloginUserNum()返回当前的在线用户数(实时获取)

无参数;

返回值为整型。

28. GetRequestParmByKey()函数介绍

通过key值获取get请求的参数值。

代码示例:GetRequestParmByKey("componentCode")返回值为get请求参数中keycomponentCode的值。

参数1--get请求参数的key

返回值为字符串类型。 

29. GetSelectedRecordNum()函数介绍

从指定的界面实体获取选中行的记录数。

代码示例:GetSelectedRecordNum("EntityName"),返回实体选中的记录数。

参数1--实体表名(字符串类型)

返回值为整型。

30. GetSerialNumber()函数介绍

根据前缀,取出表里的最大流水号加1后,补齐位数返回字符串。

代码示例:GetSerialNumber("TableName","ColumnName","19980105--",3,"0") 返回值为001

参数1--表名(字符串类型)

参数2--字段名(字符串类型)

参数3--前缀字符串(字符串类型)

参数4--流水号长度(整型)

参数5--补位符(字符串类型,并且长度必须为1)

返回值为字符串类型。

31. GetSerialNumberFunc ()函数介绍

根据前缀,取出表里的最大流水号加1后,补齐位数返回字符串。

代码示例:GetSerialNumberFunc("testEn","value","20151103--","11","0","0","3","true","true") 返回值为00000000001

参数1--表名(字符串类型)

参数2--字段名(字符串类型)

参数3--前缀字符串(字符串类型)

参数4--流水号长度(字符串类型)

参数5--补位符(字符串类型,并且长度必须为1)

参数6--查询语句的like(字符串类型)

参数7--截取串长度(字符串类型)

参数8--是否从左边截取(字符串类型)

参数9--是否重用流水号(字符串类型)

返回值为字符串类型。

32. GetSystemVariable()函数介绍

获取构建变量或者构建常量,如无该构件变量时,就取构件常量。

代码示例:GetSystemVariable(BR_IN_PARENT.arg1) 返回值为 "EEEE"

参数1--构建变量或者常量名(字符串类型);

返回值类型为不定,由构建变量或者构建常量决定。

33. GetTableData()函数介绍

根据表名字段名以及过滤条件获取数据,返回获取的结果。

代码示例:GetTableData("ColumnName","Table1","ID='3'") 返回值为表Table1ID=3的行的ColumnName列的值。

参数1--表字段名称(字符串类型);

参数2--表名称(字符串类型);

参数3--过滤条件(字符串类型);

返回值为字符串。

34. HasRecord()函数介绍

计算数据库表中数据量。

代码示例:HasRecord("Entity1") 返回值为 3

参数1--数据库表明(字符串类型);

返回值为整数类型。

35. IsLeaf()函数介绍

判断实体中,指定ID的记录是否叶子节点,如果nodeId为空, 则判断当前控件的选中节点。是叶子则返回True

代码示例:

IsLeaf("EntityName", "ID",

"type:1,pidField:PID,treeCodeField:InnerCode,orderField:orderNo,isLeafField:isLeaf,busiFilterField:busiFilter")

参数1:实体名称(字符串类型);

参数2:记录ID(字符串类型);

参数3:树结构配置项(字符串类型)。各配置项之间以逗号隔开,配置项以“名称:值”的形式表示;

返回值:true/false(布尔值);

异常情况:实体不存在、实体没有记录、指定ID的记录

36. IsLogin()函数介绍

判断当前用户是否已登录

代码示例:IsLogin() 当前用户是否已登录;

无参数;

返回值为布尔。

37. IsNull()函数介绍

检查输入的参数是否为空值,不为空返回原值,为空返回默认值。

代码示例:IsNull(arg,defaultVal)第一个参数不为空直接返回第一个参数,为空时返回默认值。

参数1--被检查的值;

参数2--为空时的缺省值;

返回值为返回参数的数据类型。

38. IsNullOrEmpty()函数介绍

arg是否为空或0长度字符串,如果是则返回默认值defaultVal,否则返回指定的参数arg

代码示例:IsNullOrEmpty(arg,defaultVal)第一个参数不为空或0长度字符串直接返回第一个参数,为空时返回默认值。

参数1--被检查的值(字符串类型);

参数2--缺省值(任意类型);

返回值为返回参数的数据类型。

39. IsNullOrEmptyFunc()函数介绍

判断参数是否为空或0长度字符串,返回 true 或者 false

代码示例:IsNullOrEmptyFunc(""),返回 true

参数1--被检查的值(字符串类型);

返回值为布尔类型。

40. MaxColumn()函数介绍

查询指定实体的字段的最大值并返回。

代码示例:MaxColumn("EntityName","ColumnName") 返回值为实体"EntityName""ColumnName"字段的最大值。

参数1--实体名(字符串类型)

参数2--字段名(字符串类型)

返回值为数字类型。

41. MD5Encrypt()函数介绍

对字符串进行加密,加密算法为MD5算法。

代码示例:MD5Encrypt("Example"),返回值加密后的字符串。

参数1--加密串(字符串类型)

返回值为字符串类型。

42. MinColumn()函数介绍

查询指定实体的字段的最小值并返回。

代码示例:MinColumn("EntityName","ColumnName")返回值为实体"EntityName""ColumnName"字段的最小值。

参数1--实体名(字符串类型)

参数2--字段名(字符串类型)

返回值为数字类型。

43. Null()函数介绍

产生null值。可在加载规则查询条件中使用,令查询条件失效。

代码示例:null(),返回 null 

返回值为 null

44. SetCookie()函数介绍

设置cookie的值。

代码示例:SetCookie("CookieName","Value") 操作成功返回True

参数1--cookie名称(字符串类型);\\参数2--cookie的值(字符串类型);

返回值为布尔类型。

45. SelectOrQuitAllRecords()函数介绍

全选或取消全选界面实体记录

代码示例:

SelectOrQuitAllRecords("TableName","select") 全选实体记录

SelectOrQuitAllRecords("TableName","quit")  取消全选实体记录

参数1--实体名称,字符串类型

参数2--select代表全选,quit代表取消全选,字符串类型

无返回值

46. SetRecordValue()函数介绍

根据索引值(目前为id值),获取实体记录,批量设置字段值,最后更新数据到实体中。

代码示例:

SetRecordValue("EntityName","index",fields,values)

参数一:实体名称(字符串类型);

参数二:记录索引值(字符串类型);

参数三:字段编码集合(数组类型,与函数ArgsToArray搭配使用);

参数四:字段值集合,与字段编码集合一一对应(数组类型,与函数ArgsToArray搭配使用);

无返回值。

47. TotalColumn()函数介绍

计算指定实体的字段的汇总值并返回。

代码示例:

界面实体:TotalColumn("EntityName","ColumnName")

活动集实体:TotalColumn(BR_VAR_PARENT.EntityName,"ColumnName"),返回值为实体的ColumnName字段的汇总值。

参数1--实体名(字符串类型/活动集实体)

参数2--字段名(字符串类型)

返回值类型:与参数二所选字段的类型一致。

48. TotalColumnFunc()函数介绍

计算实体某个字段的总和。

代码示例: TotalColumnFunc("BR_IN_PARENT.xiaoshu","price") 返回实体字段price的总和。

参数1--活动集实体(字符串类型)

参数2--计算总和的字段名称(字符串类型)

返回值类型:数字类型。

49. TreeNodePath()函数介绍

返回树选中节点的路径,如果选中多个节点时候只返回第一个选中节点的路径。

代码示例:

TreeNodePath("Table1","Table1.Column1","\\","type:1,pidField:PID,treeCodeField:InnerCode,orderField:orderNo,isLeafField:isLeaf")返回值为根节点Column1字段的值\第一级节点Column1字段的值\第二级节点Column1字段的值\\选中节点Column1字段的值。

参数1--树型实体名(字符串类型) 

参数2--字段名(字符串类型)

参数3--间隔;

参数4--树结构配置项;

返回值为字符串类型。

50. V3If()函数介绍

先计算条件表达式的结果,再根据结果返回参数值;结果为true,则返回第1个参数,否则返回第2个参数。

代码示例:V3If(1==1,20,30) 返回值为 20

参数1--条件表达式(布尔类型)

参数2--条件表达式为true时返回值(各种类型)

参数3--条件表达式为false时返回值(各种类型);

返回值类型不定,由参数2,或者参数3决定。