Skip to content

参数

HENGSHI SENSE 提出了参数概念,主要是为了实现应用的灵活控制。 之前需要修改多个地方才能实现的应用版本功能。通过创建参数后仅修改一处就解决了所有问题。

参数可以实现:

  • 数据集的参数化创建
  • 权限的参数化控制
  • 仪表盘/图表的参数化出图
  • 参数控制器参与仪表盘布局

参数操作

参数常见的操作有新建参数、编辑参数、删除参数和参数分组。

新建参数

按照下面指导创建一个参数。

  1. 点击应用->参数中的新建参数,弹出新建参数对话框。
  2. 填写参数名称、选择参数类型。参数类型支持文本、数字、日期、时间。
  3. 设置参数的允许值和默认值。示例中允许使用了固定列表,手动输入1-31作为值,默认值选取了数据集来电明细1中的来电开始日期(日)字段。
  4. 参数创建完成。

参数创建过程比较简单,但因为其使用灵活性,所以参数在设置和使用上比较复杂。请阅读参数了解参数详细的功能设置,并阅读参数使用场景了解参数的应用场景。

提示

  1. 参数可以在应用创作中创建,也可以在数据集市中创建。
  2. 参数作用范围是该应用或该数据包中的数据集,这些数据集在创建图表、行权限等场景下都可以使用参数。

编辑参数

点击参数列表中的三点菜单,在弹出菜单中选择编辑参数,就可以弹出编辑参数弹窗,对参数进行修改。

如果参数已经被使用,重新编辑时可能会遇到以下情况:

  • 编辑参数名称时,在表达式中使用参数的地方都会报错,提示参数 xxx 不存在。
  • 编辑参数类型时,使用参数的地方会出错。
  • 不修改参数名称和参数类型,而只是修改参数可选值,则不会报错。

删除参数

点击参数列表中的三点菜单,在弹出菜单中选择删除,可以删除参数。

参数设置

每个参数由四部分组成:参数名称、参数类型、允许值和默认值。

  • 参数名称: 即参数的名字。
  • 类型:参数类型分为文本、数字、日期、时间四种类型。
  • 允许值:参数的允许值支持任意、列表和范围三种形式。
    • 任意: 表示参数可以取该类型的任意值。如:文本参数可以取任意文本作为参数值,数字参数可以取任意数字做参数值。
    • 列表: 表示参数的允许值是列表,使用参数时需要从列表中取值。
    • 范围: 表示参数的允许值是范围,使用参数的取值需要满足范围。其中文本类型无范围取值。
  • 默认值: 参数创建后可以配置默认值。默认值设置方式与允许值和参数类型有关。

下面详细介绍各类参数的允许值和默认值的设置。

任意

当参数允许值选择任意类型时,表示参数可以取该类型的任意值。如:文本参数可以取任意文本作为参数值,数字参数可以取任意数字做参数值,日期参数可以选择任意日期作为参数值,时间参数可以选择任意时间作为默认值。

当允许值为任意时,其默认值可以设置无默认值、固定值、动态值和相对值(文本参数和数字参数无相对值)。

  • 固定值:由手动编辑具体值作为参数值,参数使用时默认值固定不变。
  • 动态值:从该应用中所有数据集中选取相应类型的字段作为默认值,当数据集字段的取值变化时,参数默认值随之发生变化。如图所示,文本参数选取该应用中来电明细1数据集中的选择服务字段作为默认值,默认值为按键1,当字段内容变化时,默认值也会变化。
  • 相对值:日期参数和时间参数的默认值可以设置相对值。相对值时随着时间而变化。如图所示,时间参数的默认值设置为相对日期前1天。当系统日期为1月2日时,参数默认值为1月1日,当系统日期为1月3日时,参数默认值为1月2日。

列表

当参数允许值选择列表类型时,表示参数使用时需要从列表中取值。参数列表包含值和显示值。展示时使用显示值,实际运算过程中使用值的内容。显示值可以选择配置,不配置时,展示的是值的内容。

列表支持固定和动态两种配置方式。

固定列表

固定列表即列表内容是固定不变的,支持手动输入和从字段中取值。

  • 手动添加: 即手动编辑列表的值和显示值。

  • 从字段中添加值:从数据集中选择相应类型的字段作为列表值,支持添加一个或多个字段。添加到列表中的值支持编辑和修改。 值添加完成后,显示值需要手动编辑。

动态列表

