关于参数属性

在工作簿中使用参数的方式和位置决定了为其设置的属性。例如,对于要用作筛选器控件的参数和要在表达式中使用的参数,您可能会设置不同的属性。

创建或修改参数时可以设置的属性如下:

数据类型

指定参数包含的数据种类,以及参数接受的值或值范围。数据类型也用于验证参数是否兼容,以及是否为使用参数的位置正确生成了表达式。

格式

提供日期和时间格式设置选项。此属性可用于日期、时间和时间戳数据类型。

您可以使用默认格式“自动”,从可用选项中选择,或者定义定制格式。

允许多选

确定参数可以接受单个初始值还是多个初始值。

启用多个值后,可使用初始值字段指定多个初始值,或编写 SQL 表达式以提供初始值。在参数包含多个初始值并且您将参数用作筛选器控件时,用户可以选择一个或多个初始值。

别名

提供通过参数传递的数据元素或键值的覆盖显示值。

许多数据集中使用的数据元素名称不友好。可使用别名帮助用户了解数据元素是什么。例如,您可以创建别名 "Last Order Date" 而不使用数据元素名称 LST_OR_DT,以提供用户友好的名称。

可使用别名提供更熟悉的用户友好名称,以便用户从筛选器控件中进行选择。例如,对于数据值 1,可以提供别名 East Sales Region,对于数据值 2,可以提供别名 West Sales Region。

对于数据操作,在参数中使用别名来传递键值和显示值。然后,在目标工作簿应用传入参数值时,还会对每个传入键值应用传入显示值。

设置数字格式

确定参数的数值是否包含千位和小数格式。此选项适用于整数和双精度数据类型。

设置数字格式切换为启用时,参数值使用由浏览器的语言设置确定的数字格式设置,例如 12,500 或 12.500。

设置数字格式切换为禁用时,参数值不包含数字格式设置,例如 12500。

可用值

指定参数可以保存的值列表。参数的可用值包括任意、值、列、逻辑 SQL 查询和值范围。最多可以高速缓存 10,000 个可用值。

  • 选择任意以允许用户输入数据类型支持的任何值。

  • 选择以提供一个或多个可供用户选择的值。如果启用了允许多个值,则用户可以选择多个值。

  • 选择以选择要从其提取值列表的列。选择此选项后,列选择字段将显示工作簿的所有主题区域或数据集列(包括派生日期),以及任何关键度量和计算。

    派生日期是具有不同粒度级别(例如年、季度、月和日)的列。Oracle Analytics 会自动为数据集中的任何“日期”、“时间”或“时间戳”列生成派生日期列。

  • 选择逻辑 SQL 查询以输入可返回一个或多个可用值的逻辑 SQL 表达式。您可以在逻辑 SQL 表达式中引用其他参数。输入逻辑 SQL 表达式后,可以单击验证图标以验证该表达式。

  • 选择范围以提供起始值和结束值,限制可供用户选择的值。

强制验证

您创建或修改参数时,此选项会根据可用值列表检查该参数的初始值。

在运行时,此选项会验证指定的参数值是否属于可用值列表的一部分。

在设计时,如果在可用值字段中选择,则启用强制验证选项将在初始值字段中提供可用值列表。

初始值

初始值是在用户打开工作簿时应用和显示的参数默认值。

  • 当您不希望应用默认初始参数值时,选择并将值字段留空。如果您未指定初始值,系统将使用所有值。

  • 选择并指定要应用的值作为默认初始参数值。请注意以下事项:

    • 如果选中了允许多选,则可以指定多个初始值,最多 1,000 个初始值。

    • 如果选中了强制验证,则可以从可用值字段中指定的值中进行选择。

  • 选择第一个可用值以应用并显示参数值列表中的第一个值作为默认初始值。如果您使用的属性列包含字母,则第一个值由逻辑 SQL 表达式返回的列表确定。返回的列表始终按字母顺序排列。

  • 选择逻辑 SQL 查询以输入可从数据源动态提取值列表的逻辑 SQL 语句。您可以在逻辑 SQL 表达式中引用其他参数。输入逻辑 SQL 表达式后,可以单击验证图标以验证该表达式。