系统业务函数

客户端函数 - 系统业务函数API汇总。

将参数列表转换成数组-ArgsToArray()

将参数列表转换成数组。
注：该函数的返回值只能作为其他函数的参数，不能赋值给某个变量。

参数与返回值:

名称	类型	描述
参数1	Indefinite	传入的数据；不定类型

返回值	Array	数组；

示例及效果：

名称	描述
示例	ArgsToArray(args0,args1,args2,...)
返回值	7,5
效果

计算实体字段平均值-AvgColumn()

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

参数与返回值:

名称	类型	描述
参数1	String	实体名称；其他变量实体需要加上变量的前缀；
参数2	String	字段名；

返回值	Number	平均值；

示例及效果：

名称	描述
示例	代码示例: AvgColumn("EntityName","ColumnName") ；返回值为：实体"EntityName"的"ColumnName"字段的字段平均值。界面实体：AvgColumn("EntityName","ColumnName") ；返回值为：实体"EntityName"的"ColumnName"字段的字段平均值。活动集实体：AvgColumn("BR_VAR_PARENT.entity","ColumnName") ；返回值为：实体"BR_VAR_PARENT.entity"的"ColumnName"字段的字段平均值。
效果

名称

描述

示例

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

界面实体：AvgColumn("EntityName","ColumnName") ；
返回值为：实体"EntityName"的"ColumnName"字段的字段平均值。

活动集实体：AvgColumn("BR_VAR_PARENT.entity","ColumnName") ；
返回值为：实体"BR_VAR_PARENT.entity"的"ColumnName"字段的字段平均值。

效果

将人民币金额转成中文大写-ChangeMoneyToChinese()

将人民币金额转成中文大写。

参数与返回值:

名称	类型	描述
参数1	String	要转换的金额；

返回值	String	大写金额；

示例及效果：

名称	描述
示例	ChangeMoneyToChinese(998.1314)
返回值	"玖佰玖拾捌元壹角叁分壹厘肆毫"
效果

中文检查-CheckChinese()

检查指定字符串是否包含中文字符。

参数与返回值:

名称	类型	描述
参数1	String	待检查字符串；

返回值	Boolean	包含中文字符返回True，否则返回false。

示例及效果：

名称	描述
示例	CheckChinese("a你好bc")
返回值	True
效果

数字/字符串/布尔格式转换-Convert()

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

参数与返回值:

名称	类型	描述
参数1	Indefinite	传入的数据；不定类型
参数2	Integer	转换的类型，1 - 数字；2 - 字符串；3 - 布尔值；

返回值	Indefinite	转换后的格式；不定类型，根据参数2的格式而定。

示例及效果：

名称	描述
示例1	Convert(3,1) 返回: 3
示例2	Convert(3,2) 返回: "3"
示例3	Convert(3,3) 返回: True
效果

存储单位的转换-ConvertUnit()

根据当前值和当前单位，转换成对应单位的数存储容量。如不指定目标单位，目标单位由系统匹配最合适的单位。.

[!Tip]
注意:
（1）当前只支持存储容量单位的转换。
（2）目前支持的存储容量单位：b,B,KB,MB,GB,TB,PB,EB,ZB,YB,BB,NB,DB,CB。
（3）最合适的单位是指：系统会将当前值转换到[0.1,500]范围内，所得到的单位就是最合适的单位。
（4）若当前单位是最小时，且当前值小于0.1，系统不会进行转换。
（5）若当前单位时最大时，且当前值大于500，系统不会进行转换。

参数与返回值:

名称	类型	描述
参数1	Number	当前数值；
参数2	String	当前单位；
参数3	String	目标单位；该参数可省略

返回值	String	转换后的存储容量值；

示例及效果：

名称	描述
示例1	ConvertUnit(1024,"M")；返回: "1GB"。
示例2	ConvertUnit(1048576,"CB")；返回: "1048576CB"。
效果

插入字符串到实体字段值-ConvertVarToEntityColumn()

将字符串的值添加到实体中指定的字段里面。

参数与返回值:

名称	类型	描述
参数1	String	来源字符串；
参数2	String	实体编码；
参数3	String	字段编码；
参数4	String	参数一中多个数据之间的分隔符；

返回值		无返回值；

示例及效果：

名称	描述
示例	ConvertVarToEntityColumn("今天;明天;后天","entityCode","fieldCode",";")；
效果

日期转化为中文-DateTimeToChinese()

将日期转化为中文。
参数与返回值:
名称 类型 描述
参数1 String/DateTime 日期时间；(必填，时间类型或满足时间格式的字符串类型)
参数2 String 转换格式；(必填)
格式说明：月(M)、日(d)、12时(h)、24时(H)、分(m)、秒(s)、周(E)、季度(q)，周(E)用1-3个占位符,季（q）用1个占位符；
注：必须与参数1给定的字符串格式和单位的个数对应，周和季度部分可以多选填。
返回值 String 中文日期；
示例及效果：
名称 描述
示例 DateTimeToChinese("2021-08-04 13:30:33","yyyy.MM.dd")
返回值 "二〇二一年八月四日"
效果

名称	类型	描述
参数1	String/DateTime	日期时间；(必填，时间类型或满足时间格式的字符串类型)
参数2	String	转换格式；(必填) 格式说明：月(M)、日(d)、12时(h)、24时(H)、分(m)、秒(s)、周(E)、季度(q)，周(E)用1-3个占位符,季（q）用1个占位符；注：必须与参数1给定的字符串格式和单位的个数对应，周和季度部分可以多选填。

返回值	String	中文日期；

名称	描述
示例	DateTimeToChinese("2021-08-04 13:30:33","yyyy.MM.dd")
返回值	"二〇二一年八月四日"
效果

字符串URI解码-DecodeURIComponent()

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

参数与返回值:

名称	类型	描述
参数1	String	需要解码的字符串；

返回值	String	经过js原生方法解码的字符串；

示例及效果：

名称	描述
示例	DecodeURIComponent("www.baidu.com%2Fs%3Fwd%3D%E5%90%8C%E6%9C%9B%E7%A7%91%E6%8A%80")；
返回值	"www.baidu.com/s?wd=同望科技"
效果

字符串解密-Decrypt()

对字符串进行解密，解密算法目前支持base64、aes两种解密方式。

参数与返回值:

名称	类型	描述
参数1	String	需要解密的字符串；
参数2	String	解密类型（必填，目前支持base64、aes两种方式）；
参数3	String	解密密钥（选填，aes方式需要）；

返回值	String	解密后的字符串；

示例及效果：