动态列表是从数据集中选择相应类型的字段作为列表值,仅支持添加一个字段。值添加后,可以添加显示值。 显示值是从同一数据集中的其他字段中选择一个字段,并且要求该字段与值的字段内容一一对应。

提示

动态列表中的值和显示值是数据集中的字段内容,如果该数据集设置了行权限,不同权限的用户看到的参数值不同。

列表默认值

列表默认值支持无默认值、固定选项、动态选项、动态项四种设置方式。

  • 固定选项:从列表中选择固定的选项内容作为默认值。
  • 动态选项:指定列表中的第 N 项作为默认值,列表顺序变化时默认值也随着变化。
  • 动态项:从该应用中所有数据集中选取相应类型的字段作为默认值,当数据集字段的取值变化时,参数默认值随之发生变化。如果动态项的值不在列表内时,参数创建失败,需要重新选择默认值。

参数多值

当参数允许值为列表时,参数可以开启多值功能。可以设置参数多值的分隔符、起止符、前后缀。参数多值开启后,可以设置多个默认值。

范围

当参数的允许值是范围时,表示参数的取值满足范围要求。文本参数无该类型。

数字参数范围值

数字参数的范围值可以设置最小值、最大值和步长。 步长表示两个合法值之间的差值,可以选择设置,默认值为1,不能超过最大值与最小值的差。如图所示,最小值为5,最大值为100,步长为1时,参数范围内的合法值为5、6、7、8... 100。 如果步长为95,则参数范围内的合法值仅包含5和100。

默认值设置支持无默认值、固定值和动态值三种设置方式。

  • 固定值: 输入范围内的数值作为默认值,如果输入值超出范围会自动修正到边界值。如果设置步长,输入值不在范围内,但在最小值和最大值之间时会自动修正到前一个范围值。如图所示,参数范围值为0,3,6...99,当输入为5时,会自动更正为3。

  • 动态值: 从该应用中所有数据集中选取数字类型的字段作为默认值,当数据集字段的取值变化时,参数默认值随之发生变化。如过字段值不在范围内,参数会报错。

日期参数范围值

日期参数的范围值需要设置开始日期、结束日期和步长。步长可以选择设置,单位为天、周、月、季度、年。步长设置后,会提示范围内有多少个步长。

默认值设置支持无默认值、固定日期、相对日期和动态值。

  • 固定日期:从范围中选择日期作为默认值。
  • 相对日期:默认值设置为相对于系统当前日期。
    • 未设置步长时,相对日期设置时可以调整时间单位,如图所示。如果默认值不在时间范围内会自动修正。
    • 设置步长后,相对日期设置以步长为单位,超出时间范围会自动修正。
  • 动态值:从该应用中所有数据集中选取日期类型的字段作为默认值,当数据集字段的取值变化时,参数默认值随之发生变化。如过字段值不在范围内,参数会报错。

时间参数范围值

时间参数的范围值需要设置开始时间、结束时间和步长。步长可以选择设置,单位为秒、分、时、天、周、月、季度、年。步长设置后,会提示范围内有多少个步长。

时间参数的设置与日期参数类似,这里不再展开描述。

参数分组

参数支持分组展示,将相关业务含义的参数分成一组,方便数据分析过程中查找和使用。

点击参数分组,弹出参数分组窗口。

点击新建分组,输入分组名称回车后,创建一个参数分组。 选中分组,在右侧为该分组添加参数,最后点击确定按钮后,完成参数分组。

在参数页面可以看到每个参数的分组信息,一个参数可能会分到多个组中,有多个分组标签。

查找参数时可以通过分组快速查找到相关业务含义的字段。

参数说明

  1. 参数默认值为动态值时,能够指定选取字段的哪一项吗?

    参数默认值为动态值时,只能选取字段或指标的第一项做为默认值。

  2. 使用参数时,图表突然报错显示没有合适范围值 ?

    当参数的允许值为“列表”或“范围”时,随着时间的迁移,参数值可能会不在列表之内或者超出了指定范围,使用该参数的数据集或图表会报错。

  3. 同一个参数,不同用户看到的参数取值不同?

    动态列表参数的取值是数据集字段,所以参数值会随着字段内容动态变化,如果对数据集进行了行权限控制,因为不同的用户权限不同,所以看到的参数值也不同。

  4. 同一个参数,不同用户看到的默认值不同?

    默认值为动态值类型时会选取数据集中字段的内容作为默认值,如果对数据集进行了行权限控制,因为不同的用户权限不同,所以看到默认值也不同。

衡石分析平台使用手册