Spotfire® Web 客户端用户指南

配置数据函数

运行数据函数时,必须定义在分析中应如何处理数据函数定义的输入和输出参数。必须指定所有必需参数到 Spotfire 的映射才能在分析中使用数据函数。本主题包含有关在 Web 客户端中运行或编辑数据函数时可能提供的不同配置的详细信息。

开始之前

数据函数已使用安装的 Spotfire 客户端创建完毕,并保存在库中。
注: 必须配置所有必需的输入和所有输出(在汇总视图中明确排除的除外),才能运行数据函数。可选输入可以保留不动,不进行配置。

过程

  1. 按照在 Spotfire Web 客户端中运行数据函数中的步骤 1、2 和 3 执行操作。
  2. 如果数据函数设计为使用输入参数来确定计算所基于的数据,则必须配置输入项。
    举例来说,输入可以是从分析中选择的值、列或数据表。并非所有数据函数都需要输入项,也可能存在可选输入会调整计算结果的情况。由数据函数的作者通过指定输入类型和所需数据来确定需要提供的数据。
    提示: 如果在您选择的数据函数中有许多输入,并且只有其中一些是必需的,您可以单击“始终先显示必需的输入”,将可选输入移动到列表末尾并隐藏。

    输入:

    为所选参数指定输入时,无法从下面描述的所有输入类型中进行选择;只会看到适用于当前数据函数和分析的选项。

    • 数据表 – 从下拉列表中选择数据表。

      (数据表选择器通常是选择一个或多个列之前的第一步,但是,它也可以是单独的输入类型。在这种情况下,输入类型仅列出数据表,其中所有数据类型的列均可作为数据函数的输入。如果在列表中找不到所需的数据表,可以使用“列”选项从特定数据表中选择允许的数据类型的所有列。)

    • – 使用下拉列表从指定的数据表中选择一个列。
    • – 在“选择列”对话框中选择一个或多个列。
    • 搜索表达式 – 根据搜索表达式选择多个列(按 Enter 键执行搜索)。如果要选择多个以相同字母开头的列,则此选项很有用。
    • 自定义表达式 – 在“编辑表达式”对话框中指定您自己的表达式。
    • – 键入输入值。该值通常带有一个数据类型选择器,可以在其中更改输入值的数据类型。
    • – 未选择任何输入处理程序或不存在默认处理程序。它可以用于可选输入参数。如果输入参数为必填项,则必须指定一个输入才能继续。

    “受限于”选项允许您将基于列值或数据表的计算限制为仅与指定的筛选和标记组合相匹配的行。如果选择了多个选项,会对仅符合选定筛选和标记的交集的行执行计算。不要在所有行的基础计算上添加任何限制。

    提示: 当数据函数实例已添加到分析中,并且输出是图表中使用的列或行时,可以直接在图表中调整输入值,并快速尝试不同的输入值。您还可以从“数据画布”中的数据函数视图编辑输入和输出参数。
  3. 确定是否要“自动刷新函数”
    选中此复选框可在每次输入设置发生更改时,自动更新数据函数的结果。如果清除该复选框,则需要手动刷新才能使更新生效。可以从已安装的客户端中的“数据函数”属性对话框中进行刷新,Spotfire Analyst 作者也可以添加一个操作控件以从文本区域刷新。
    如果在分析中检测到循环依赖,则配置为自动加载的数据函数将切换为手动更新。
  4. 完成输入后,请单击“确定”
  5. 输出的配置决定了如何处理计算结果。例如,您可能会获得一个新的数据表、新的列或行,或者一个可用于在图表中定义行的文档属性值,或类似的内容。可用的输出类型取决于所选数据函数的输出(值、列或表)以及分析中当前具有的内容。例如,如果在运行数据函数时分析中没有数据表,则您唯一的选择就是添加新的数据表。有了数据表后,便可选择更多选项。

    输出:

    • 添加为新数据表 – 创建一个新数据表。
    • 作为行添加到指定的数据表。有关详细信息,请参见将行添加到数据表
    • 作为列添加到指定的数据表(使用联接操作)。有关详细信息,请参见将列添加到数据表
    • 作为计算列添加到所选(最终)数据表中。

      如果您选择将输入限制为仅标记或筛选的行,则使用“针对以下项将结果映射到受限的行”选项可以指定如何将结果值添加到数据表中。如果清除此复选框,则结果将被添加到指定数据表的第一行中,但是如果您选择仅计算筛选值的结果,则可能需要将结果添加到执行计算时筛选出的那些行。从下拉列表中选择要匹配的输入参数。

    • 替换数据表 – 通过从下拉列表中进行选择来替换之前添加的数据表。
    • 在分析中添加为文档属性值。您可以定义一个新属性或更新一个现有属性。请注意,如果定义一个新属性,则只有在数据函数的执行成功完成后才能创建该属性。
    • 添加为数据表属性值 – 选择一个数据表并创建或更新数据表属性。
    • 添加为列属性值 – 选择一个数据表、该数据表中的列,并创建或更新列属性。
  6. 完成后,单击“确定”