名称	描述
示例	Decrypt("PCF4bWw+PC8+","base64")；返回值为： `<!xml></>`。
效果

字符串解密-DecryptFunc()

对字符串进行解密，解密算法目前只支持AES解密方式。

参数与返回值:

名称	类型	描述
参数1	String	需要解密的字符串，必填，默认使用UTF-8编码。
参数2	String	解密算法，必填，不区分大小写。目前只支持AES。
参数3	String	密钥，必填。

返回值	String	解密后的字符串。

示例及效果：

名称	描述
示例	DecryptFunc("12345","AES","xxxx")
返回值
效果

删除cookie-DeleteCookie()

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

参数与返回值:

名称	类型	描述
参数1	String	想要删除的Cookie名称；

返回值	Boolean	是否成功删除；

示例及效果：

名称	描述
示例	DeleteCookie("cookieName")
返回值	True
效果

根据文件标识删除文件-DeleteFileByFileId()

根据文件标识删除(MongoDB)文件。

参数与返回值:

名称	类型	描述
参数1	String	文件标识；

返回值		无返回值；

示例及效果：

名称	描述
示例	DeleteFileByFileId("5437f8796840b8365df518e8b56da388") ；删除标识id对应的文件。
效果

字符串URI编码-EncodeURIComponent()

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

参数与返回值:

名称	类型	描述
参数1	String	需要编码的字符串；

返回值	String	经过js原生方法编码的字符串；

示例及效果：

名称	描述
示例	DEncodeURIComponent("www.baidu.com/s?wd=同望科技")
返回值	"www.baidu.com%2Fs%3Fwd%3D%E5%90%8C%E6%9C%9B%E7%A7%91%E6%8A%80"
效果

加密字符串-Encrypt()

对字符串进行加密，加密算法目前支持bcrypt、md5、standardMd5、sha1、crypto-sha1、base64及aes加密方式。

参数与返回值:

名称	类型	描述
参数1	String	需要加密的字符串；必填
参数2	String	加密类型（必填，目前支持bcrypt、md5、standardMd5、sha1、crypto-sha1、base64及aes方式）；注意: md5加密算法为MD5+BASE64算法； standardMd5为MD5标准加密算法； sha1为ASCII中文编码方式（不推荐）； crypto-sha1为标准Unicode中文编码方式（推荐）；
参数3	String	加密密钥（选填，aes方式需要填）；

返回值	String	加密后的字符串；

示例及效果：

名称	描述
示例	Encrypt("12345","bcrypt")
返回值	下图返回值；
效果

加密字符串-EncryptFunc()

对字符串进行加密。

参数与返回值:

名称	类型	描述
参数1	String	需要加密的字符串；必填，默认使用UTF-8编码；
参数2	String	加密算法，必填，不区分大小写。支持以下类型： md5：基于RFC 1321。安全性一般，性能高，不可逆，返回32位16进制。主要用于一致性验证、数字签名等 SHA-1：基于NIST's FIPS 180-4，安全比md5高，性能比md5慢，不可逆，返回32位16进制。 SHA-256：基于NIST's FIPS 180-4，安全比SHA-1高，性能比SHA-1慢，不可逆，返回64位16进制。 SHA-384：基于NIST's FIPS 180-4，安全比SHA-256高，性能比SHA-256慢，不可逆，返回96位16进制。 SHA-512：基于NIST's FIPS 180-4，安全比SHA-384高，性能比SHA-384慢，不可逆，返回128位16进制。 AES：基于PKCS #5。对称加密，可逆，安全性高，是一种区块加密标准。广泛用于金融财务、在线交易等领域。
参数3	String	密钥，必填；当且仅当参数2为AES，请填写正确密钥，其他参数任意填写。 AES密钥要求：长度要求为16byte，不足将补0，超过16byte将自动截取。不建议使用中文作为密钥，推荐大小字符以及数字的组合。

返回值	String	加密后的字符串；

示例及效果：

名称	描述
示例	EncryptFunc("12345","md5","xxxx");

效果

实体序列化成字符串-EntityToVar()

将一个或者多个实体序列化成字符串。

参数与返回值:

名称	类型	描述
参数1	String	实体编码；

返回值	String	实体序列化的字符串；

示例及效果：

名称	描述
示例	EntityToVar("para1,para2,...,paran")；参数字符串表示一个或者多个实体编码以逗号分隔的字符串。例如：EntityToVar("ENT_entityCode")
返回值	实体编码为"ENT_entityCode"的实体的序列化字符串。
效果

校验执行表达式-EvalExpression()

校验执行表达式的函数。

参数与返回值:

名称	类型	描述
参数1	String	字符串表达式；

返回值	Indefinite	表达式执行结果；

示例及效果：

名称	描述
示例	EvalExpression("@@userName")
返回值	系统变量userName的值
效果

获取控件编码-FindControl()

根据条件获取控件编码。

参数与返回值:

名称	类型	描述
参数1	String	实体名；必填
参数2	String	字段名；必填
参数3	String	控件类型；选填，例如JGButton、JGTreeView.....；
参数4	Integer	下标；选填，不填的话默认为0；下标从0开始，如果找到多个控件，返回第X个，需要容错处理，如果下标超过实际匹配的控件个数时，返回最后一个，小于0时，返回所有找到的控件且控件编码逗号分割。注意：如果没符合条件的控件，返回""空字符串，如果找到多个符合条件的控件，指按照下标返回第N个（注意容错），如果未指定下标，返回多个控件编码，逗号间隔。

返回值	String	控件编码；

示例及效果：

名称	描述
示例1	FindControl("UserInfo","UserCode","JGTextBox",0) 获取界面上绑定UserInfo实体字段名UserCode第1个;
示例2	FindControl("UserInfo","UserCode","JGTextBox",1) 获取界面上绑定UserInfo实体字段名UserCode的第2个JGTextBox控件，如果界面上仅找到1个符合条件的控件返回第1个控件编码;
示例3	FindControl("UserInfo","UserCode","JGTextBox",99) 获取界面上绑定UserInfo实体字段名UserCode的JGTextBox控件，如果未找到返回空，如果符合条件控件但是小于99个，返回最后一个控件;
示例4	FindControl("UserInfo","UserCode","",-1) 获取界面上绑定UserInfo实体字段名UserCode的所有控件，不区分控件类型，返回多个控件编码，逗号间隔FindControl("UserInfo","UserCode")等效FindControl("UserInfo","UserCode","",-1)

效果

取连续的流水号-GenerateSequenceNumber()

取连续的流水号。

参数与返回值:

