Spotfire® 用户指南

参数化信息链接

使用参数化信息链接可以将数据源设置为仅返回适用于特定用户或组的信息。根据登录的具体用户以及对信息链接的访问情况(例如用户从何处访问信息链接),可用的数据子集将各不相同。

此概念类似于个性化信息链接,但更为普遍,而且需要 API 配置才能正常工作。虽然参数在 Information Designer 中创建,但其属性和定义在 API 中定义。

参数化信息链接是包含许多参数的信息链接。在 Information Designer 中,您可以为这些参数定义名称和类型,并在信息链接中创建各种不同的元素时使用这些参数。为了能够在 Spotfire 中打开参数化信息链接,您必须能够提供这些参数的值。具体方式在 API 中确定。

为何使用参数?

例如,您可以使用参数来针对从数据库加载的数据设置 Web 客户端分析。如果 Web 客户端分析集成到门户或类似对象中,则您可以使用参数来定义分析的内容。然后,可通过门户中的其他应用程序或通过用户在门户的其他部分中应用的设置来定义这些参数的值。

另一个例子是,在您希望创建分析文件,但希望随后可以为不同用户轻松创建该分析文件的不同版本时。之后,您可以设置使用参数化信息链接的模板文件,并从该文件使用 API 创建具有不同参数值的不同文件。

可在何处包含参数?

元素类型 参数化属性
  • 列计算
  • 聚合列键表达式
  • 筛选器条件
筛选器
  • 筛选器条件
程序
  • 输入参数默认值
信息链接
  • 静态筛选器
  • 编辑的 SQL(更新前、查询、更新后)
数据源
  • 打开会话命令。
  • 关闭会话命令。

示例

对于筛选器条件表达式,可将参数用作所选列的条件。

显示筛选器条件表达式的对话框图像

SQL 编辑器中,您可以直接设置参数。

FROM
   "Sales"."dbo"."SalesandCost" S1
WHERE
   (S1."Sales" > ?MinSales)
注: 如果您更改了 SQL 代码中的参数,则所做的更改将覆盖在其他位置所做的任何参数设置,例如“信息链接”选项卡的筛选器部分中的参数设置。
注: 在指向已启用了临时数据表的数据源的信息链接中使用参数时,不支持自定义 SQL。此类自定义 SQL 可能会导致 Spotfire 对数据源生成不正确的 SQL 查询。

语法

命名参数化信息链接的语法为
?param_name
其中“?”指明了它为参数,而 param_name 是用于标识参数的名称。
注: 参数名称应以字母 A-Z 或 a-z 开头,并可包含以下字符:a-z、A-Z、0-9、“_”和“.”。