编辑器

<< Click to Display Table of Contents >>

当前位置:  可视化数据计算和交互分析 > 数据处理与分析 > 交互分析 > 传参组件 

编辑器

复制链接

所有传参组件中,只有下拉参数和文本参数组件均支持编辑器设置,其他组件仅支持”必填“,在各组件中已介绍。这里详细介绍下拉参数和文本参数组件的编辑器设置。

1. 数据类型与控件类型关系

编辑器的控件类型与数据类型密切相关,详情可参考下表。

组件

数据类型

控件

文本参数、下拉参数

布尔

布尔

字符

文本框

字符串

字节

字节

整数

整数

长整数

长整数

短整数

短整数

单精度浮点数

单精度浮点数

双精度浮点数

双精度浮点数

时间

时间

日期

日期

时间戳

时间戳

高精度

高精度

2. 下拉参数组件

下拉参数组件会根据绑定的数据类型默认匹配对应控件,控件类型不可修改,其他设置正常情况下也不需要修改。如果需要对下拉参数中用户选择的值做校验,则可以设置编辑器。比如数值类型时,要求输入0-100之间。

下拉参数组件的编辑器默认置灰不可编辑。需勾选右侧的编辑才可进行规则等设置。

dropdown7_zoom72

2.1 文本类型

如果是普通维度字段,控件为本类型。可选择内置规则对选项进行校验,包括支持文本、手机号、邮编、身份证、邮件规则。也支持自定义检测模式,模式检测可输入校验的正则表达式规则。

editor01

2.2 数值类型

如果是数值类型字段,支持设置最大最小值。以整数类型为例,如下图。

editor02

2.3 日期时间类型

如果是日期时间类型字段,一般支持设置最大最小时间值。根据不同类型会有细微差别。以日期列为例,支持设置时间层级和最大最小值。

editor03

3. 文本参数

文本参数编辑器默认可编辑,用户可以根据使用场景灵活选择文本参数的数据类型,不同的数据类型对应的控件样式也有细微差异。所以文本参数编辑器使用更为普遍。

editor04_zoom80

3.1 布尔

选择布尔时,控件内仅能输入布尔值:true或false

textparam6

输入其他值时,会弹出错误提示:

textparam7

说明:

布尔控件的错误提示不支持自定义。

3.2 字节

选择字节时,控件内支持输入-128~127范围的值:

textparam8_zoom93

您可以自定义最小值和最大值,自定义的最小值要大于或等于-128,最大值要小于或等于127。

您可以自定义出错提示信息,例如“请输入-128~127范围的值”:

textparam9_zoom80

3.3 字符

选择字符时,控件为文本框,支持输入一个字符,您可以按正则表达式设置输入值的模式检测依据,例如“\d”,则只能输入数字,如下图:

textparam10_zoom92

当输入其他字符时会提示不合法:

textparam11_zoom80

3.4 日期

当选择日期时,控件为日期控件,可以选择展示的时间层级、最小值、最大值、默认值,如下图:

textparam12_zoom92

【时间层级】可选天、周、月、季度、年,选择不同层级后会有不同的日期选择面板,帮助您更快选择对应日期。

textparam_date_panel_zoom83

【最小值/最大值】设置一个日期作为可选日期范围的最小值/最大值,日期可以是固定时间、动态时间、相对时间,默认为固定时间。

固定时间:您可以在时间面板中选择一个日期,也可以在输入框中输入对应格式的日期,如时间层级为天,输入格式为yyyy-MM-dd。

动态时间:您可以在下拉选项中选择一个参数,参数包括内置的日期参数、报告参数,也可以在输入框中输入?{参数名}。

相对时间:您可以点击向上/向下图标为最大值的前N/最小值的后N递增/递减时间,也可以直接在输入框输入整数。N后面的信息显示与时间层级有关,如选择的时间层级为天,显示为最大值的前N天/最小值的后N天。

【默认值】根据不同的日期层级,可选的默认值有所不同,具体可以参考下表:

时间层级

默认值

具体值

常规

今天、昨天、前天

今年

第1天、最后一天

去年

第1天、最后一天

本季度

第1天、最后一天

上季度

第1天、最后一天

本月

第1天,第31天,最后一天

上月

第1天,第31天,最后一天

本周

星期一到星期天,第1天,最后一天

上周

星期一到星期天,第1天,最后一天

常规

上一周、本周、下一周

今年

第一周、最后一周

去年

第一周、最后一周

本季度

第一周、最后一周

上季度

第一周、最后一周

本月

第一周、最后一周

上一月

第一周、最后一周

常规

上一月、本月、下一月

今年

第一个月、最后一个月

去年

第一个月、最后一个月

本季度

第一个月、最后一个月

上季度

第一个月、最后一个月

季度

常规

上季度、本季度、下一季度

今年

第1季度、第2季度、第3季度、第4季度

去年

第1季度、第2季度、第3季度、第4季度

常规

去年、今年、明年

当前年代

第一年、最后一年

上个年代

第一年、最后一年

举例:

不同日期设置与效果,如下表所示。

时间

设置

效果

固定时间

textparam_fixed_time_setting_zoom62

当前日期为2022-07-14,所在周2022-07-10 ~ 2022-07-16,当前周的上一周2022-07-03 ~ 2022-07-09为默认选中状态,,最小值为2022-06-05 ~ 2022-06-11,最大值为2022-07-24 ~ 2022-07-30。用户可在最小值与最大值范围以内选择其它周,范围以外的周灰化不可选择。