名称	类型	描述
参数1	String	流水号种子。根据该种子生成流水号，最长128位字符串，建议64位或者更短。
参数2	String	生成模式；支持模式： INC：最大号+1； REUSE：重用废弃的流水号，当没有废号可用时，同INC； ASSIGNERR：用给定的值作为流水号，如果该值已被占用，那么生成失败； ASSIGNINC：用给定的值作为流水号，如果该值已被占用，那么同INC； ASSIGNREUSE：用给定的值作为流水号，如果该值已被占用，那么同REUSE；
参数3	Integer	需要使用的废弃流水号。当且仅当参数2为ASSIGNERR、ASSIGNINC、ASSIGNREUSE才有效。

返回值	Integer	流水号；

示例及效果：

名称	描述
示例	GenerateSequenceNumber ("123456", "INC")
返回值	"1"
效果

取流水号-GenerateSequenceNumberQuick()

取流水号，最优化处理。有断号。

参数与返回值:

名称	类型	描述
参数1	String	流水号种子；根据该种子生成流水号，最长128位字符串，建议64位或者更短。

返回值	Integer	流水号；

示例及效果：

名称	描述
示例	GenerateSequenceNumberQuick("123456")
返回值	GetAgeByIdCard1
效果

根据模版生成文本-GenerateTextByTemplate()

传入带有动态标签的模版字符串，从当前数据源中获取数据并填充到模版中，返回填充后的文本字符串。

参数与返回值:

名称	类型	描述
参数1	String	模版字符串；

返回值	String	填充模版字符串；

例子:

"你好${table1.name}"

模版字符串：,则该函数的返回值为

示例及效果：

名称	描述
示例1	GenerateTextByTemplate([Table1].[FieldName1])；[表名].[字段名]表达式的内容为模版字符串；填充数据源：当前数据源table1的当前行中name字段列的数据为"张三"；示例：GenerateTextByTemplate("你好${table1.name}")；
返回值	"你好张三"
效果

生成uuid-GenerateUUID()

生成一个uuid。

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	String	uuid字符串；

示例及效果：

名称	描述
示例	GenerateUUID()
返回值	uuid字符串；
效果

根据身份证号码获取年龄-GetAgeByIdCard()

根据身份证号码获取年龄。（服务器时间 - 身份证出生日期）

注：

1、当前日期是获取服务器的时间 2、年龄是精确到日来计算的。

参数与返回值:

名称	类型	描述
参数1	String	身份证号码；

返回值	Integer	年龄；

示例及效果：

名称	描述
示例	GetAgeByIdCard("440103201003076041")
返回值	假设系统时间为：20210910，身份证出生日期20100307。返回年龄：11
效果

根据身份证号获取生日日期-GetBirthdayByIdCard()

根据身份证号获取生日日期。

参数与返回值:

名称	类型	描述
参数1	String	身份证号；

返回值	String	生日日期；

示例及效果：

名称	描述
示例	GetBirthdayByIdCard("522635197809122343")
返回值	"1978-09-12"
效果

获取浏览器信息-GetBrowserInfo()

获取浏览器信息（名称/版本号）。

参数与返回值:

名称	类型	描述
参数1	String	浏览器信息类型；非必填，支持类型：[name，version]之一，默认缺省：name；

返回值	String	浏览器信息；

示例及效果：

名称	描述
示例1	GetBrowserInfo("name") ；返回值为：浏览器名称(类型)，例如ie/chrome等。
示例2	GetBrowserInfo("version") ；返回值为：浏览器版本号。
效果

获取图表点击时的数据-GetChartClickData()

获取图表点击时的数据。

参数与返回值:

名称	类型	描述
参数1	String	图表控件编码，必填；
参数2	String	参数编码，必填；
注意		参数2中可以使用到的参数编码： seriesName ：图例值 value：纵坐标值 name: 横坐标值 data: 纵坐标绑定的对象值(如果是单值对象，则和value一样) color:条码颜色

返回值	String	图表点击时的数据；

示例及效果：

名称	描述
示例	GetChartClickData("图表控件编码","参数编码") 例如：GetChartClickData("JGChart2","value")
返回值	55
效果

获取当前构件编码-GetComponentCode()

获取当前构件编码。

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	String	当前构件编码；

示例及效果：

名称	描述
示例	GetComponentCode()；返回值为：当前构件编码。
效果

获取当前应用上下文-GetContextPath()

获取当前应用上下文。

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	String	当前应用上下文；

示例及效果：

名称	描述
示例	GetContextPath()；返回值为：当前应用上下文的值。
效果

获取控件属性值-GetControlProperty()

根据控件编码及属性编码获取控件属性值。

参数与返回值:

名称	类型	描述
参数1	String	控件编码，必填；
参数2	String	属性编码，必填；例如：Visible、ReadOnly、Enable、Label、Value等；

返回值	Indefinite	不定类型（根据属性类型确定）

示例及效果：

名称	描述
示例	GetControlProperty("ControlCode","ControlPropertyCode")；返回值为：指定控件指定属性的值。
效果

获取cookie值-GetCookie()

按cookie名称，从客户端获取cookie值。

参数与返回值:

名称	类型	描述
参数1	String	cookie名称，必填；
参数2	String	默认值，取cookie值为空时返回默认值；

返回值	String	cookie值；（为空时返回默认值）

示例及效果：

名称	描述
示例	GetCookie("cookieName","default")；返回值为：Cookie的值。
效果

获取日历控件当前月份-GetCurrentCalendarMonth()

获取日历控件当前月份。

参数与返回值:

名称	类型	描述
参数1	String	日历控件ID；

返回值	String	日历控件当前月份；

示例及效果：

名称	描述
示例	GetCurrentCalendarMonth("JGCalendar1")
返回值	"202108"
效果

获取当前行索引-GetCurrentRecordIndex()

根据实体名称获取当前行，并返回索引值（目前为id字段值）。

参数与返回值:

名称	类型	描述
参数1	String	实体名称；

返回值	String	当前行id字段值；

示例及效果：

名称	描述
示例	GetCurrentRecordIndex("EntityName") ；返回值为：实体EntityName当前行id字段的值。
效果

获取当前窗体实例的code-GetCurrentWindowInstanceCode()

获取当前窗体实例的code。

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	String	当前窗体实例的code；

示例及效果：

名称	描述
示例	GetCurrentWindowInstanceCode()；返回值为：一个窗体实例code的字符串。
效果

获取服务连接的数据库类型-GetDataBaseType()

