取数函数

1.取查询结果

1.1基础使用说明：

query查询id，数字，属于必填参数，在视图里环境下为0或无此属性时，默认取当前查询。

countRow显示统计行数模式，布尔，可选参数，默认false；为true时后续参数皆不需要。

colName取数列名，字符串，必填参数。

rowNumber取数行号，可选参数。

该参数为数字时：取指定行的值(从0开始)；

该参数不存在时：返回指定列全部行值数组[]；后续参数皆不需要。

该参数为字符串时：支持如"0-5"形式返回指定列从起始至结束行的单元值数组[]；后续参数皆不需要。

该参数为字符串时：支持如"0,3,5,7-9"形式返回指定列表达式特定行的单元值数组[]；后续参数皆不需要。

stringDecimal小数点后位数，数字；可选参数，默认0不显示小数点和小数位。

stringDecChar小数点符号，字符；可选参数，默认为"."。

stringThouSep千分位符号，字符；可选参数，默认为空，不显示千分位。

使用示例：

{{"query":273,"colName":"amount","rowNumber":0,stringDecimal:2,stringDecchar:".",stringThouSep:","}}

1.2带参数取值

取数函数支持参数查询：指定query属性后，若指定查询带参数，通过parameters属性设定参数，parameters类型为json对象，{"参数名":"参数值形式"}，参数值若为多选可以是数组，若为日期范围可以是json对象。参数值若要取url参数，则parameter::url参数名的形式取url参数值。参数值若要取当前用户信息作为参数，查询中参数名必须为currentUser_xxx（id，name，email，mobile），现在支持用户的id，name，email，mobile字段。

常规参数

{{"query":264,"colName":"name","parameters":{"id":3},"rowNumber":0}}

枚举，选择，结果集多选参数，单选与常规参数一致。

{{"query":272,"colName":"name","parameters":{"filed1":["id","name"],"filed2":["url","country"]},"rowNumber":0}}

时间范围参数（注意结果集内不要出现连续的两个"}}",中间可以用空格隔开。以免解析出错）

{{"query":267,"colName":"name","parameters":{"ctime": {"start": "2020-01-01", "end": "2020-09-30"} },"rowNumber":0}}

url参数

{{"query":272,"colName":"name","parameters":{"filed1":"parameter::filed1","filed2":"parameter::filed2"},"rowNumber":0}}

实时用户参数，可以以当前用户的用户信息作为查询中的变量，现在支持用户的id，name，email，mobile字段。使用时要求查询中参数名必须为currentUser_xxx（id，name，email，mobile）。

{{"query":273,"colName":"fee","parameters":{"currentUser_name":"currentUser::name"},"rowNumber":0}}

2.取url参数值

自定义函数可以用来取url参数值，使用方法可以取出url中参数名的值。比如说我们取下面这个url中的参数
http://demo.redash.cn/dashboards/173--?p\_key1=value1&p\_w123\_key2=value2

{{"parameter": "key1"}} #会返回value1

{{"parameter": "w123_key2"}} #会返回value2

3.取cookie样式值

自定义函数可以用来取cookie样式值，该用法主要用于markdown里取样式设置，仅再Portal环境下有效，cookie参数名包括：

colorstyle_mode：颜色模式值，“light”:亮白；“dark”:暗黑；“deep”:深蓝；“custom”:-自定义；“”:非portal模式；

colorstyle_bg：画布背景颜色值；

colorstyle_back：视图背景颜色值；

colorstyle_color：视图前景颜色值；

colorstyle_titleback: 部件标题背景

colorstyle_titlecolor: 部件标题前景

colorstyle_dialogback: 弹窗背景

例如:<table style="background-color: {{"cookie": "colorstyle_back"}}">取背景色。

4.取session数值

可以取出currentUser_***(id/name/email/mobile)当前用户信息和scaleX/scaleY/scaleMin/scaleMax当前缩放比例；

scaleX: x轴相对与设计比例缩放值

scaleY: y轴相对与设计比例缩放值

scaleMin: x,y轴缩放比,相对小的那个

scaleMax: x,y轴缩放比,相对大的那个

currentUser::***(id/name/email/mobile)

{{"session":"scaleX"}} //获取x轴相对与设计比例的缩放值

{{"session":"currentUser_name"}} //获取当前用户的用户名