textparam_fixed_time_result_zoom62

动态时间

textparam_dynamic_time_setting_zoom62

当前日期为2022-07-14,默认值为本月的第一天2022-07-01,最小值为报告中的下拉参数值2022-06-30,最大值为当期日期-下季度的第一天2022-10-01。最小值、最大值的日期-天随下拉参数、当前日期的变化而变化。用户可在最小值与最大值范围以内选择其它天,范围以外的天灰化不可选择。

textparam_dynamic_time_result_zoom62

相对时间

textparam_relative_time_setting_zoom62

当前日期为2022-07-14,默认值为常规-本月,最小值为内置参数?{_NOW_}-2022-七月,最大值为最小值的后2月,2022-七月和八月。

用户可在最小值与最大值范围以内选择其它月,范围以外的月灰化不可选择。

textparam_relative_time_result_zoom62

3.5 时间戳

当选择时间戳时,控件为时间戳,同样能够设置最小值、最大值、默认值,可选值参考时间层级为“天”的选项,另外增加了选择时间,如下图:

textparam18_zoom80

默认值选项同上面表格中时间层级为“天”的情况。

说明:

当数据类型为时间戳的文本参数被使用时,找用到这个参数的列,是否指定过进行时区转换,如果有任意一列要做时区转换,那么这个文本参数就按照个性化设置的时区转换。

3.6 双精度浮点数

当选择双精度浮点数时,控件为双精度浮点数,可以输入小数,最小值默认5e-324,最大值默认1.7976931348623157e+308,支持自定义最小值和最大值,但需要值处于默认范围以内:

textparam19_zoom97

3.7 单精度浮点数

当选择单精度浮点数时,控件为单精度浮点数,可以输入小数,最小值默认5e-324,最大值默认1.7976931348623157e+308,支持自定义最小值和最大值,但需要值处于默认范围以内:

textparam20_zoom100

3.8 整数

当选择整数时,控件为整数,可以输入整数,最小值默认-2147483647,最大值默认2147483647,支持自定义最小值和最大值,但需要值处于默认范围以内:

textparam21_zoom100

3.9 长整数

当选择长整数时,控件为整数,可以输入整数,最小值默认-9223372036854775808,最大值默认9223372036854775807,支持自定义最小值和最大值,但需要值处于默认范围以内:

textparam22

3.10 短整数

当选择短整数时,控件为短整数,最小值默认-32768,最大值默认32767,支持自定义最小值和最大值,但需要值处于默认范围以内:

textparam23_zoom90

3.11 字符串

当选择字符串时,控件为文本框,可以选择输入字符串规则、模式检测:

textparam24_zoom73

【规则】为输入的字符串类型,可选文本、手机号、邮编、身份证、邮件、数据集字段、一维条形码。

【模式检测】选择一种规则后,可以自定义正则表达式作为检测逻辑;

选择文本,默认无模式检测,您可以自由输入文本;

选择手机号,默认为^1\d{10}$,表示以1开头的11位数字;

textparam25_zoom123

选择邮编,默认为^[0-9]{6}$,表示只能输入0~9范围内的最多6位数字;

textparam26_zoom92

选择身份证,默认为(^\d{18}$)|(^\d{15}$)|(^\d{17}(\d|X|x)$),表示输入值为15或18位数字,最后一位校验位可能为数字或字符X;

textparam27_zoom92

选择邮件,默认为\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*,表示邮箱地址必须由大小写字母或数字或下划线开头,其后可以跟上任意的\w字符和中划线、加号、英文句号@跟上任意的\w字符和中划线、加号、英文句号 . 跟上任意的\w字符和中划线、加号、英文句号;

textparam28_zoom90

选择数据集字段,可以选择数据集,然后指定一个字段,输入的值必须为该字段下具体的值,例如选择“省份”字段,输入的值应该为“四川”、“北京”等,如下图:

textparam29_zoom80

选择一维条形码,可以手动输入、扫描录入条形码。

1d_barcode_zoom72

在PC和Wap中使用浏览器预览和查看报告时,只支持在文本框中输入条形码,不支持点击扫描图标录入条形码。

onedimensionalcode

App中打开报告时支持手动输入、扫描录入条形码。

app_1dcode_zoom60

【多行文本参数】默认为不勾选。未勾选多行文本参数项时,设置数据类型为非字符串类型时,此选项将置灰。当勾选多行文本参数后,编辑器中的数据类型项将置灰,多行文本参数只能为字符串类型。设置多行文本参数组件后,组件可输入多行文本,输入时支持自动换行和手动换行。

【支持输入多个值】只有当数据类型为字符串时才支持输入多个值,默认为不勾选。勾选后,可设置多个值之间用的分割符,可以用逗号(,)、分号(;)、换行(\n)或自定义符号。

举例:

使用文本参数组件过滤出表格中的茶、花茶的销量数据,详情请参考文本参数多个值

3.12 时间

当选择时间时,控件为时间,可以自定义最小值和最大值,输入的时间应该处于时间范围内:

textparam30_zoom80

3.13 高精度

当选择高精度时,控件为高精度,可以自定义最小值和最大值,输入的数值应该处于数值范围内。

textparam_bigdecimal_zoom86

3.14 其他设置

【自定义提示】直接可以输入提示文本,例如输入“请单击文本框输入内容”:

textparam4_zoom110

【必填】用于填报,默认为不勾选。勾选必选后,填报时输入了内容才能提交成功。