获取服务连接的数据库类型。

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	String	服务连接的数据库类型；数据库类型枚举：Mssql2000、Mssql、DB2、Oracle、Mysql、H2、Unknow，其中SqlServer 2000以上版本都返回Mssql，若读取不到数据库类型，则返回Unknow。

示例及效果：

名称	描述
示例	GetDataBaseType() 返回执行系统服务连接的数据库类型；
效果

获取动态列列标识信息-GetDynamicColumnIdentity()

获取动态列列标识信息，在列表或树表动态列链接事件中使用，标识字段与加载动态交叉表到实体规则中列标识字段对应。

参数与返回值:

名称	类型	描述
参数1	String	控件编码；
参数2	String	标识字段编码；

返回值	Indefinite	动态列列标识信息；不定类型，与参数二所选字段的类型一致；

示例及效果：

名称	描述
示例	GetDynamicColumnIdentity("JGTreeGrid1","fieldCode1") 返回值为：指定列的标识信息；
效果

获取实体记录字段值-GetEntityCurrentColumnValue()

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

参数与返回值:

名称	类型	描述
参数1	String	实体名；界面实体为字符串类型，其他变量实体需要加上变量的前缀。
参数2	String	字段名；

返回值	Indefinite	当前记录对应字段名的值；不定类型，与参数二所选字段的类型一致。

示例及效果：

名称	描述
示例	界面实体：GetEntityCurrentColumnValue("EntityName","ColumnName")；活动集实体：GetEntityCurrentColumnValue(BR_IN_PARENT.EntityName,"ColumnName")；返回值为：当前行该字段值。
效果

根据条件从实体获取记录数-GetEntityRowCount()

从指定的实体获取记录数。
参数与返回值:
名称 类型 描述
参数1 String 实体名称。界面实体为字符串类型，其他变量实体需要加上变量的前缀；
参数2 String 是一个字符串，其运算结果应该是布尔值。如果该参数省略，则返回实体总记录数；
返回值 Integer 实体记录数；
 [!Tip]
注意：
1、若参数2中的条件值来源变量，则参数2需要用一个变量代替，如:
GetEntityRowCount("BR_IN_PARENT.TableName",BR_VAR_PARENT.cs2)
其中BR_VAR_PARENT.cs2的值等于：
ConcatStr("[TableName].[FieldValue]==",BR_VAR_PARENT.cs2_z)
2、若BR_VAR_PARENT.cs2_z为字符串，拼接参数2时，还需要加上双引号（将双引号存储到变量中，再拼接），如：
ConcatStr("[TableName].[FieldValue]==",BR_VAR_PARENT.syh,BR_VAR_PARENT.cs2_z,BR_VAR_PARENT.syh)
其中BR_VAR_PARENT.syh中存储的是英文双引号常量:
'"'
示例及效果：
名称 描述
示例 
界面实体：GetEntityRowCount("TableName","[TableName].[FieldValue]==1")；
活动集实体：GetEntityRowCount("BR_IN_PARENT.TableName","[TableName].[FieldValue]==1")；
返回值为：符合条件的实体记录数。
效果

获取界面实体选中行数-GetEntitySelectedRowCount()

获取界面实体选中行数。

参数与返回值:

名称	类型	描述
参数1	String	实体编码；

返回值	Integer	界面实体选中行数；

示例及效果：

名称	描述
示例	GetEntitySelectedRowCount("EntityName")；
效果

获取文件信息-GetFileInfo()

根据文件id与文件信息类型获取文件信息。

参数与返回值:

名称	类型	描述
参数1	String	文件标识；
参数2	String	文件信息类型；其中： fileName为文件名， fileSize为文件大小（单位KB）， fileType为文件类型扩展名， md5为文件md5码；

返回值	String	文件信息(文件名/文件大小/文件类型扩展名/文件md5码)；

示例及效果：

名称	描述
示例	GetFileInfo("8a819ab551c2421c0151c3b597b80ddf","fileName")；
效果

获取实体变量首行记录字段值-GetFirstRowColumnValue()

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

参数与返回值:

名称	类型	描述
参数1	String	实体名称。界面实体为字符串类型，其他变量实体需要加上变量的前缀；
参数2	String	字段名

返回值	Indefinite	实体变量首行记录字段值；不定类型，与参数二所选字段的类型一致。

示例及效果：

名称	描述
示例	界面实体：GetFirstRowColumnValue("entity","id"); 返回值为：该实体变量首行记录的id字段值。活动集实体：GetFirstRowColumnValue("BR_VAR_PARENT.interView","id")
效果

获取表格控件(列表+树表)编码-GetGridComp()

根据实体名获取表格控件(列表+树表)编码。

参数与返回值:

名称	类型	描述
参数1	String	实体名，必填；
参数2	Integer	下标，选填(不填的话默认为0)；

返回值	String	表格控件(列表+树表)编码；

示例及效果：

名称	描述
示例	GetGridComp("ENT_GetGridComp",0)
返回值	`"Trg_4"`
效果

获取当前域名-GetHost()

获取当前域名。

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	String	当前域名；

示例及效果：

名称	描述
示例	GetHost() ；返回值为："www.baidu.com"。
效果

根据图片的文件id获取图片的URL路径-GetImageUrlByFileId()

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

参数与返回值:

名称	类型	描述
参数1	String	图片的文件id；

返回值	String	图片的URL路径；

示例及效果：

名称	描述
示例	GetImageUrlByFileId("8a819ab551c2421c0151c3b597b80ddf")；返回值为：图片的URL路径。详见下图：
效果

获取客户端请求的IP地址-GetIPAddress()

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

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	String	服务器端获取到的请求IP地址；

示例及效果：

名称	描述
示例	代码示例:GetIPAddress()；返回值为：当前客户端的IP字符串；
效果

从本地储存中获取数据-GetLocalStorage()

从本地储存中获取数据。

参数与返回值:

名称	类型	描述
参数1	String	数据名称；
参数2	String	取数据为空使用默认值；

返回值	String	(浏览器)本地储存的内容；

示例及效果：

名称	描述
示例	GetLocalStorage("Name","default")；返回值为：本地存储的内容。
效果

当前的在线用户数-GetloginUserNum()

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

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	Integer	实时在线用户数；

示例及效果：

名称	描述
示例	GetloginUserNum()；返回值为：当前的在线用户数(实时获取)。
效果

通过key值获取get请求的参数值-GetRequestParmByKey()

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

参数与返回值:

名称	类型	描述
参数1	String	get请求参数的key；

返回值	String	请求参数的值；

示例及效果：

