创建和使用可视化函数

可视化函数 由一个或多个Quiver卡片组成，这些卡片加载、组合和变换数据。Quiver中的可视化函数不会影响Foundry中的基础数据或进行任何Ontology更改；相反，可视化函数会自动对Quiver分析中的数据输入应用一系列逻辑步骤。

创建函数

将卡片添加到您的分析中，以创建函数的逻辑路径，包括您希望在函数中包含的输入和输出。请注意，视觉化和表格卡片不能成为函数的一部分。

在这个示例中，我们创建了一个KPI，返回茶厂中高质量批次的平均咖啡因含量。在分析中，这是针对特定的plant对象计算的，并使用数值参数（以筛选高质量批次）。

逻辑步骤包括导入关联的objects、筛选和聚合，但逻辑可以任意复杂。

通过选择屏幕左上角的fx图标打开函数面板，然后选择创建新函数。

这将打开函数编辑模式，并在函数面板中创建一个新的未发布函数。右侧的面板是函数编辑器。

选择图表中包含函数输出的卡片。在我们的示例中，这是包含我们KPI的数值指标卡片。

点击屏幕底部的设置为输出。

或者，您可以在右侧函数编辑器的输出部分使用下拉菜单选择输出。

一旦您设置了输出，分析图中的合格输入将会以紫色高亮显示。这意味着您可以选择任何高亮的卡片作为函数的输入。

选择您希望设置为输入的卡片，并为每个卡片点击设置为输入。这些是您希望函数用户能够配置的objects或指标。

或者，您可以点击右侧函数编辑器中的添加输入来选择输入。

为函数命名并添加描述。

预览函数

要打开预览模式，请点击顶部标题中的预览按钮。

在预览模式下，您可以在左侧栏更改输入值，并查看其如何影响函数左下角的输出值。

发布函数

通过点击右上角的发布按钮发布函数。确保发布到具有适当权限的文件夹中，以便其他用户可以查看和使用该函数。

现在，该函数已准备好使用。

使用函数

从顶部菜单或使用搜索栏，选择卡片选项卡并搜索以“可视化函数”开头的卡片，并选择具有所需输出类型的卡片（例如，Num表示数字）。

在搜索栏中，选择函数选项卡以查看您有权访问的所有函数，无论这些函数是在哪里创建的。选择您要使用的函数。

如果该函数是在此分析中创建的，您还可以使用函数面板中的**+**按钮。

一旦选择，卡片将被添加到您的分析中。您可以在编辑器面板中配置函数的输入。一旦输入配置完成，卡片将返回函数的结果。

您还可以使用编辑器面板更改函数的版本。如果您希望确保卡片始终返回函数的最新版本的结果，请确保启用自动更新切换。

更新函数

发布函数后，具有函数所有者或编辑权限的用户可以编辑它。首先，您需要打开函数的编辑器面板。

如果您位于创建函数的分析中，请打开函数面板并点击您要编辑的函数。

如果不是，您可以通过点击Foundry中的函数文件直接打开函数。然后点击顶部的编辑按钮。

这将打开创建该函数的分析。

最后，点击顶部标题中函数名称旁边的设置图标()，以打开函数编辑器面板。

在右侧的编辑器面板中，对标题、描述、输入和输出进行所需的更改。准备好后点击重新发布按钮。

这将保存函数的新版本。在分析中使用函数时，您可以选择要应用的版本。您可以通过在单独的标签页中打开函数（点击顶部标题中的函数名称 ），并使用屏幕右上角的下拉菜单更改版本，来查看以前版本的逻辑。

共享函数

当您发布函数时，函数将继承其保存所在文件夹的用户权限，这意味着有权访问该文件夹的用户将能够在其分析中使用该函数。

此外，您还可以通过使用共享面板进一步与用户或用户组共享函数。为此，请在单独的标签页中打开函数（点击顶部标题中的函数名称 ），然后点击右上角的共享。

常见问题

函数可以有多少个输出？

一个函数只能有一个输出。

函数可以有多少个输入？

一个函数可以有任意数量的输入。

支持哪些输出类型？

一个函数可以返回单个object、对象集、时间序列或任何类型的指标。

表格和可视化（不论是否分类）不支持作为函数的输出。

可视化函数和代码函数有什么区别？

代码函数是在Quiver之外的代码库中用代码（TypeScript）编写的。它们可以在Quiver分析和其他应用程序中使用，例如Workshop。

可视化函数是在Quiver内构建的，无需编写一行代码。任何有权访问函数的用户都可以在Quiver分析中使用它们。目前，它们不能在Quiver之外使用。