名称	描述
示例	GetRequestParmByKey("componentCode")；返回值为：get请求参数中key为componentCode的值（解码后）。
效果

根据id获取实体对应记录的行号-GetRowNum()

根据id获取实体对应记录的行号。

参数与返回值:

名称	类型	描述
参数1	String	实体编码；
参数2	String	id值；

返回值	Integer	指定id对应记录所在的行号（从1开始），记录不存在则返回-1。

示例及效果：

名称	描述
示例	GetRowNum("entityCode",[entityCode].[id])
效果

获取日历控件选中日期并新增到前台实体-GetSelectedDateToEntity()

获取日历控件选中日期并新增到前台实体。

参数与返回值:

名称	类型	描述
参数1	String	控件编码；
参数2	String	实体编码；
参数3	String	实体字段编码；

返回值		无返回值；

示例及效果：

名称	描述
示例	GetSelectedDateToEntity("JGCalendar1", "Entity1", "date")
效果

流水号函数-GetSerialNumber()

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

参数与返回值:

名称	类型	描述
参数1	String	表名；
参数2	String	字段名；
参数3	String	前缀字符串(只用于查询流水号时使用，不包含在返回结果中)；
参数4	Integer	流水号长度；
参数5	String	补位符(长度必须为1)；

返回值	String	流水号后缀(最大流水号后缀加1);

示例及效果：

名称	描述
示例	GetSerialNumber("TableName","ColumnName","20210721--",3,"0")
返回值	"014"
效果

获取系统时间戳-GetSystemCurrentTimeMillis()

获取系统时间戳。

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	String	系统时间戳；

示例及效果：

名称	描述
示例	GetSystemCurrentTimeMillis()；返回值为：当前时间戳。
效果

过滤表中数据-GetTableData()

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

参数与返回值:

名称	类型	描述
参数1	String	表字段名称；
参数2	String	表名称；
参数3	String	过滤条件；

返回值	String

[!Tip]
注意：
1、若参数3中的条件值来源变量，则参数3需要用一个变量代替，如：
GetTableData("ColumnName","Table1,BR_VAR_PARENT.cs2)；
其中BR_VAR_PARENT.cs2的值等于：
ConcatStr("ID==",BR_VAR_PARENT.cs2_z)；
2、若BR_VAR_PARENT.cs2_z为字符串，拼接参数3时，还需要加上单引号，如：
ConcatStr("ID==","'",BR_VAR_PARENT.cs2_z,"'")

示例及效果：

名称	描述
示例	GetTableData("ColumnName","Table1","ID='3'") ；返回值为：表Table1中ID=3的行的ColumnName列的值。
效果

获取树和树表控件特定节点及子节点的id集合-GetTreeEntityIds()

获取树和树表控件特定节点及子节点的id集合。

参数与返回值:

名称	类型	描述
参数1	String	树/树表控件编码，必填；
参数2	String	记录id，默认为当前行记录id；
参数3	String	分隔符，默认为 ","；

返回值	String	树和树表控件特定节点及子节点的id集合；

示例及效果：

名称	描述
示例	GetTreeEntityIds("JGTreeGrid1","1","-")
返回值	"1-2-4-3"
效果

获取控件运行时高度或者宽度-GetWidgetSize()

获取控件运行时高度或者宽度。注：该函数只能用于普通窗体的面板或者流布局控件。

参数与返回值:

名称	类型	描述
参数1	String	控件编码；
参数2	String	高度编码(height)、宽度编码(width)；

返回值	Number	控件运行时高度或者宽度；

示例及效果：

名称	描述
示例	GetWidgetSize("widgetCode","height")；返回值为：返回对应控件运行时高度。
效果

获取窗体编码-GetWindowCode()

获取当前窗体编码。

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	String	当前窗体编码；

示例及效果：

名称	描述
示例	GetWindowCode()；返回值为：当前窗体编码。
效果

检查指定的表是否有数据-HasRecord()

计算数据库表中数据量。

参数与返回值:

名称	类型	描述
参数1	String	数据库表名；

返回值	Integer	数据库表中数据量；

示例及效果：

名称	描述
示例	HasRecord("TableName")
返回值	3
效果

判断传入的窗体实例是否存在-IsExistWindowInstanceCode()

判断传入的窗体实例是否存在，若存在则返回True。

参数与返回值:

名称	类型	描述
参数1	String	窗体实例；

返回值	Boolean	窗体实例存在状态；

示例及效果：

名称	描述
示例	IsExistWindowInstanceCode("8a819a6c57df913f0157df950f43072c_bg")；
效果

判断节点是否为叶子节点-IsLeaf()

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

是叶子则返回True。

参数与返回值:

名称	类型	描述
参数1	String	实体名称；
参数2	String	记录ID值；
参数3	String	树结构配置项；各配置项之间以逗号隔开，配置项以"名称：值"的形式表示；树结构配置项说明： type：树类型，目前仅支持1，表示层级树； pidField：父记录字段； treeCodeField：层级码字段； orderField：排序字段； isLeafField：叶子节点字段； busiFilterField：树过滤字段，可选项；异常情况：实体不存在、实体没有记录、指定ID的记录；

返回值	Boolean	是否存在叶子节点；是叶子则返回True,否则返回False。

示例及效果：

名称	描述
示例	IsLeaf("treeEntity", "65276f13a55db023f94a9abb9f1c8fb0", "type:1,pidField:PID,treeCodeField:InnerCode,orderField:orderNo,isLeafField:isLeaf")；
效果

判断登录状态-IsLogin()

判断当前用户是否已登录。

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	Boolean	用户登录状态；

示例及效果：

名称	描述
示例	IsLogin() ；返回值为：登录返回true，未登录返回false。
效果

空值处理-IsNull()

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

参数与返回值:

名称	类型	描述
参数1	Indefinite	被检查的值；不定类型
参数2	String	为空时的缺省值；

返回值	Indefinite	返回参数的数据类型；

示例及效果：

名称	描述
示例	IsNull(arg,defaultVal)；第一个参数不为空直接返回第一个参数,为空时返回默认值。
效果

空值空字符串处理-IsNullOrEmpty()

被检查的值 arg是否为空（null值）或长度为0的字符串,如果是则返回缺省值 defaultVal，否则返回被检查的值。

参数与返回值:

名称	类型	描述
参数1	String	被检查的值；
参数2	Indefinite	缺省值；不定类型

返回值	Indefinite	被检查的值的状态；为空或0长度字符串则返回缺省值，否则返回被检查的值。

示例及效果：

名称	描述
示例	IsNullOrEmpty(arg,defaultVal)；第一个参数不为空或0长度字符串直接返回第一个参数,为空或0长度字符串时返回默认值。
效果

判断记录是否选中-IsSelectedRecord()

判断符合条件的实体字段的字段值是否选中，选中返回True。

参数与返回值:

名称	类型	描述
参数1	String	实体编码；
参数2	String	字段编码；
参数3	String	字段值；

返回值	Boolean	字段值选中状态；

示例及效果：

名称	描述
示例	IsSelectedRecord("book","name","计算机")；返回值为：True。
效果

将实体某个字段拼接成一个字符串返回-ListToString()

将实体某个字段拼接成一个字符串返回。

参数与返回值:

名称	类型	描述
参数1	String	实体名称。界面实体为字符串类型，其他变量实体需要加上变量的前缀；
参数2	String	字段名称；
参数3	String	拼接时的分隔符。可以省略,省略时默认使用分号作为分隔符；
参数4	Integer	记录筛选条件。0：全部记录；1：选中记录；默认为0；
参数5	Boolean	函数增加是否过滤空值的选项。默认true处理，如果参数=false，则不去掉空值记录；
参数6	Boolean	是否去重复。默认为false，如果参数=true，则去除重复记录；

返回值	String	实体字段拼接的字符串；

示例及效果：

名称	描述
示例	ListToString("EntityName","ColumnName",";",0,true,false)；返回值为：拼接后的字符串。界面实体：ListToString("EntityName","ColumnName",";",0,true,false)；返回值为：拼接后的字符串。其他变量实体：ListToString("BR_VAR_PARENT.entity","ColumnName",";",0,true,false)。
效果

返回实体字段最大值-MaxColumn()

查询指定实体的字段的最大值并返回。
参数与返回值:
名称 类型 描述
参数1 String 实体编码(字符串类型),实体可以是：
界面实体(EntityCode)、
方法输入(BR_IN_PARENT.entityCode)、
方法输出(BR_OUT_PARENT.entityCode)、
方法变量(BR_VAR_PARENT.entityCode)、
窗体输入实体(@entityCode)；
参数2 String 字段编码；
返回值 Number 实体的字段的最大值；
示例及效果：
名称 描述
示例 MaxColumn("EntityCode","ColumnCode")； 
返回值为：界面实体[EntityCode]的"ColumnCode"字段的最大值。
效果

MD5加密-MD5Encrypt()

对字符串进行加密，加密算法为MD5+BASE64算法。

参数与返回值:

名称	类型	描述
参数1	String	需要加密的字符串；

返回值	String	加密后的字符串；

示例及效果：

名称	描述
示例	MD5Encrypt("Example")；返回值加密后的字符串。
效果

utf-8字符集的MD5加密-MD5EncryptByUTF8()

utf-8字符集的MD5加密。

参数与返回值:

名称	类型	描述
参数1	String	需要加密的字符串；

返回值	String	加密后的字符串；

示例及效果：

名称	描述
示例	MD5EncryptByUTF8("同望")；返回值为：wd7VFY1HGgjdEK2kbS7L+w==。
效果

获取实体的某个字段的最小值-MinColumn()

查询指定实体的字段的最小值并返回。
参数与返回值:
名称 类型 描述
参数1 String 实体编码(字符串类型),实体可以是：
界面实体(EntityCode)、
方法输入(BR_IN_PARENT.entityCode)、
方法输出(BR_OUT_PARENT.entityCode)、
方法变量(BR_VAR_PARENT.entityCode)、
窗体输入实体(@entityCode)；
参数2 String 字段编码；
返回值 Number 
示例及效果：
名称 描述
示例 MinColumn("EntityCode","ColumnName")；
返回:界面实体[EntityCode]的"ColumnCode"字段的最小值。
效果

产生空值-Null()

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

参数与返回值:

名称	类型	描述
参数		无参数；

返回值	Null	Null值；

示例及效果：

名称	描述
示例	null()
返回值	Null
效果

编码字符串累加-NumberCodeAdd()

对数值型的字符串进行数值加减操作，并依照原格式返回字符串。

参数与返回值:

名称	类型	描述
参数1	String	能转换成数值的编码字符串(仅支持正整数的字符串)；
参数2	Integer	累加的数值(整型)；

返回值	String	运算结果；返回值长度由参数1决定，补前导零，相加值小于零，结果将为零。

示例及效果：

名称	描述
示例	NumberCodeAdd("0010203",-3)
返回值	"0010200"
效果

数字转化为中文-NumiceToChinese()

将数字转化为中文。

参数与返回值:

名称	类型	描述
参数1	String	转换字符串(必填)；
参数2	String	数字0的转换值(可选填，不填默认为零)；参数2：可以填入数字0需要转换的形式，主要是'〇'或者‘零’两种，不填默认为'零'；
参数3	String	转化的格式(可选填，转化的格式（包含1-9的转换字符,用","分隔）如壹,贰,叁,肆,伍,陆,柒,捌,玖)；参数3：可以填入数字1-9的转换字符（用','分隔，且按照1-9的顺序9个）；如：壹,贰,叁,肆,伍,陆,柒,捌,玖一,二,三,四,五,六,七,八,九
注意

返回值	String

示例及效果：

名称	描述
示例	NumiceToChinese("这是第0123号文件","〇","壹,贰,叁,肆,伍,陆,柒,捌,玖")；返回值为：这是第〇壹贰叁号文件。
效果

在浏览器控制台输出文字内容-PrintToBrowserConsole()

在浏览器控制台输出文字内容，支持类型：log,debug,info,warn,error,clear等。
参数与返回值:
名称 类型 描述
参数1 String 输出文字内容(必填)；
参数2 String 内容类型(非必填，缺省值log)；
返回值 无返回值；
示例及效果：
名称 描述
示例 PrintToBrowserConsole("在控制台打印log信息","log");
PrintToBrowserConsole("在控制台打印info信息","info");
PrintToBrowserConsole("在控制台打印debug信息","debug");
PrintToBrowserConsole("在控制台打印warn信息","warn");
PrintToBrowserConsole("在控制台打印error信息","error");
PrintToBrowserConsole("清空控制台","clear")。
效果

作废流水号-RecyclingSequenceNumber()

作废流水号。

参数与返回值:

名称	类型	描述
参数1	String	流水号种子。最长128位字符串，建议64位或者更短；
参数2	Integer	需要废弃的流水号；

返回值		无返回值；

示例及效果：

名称	描述
示例	RecyclingSequenceNumber("123456", 89)
效果

滚动页面到指定控件所在位置-ScrollToPosition()

滚动页面到指定控件所在位置。（HTML锚功能）

参数与返回值:

名称	类型	描述
参数1	String	控件编码，必填；

返回值		无返回值；

示例及效果：

名称	描述
示例	ScrollToPosition("JGDataGrid1")；
效果

获取实体中的日期并选中日历控件中的对应日期-SelectedDateFromEntity()

获取实体中的日期并选中日历控件中的对应日期。

参数与返回值:

名称	类型	描述
参数1	String	控件编码；
参数2	String	实体编码；
参数3	String	实体字段编码；

返回值		无返回值；

示例及效果：

名称	描述
示例	SelectedDateFromEntity("JGCalendar1", "Entity1", "date")
效果

全选或取消全选界面实体记录-SelectOrQuitAllRecords()

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

参数与返回值:

名称	类型	描述
参数1	String	实体名称；
参数2	String	全选类型；select代表全选，quit代表取消全选；

返回值		无返回值；

示例及效果：

名称	描述
示例	SelectOrQuitAllRecords("TableName","select") 全选实体记录； SelectOrQuitAllRecords("TableName","quit") 取消全选实体记录；
效果

修改控件属性-SetControlProperty()

滚动页面到指定控件所在位置。

参数与返回值:

名称	类型	描述
参数1	String	控件编码，多个控件编码逗号间隔，必填；
参数2	String	属性名，必填；
参数3	Indefinite	属性值，必填；

返回值		无返回值；

示例及效果：

名称	描述
示例	SetControlProperty("TGTextBox1","Visible",true)；
效果

设置cookie-SetCookie()

设置cookie的值。

参数与返回值:

名称	类型	描述
参数1	String	cookie名称（必填)；
参数2	String	cookie值（必填)；
参数3	String	cookie有效期（非必填，合法的日期，缺省值：2500-01-01 00:00:00)；
参数4	String	cookie服务器路径（非必填，缺省值：`/`)；
参数5	String	cookie域名（非必填，缺省值：当前域名)；
参数6	Boolean	是否通过安全的HTTPS（非必填，False表示HTTP，True表示HTTPS，缺省值：False)；
参数7	Boolean	是否可以通过客户端脚本访问（非必填，缺省值：True)；

返回值	Boolean	操作状态（是否成功）

示例及效果：

名称	描述
示例	SetCookie("CookieName","Value","2017-01-01 00:00:00","/","baidu.com",False,True)；操作成功返回True。
效果

设置当前窗体标题-SetCurrentWindowTitle()

设置当前窗体标题。

参数与返回值:

名称	类型	描述
参数1	String	窗体标题；

返回值		无返回值；

示例及效果：

名称	描述
示例	SetCurrentWindowTitle("编辑") ；以浏览器窗口打开，则更改浏览器窗口标题；以模态窗体打开，则更改模态窗体标题。
效果

设置表格列是否只读-SetGridColReadOnly()

设置表格列是否只读。

参数与返回值:

名称	类型	描述
参数1	String	表格控件编码，必填；
参数2	String	需要修改的实体字段名，必填(多个字段用英文逗号分隔)；
参数3	Boolean	是否只读，必填；

返回值		无返回值；

示例及效果：

名称	描述
示例	SetGridColReadOnly("JGDataGrid1","name,code",true)；返回值为：无。
效果

设置表格列标题-SetGridColTitle()

设置表格列标题。

参数与返回值:

名称	类型	描述
参数1	String	表格控件编码，必填；
参数2	String	需要修改的实体字段名，必填(多个字段用英文逗号分隔)；
参数3	String	修改的标题，必填(个数要与参数2对应)；

返回值		无返回值；

示例及效果：

名称	描述
示例	SetGridColTitle("JGDataGrid1","name,code","名称,编码")；返回值为：无。
效果

设置表格列显示/隐藏-SetGridColVisble()

设置表格列显示/隐藏。

参数与返回值:

名称	类型	描述
参数1	String	表格控件编码，必填；
参数2	String	需要修改的实体字段名，必填（多个字段用英文逗号分隔）；
参数3	Boolean	是否显示，必填（个数要与参数2对应）；

返回值	无返回值

示例及效果：

名称	描述
示例	SetGridColVisble("JGDataGrid1","name,code",true)；返回值为：无。
效果

本地储存数据-SetLocalStorage()

向本地存储数据。

1、localStorage允许在浏览器中存储key/value对的数据。

2、localStorage 用于长久保存整个网站的数据，保存的数据没有过期时间，直到手动去删除。

3、localStorage 属性是只读的。

4、localStorage 拓展了 cookie 的 4K 限制。

参数与返回值:

名称	类型	描述
参数1	String	数据名称；
参数2	String	数据的值；

返回值	Boolean	操作状态；（是否成功存储）

示例及效果：

名称	描述
示例	SetLocalStorage("Name","Value") ；操作成功返回True。
效果

批量设置记录字段值-SetRecordValue()

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

参数与返回值:

名称	类型	描述
参数1	String	实体名称；
参数2	String	记录索引值；
参数3	Array	字段编码集合（与函数ArgsToArray搭配使用）；
参数4	Array	字段值集合，与字段编码集合一一对应(与函数ArgsToArray搭配使用);

返回值		无返回值;

示例及效果：

名称	描述
示例	SetRecordValue("EntityName","index",fields,values)；
效果

为字段设置实体记录的行号-SetRowNum()

为字段设置实体记录的行号。

参数与返回值:

名称	类型	描述
参数1	String	实体编码；
参数2	String	字段编码；

返回值		无返回值;

示例及效果：

名称	描述
示例	SetRowNum("entity1","rowNum") 为实体字段依次设置实体记录的行号(从1开始)。
效果

设置工具栏显示信息-SetToolBarText()

设置工具栏显示信息，目前仅支持设置到列表、树表、树的工具栏。

参数与返回值:

名称	类型	描述
参数1	String	控件编码；
参数2	String	实体编码
参数3	String	标题字段编码，可选，默认为title；
参数4	String	值字段编码，可选，默认为value；

返回值		无返回值；

示例及效果：

名称	描述
示例	SetToolBarText("widgetCode","entityCode","title","value")；
效果

设置打开窗体的显示方式-SetWindowState()

设置当前窗体的显示方式（仅以模态方式打开窗体时有效）。

参数与返回值:

名称	类型	描述
参数1	String	窗体状态（Maximized表示最大化，Normal表示还原大小）；

返回值		无返回值；

示例及效果：

名称	描述
示例	SetWindowState("Maximized")，最大化窗体； SetWindowState("Normal")，还原窗体大小；
效果

标准MD5加密-StandardMD5Encrypt()

对字符串进行标准MD5加密。

参数与返回值:

名称	类型	描述
参数1	String	需要加密的字符串(必填)；
参数2	String	加密的位数(选填，有16位和32位两种类型，默认为32)；
参数3	String	输出的大小写(选填，有"big"和"small"两种类型，默认为big)；

返回值	String	加密后的字符串；

示例及效果：

名称	描述
示例	StandardMD5Encrypt("123456","16","big")
返回值	"49BA59ABBE56E057"
效果

计算实体字段的总和-TotalColumn()

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

参数与返回值:

名称	类型	描述
参数1	String	实体名；界面实体为字符串类型，其他变量实体需要加上变量的前缀；
参数2	String	字段名；

返回值	Indefinite	总和;不定类型，与参数二所选字段的类型一致；

示例及效果：

名称	描述
示例	界面实体：TotalColumn("EntityName","ColumnName")；活动集实体：TotalColumn(BR_VAR_PARENT.EntityName,"ColumnName")；返回值为：实体的ColumnName字段的汇总值。
效果

返回选中树节点的路径-TreeNodePath()

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

参数与返回值:

名称	类型	描述
参数1	String	树型实体名；
参数2	String	字段名；
参数3	String	间隔；
参数4	String	树结构配置项；

返回值	String	树选中节点的路径；

示例及效果：

名称	描述
示例	TreeNodePath("Table1","Table1.Column1","\","type:1,pidField:PID,treeCodeField:InnerCode,orderField:orderNo,isLeafField:isLeaf")；返回值为：根节点Column1字段的值\第一级节点Column1字段的值\第二级节点Column1字段的值\…\选中节点Column1字段的值。
效果

三元运算函数-V3If()

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

参数与返回值:

名称	类型	描述
参数1	Boolean	条件表达式；
参数2	Indefinite	条件表达式为true时返回值；
参数3	Indefinite	条件表达式为false时返回值；

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

示例及效果：

名称	描述
示例	V3If(1==1,20,30)
返回值	20
效果

字符串反序列化成实体-VarToEntity()

将一个或者多个实体的json字符串反序列化成一个或者多个实体。

参数与返回值:

名称	类型	描述
参数1	String	json字符串；

返回值	Entity	一个或者多个实体；

示例及效果：

名称	描述
示例	VarToEntity(str)；将str字符串反序列化成实体；
效果

将变量实体转换为二维数组json-VConvertEntityToJson()

前台实体转换为二维数组json函数。

参数与返回值:

名称	类型	描述
参数1	String	要转换json的实体名称；
参数2	Integer	获取记录的方式，0代表全部，1代表选中行，默认为0；
参数3	String	实体中某些字段是json串需要特殊处理的，逗号隔开（可选）。注：第三个参数不要理解成需要转成json的字段。

返回值	String	()json字符串；

示例及效果：

名称	描述
示例	VConvertEntityToJson("实体名称",0,"fieldMapping1,fieldMapping2") ；返回值为：二维数组形式的json。
效果

将变量实体转换为XML字符串-VConvertEntityToXML()

前台实体转换为XML。

参数与返回值:

名称	类型	描述
参数1	String	前台实体名称，可动态添加；

返回值	String	XML字符串；

示例及效果：

名称	描述
示例	VConvertEntityToXML("实体1","实体2") ；返回值为：拼装后的XML内容。
效果

将实体数据转换成key-value形式的json函数-VConvertKeyValueEntityToJson()

将实体数据转换成key-value形式的json的函数。

参数与返回值:

名称	类型	描述
参数1	String	实体名称；
参数2	String	作为key的字段名；
参数3	String	作为value的字段名；
参数4	String	获取记录的方式0所有行/1选中行，默认为0；
参数5	Integer	需要使用对象方式的key列表，逗号分隔（可选）；

返回值	String	json字符串；

示例及效果：

名称	描述
示例	代码示例: VConvertKeyValueEntityToJson("实体1","code","value",0,"code1,code2") ；返回值为：拼装后key-value形式的json。
效果

二维数组json还原为实体-VRestoreJsonToEntity()

二维数组json还原为前台实体的函数。

参数与返回值:

名称	类型	描述
参数1	String	由VConvertEntityToJson函数生成的二维数组json信息；
参数2	String	还原数据的目标实体名称；

返回值	Entity	前台实体；

示例及效果：

名称	描述
示例	VConvertEntityToJson("实体名称",0,"fieldMapping1,fieldMapping2") ；返回值为：二维数组形式的json。
效果

将XML数据还原为实体数据-VRestoreXMLToEntity()

XML数据还原为前台实体数据函数。

参数与返回值:

名称	类型	描述
参数1	String	由VConvertEntityToXML函数生成的XML信息；

返回值	Entity	前台实体；

示例及效果：

名称	描述
示例	VRestoreXMLToEntity("xml内容")；返回值为：实体原来的数据。
效果

名称	描述
示例	界面实体：GetEntityRowCount("TableName","[TableName].[FieldValue]==1")；活动集实体：GetEntityRowCount("BR_IN_PARENT.TableName","[TableName].[FieldValue]==1")；返回值为：符合条件的实体记录数。
效果

名称	类型	描述
参数1	String	实体编码(字符串类型),实体可以是：界面实体(EntityCode)、方法输入(BR_IN_PARENT.entityCode)、方法输出(BR_OUT_PARENT.entityCode)、方法变量(BR_VAR_PARENT.entityCode)、窗体输入实体(@entityCode)；
参数2	String	字段编码；

返回值	Number	实体的字段的最大值；

名称	描述
示例	MaxColumn("EntityCode","ColumnCode")；返回值为：界面实体[EntityCode]的"ColumnCode"字段的最大值。
效果

名称	描述
示例	MinColumn("EntityCode","ColumnName")；返回:界面实体[EntityCode]的"ColumnCode"字段的最小值。
效果

名称	类型	描述
参数1	String	输出文字内容(必填)；
参数2	String	内容类型(非必填，缺省值log)；

返回值		无返回值；

名称	描述
示例	PrintToBrowserConsole("在控制台打印log信息","log"); PrintToBrowserConsole("在控制台打印info信息","info"); PrintToBrowserConsole("在控制台打印debug信息","debug"); PrintToBrowserConsole("在控制台打印warn信息","warn"); PrintToBrowserConsole("在控制台打印error信息","error"); PrintToBrowserConsole("清空控制台","clear")。
效果