使用函数生成器创建函数

在函数生成器中,选择一个函数,并指定希望函数使用的连接和成员。

然后,函数生成器将使用正确的语法创建函数,并将其输入到选定的单元格中。您可以对这些函数进行编辑。

在给定函数生成器字段中可供使用的选项,受限于您在函数生成器的其他字段中所做的选择。例如,只会显示所选函数支持的连接,并且只会显示该函数支持的维。

可以为每个函数参数选择单元格引用。键入功能对每个参数可用。

使用函数生成器创建函数:

  1. 连接至数据源。
  2. 选择多维数据集,然后在显示的连接对话框中,选择设置为函数的连接,然后键入连接的名称。

    在下面的示例中,连接名称为 MyVision

    注:

    您必须为每个电子表格创建连接名称。

    连接名称随电子表格一起保存。重新打开保存的电子表格时,将不会提示您输入连接名称。

    图 12-1 连接选项和名称


    连接对话框中显示了三个选项:“即席分析”、“为此工作表设置活动连接”和“设置为函数的连接”。此外,还有一个“名称”字段,您可以从中输入要用于函数的连接名称
  3. 在工作表中,选择您要在其中输入函数的单元格。
  4. 扩展菜单中,选择 Smart View for Google Workspace,然后在函数下选择构建函数
  5. 函数生成器面板中,从列表中选择函数,然后单击选择

    注:

    Smart View 目前支持以下功能:

    • HsGetValue
    • HsSetValue
    • HsAlias
    • HsGetSheetInfo

    有关这些函数的详细说明,请参阅“函数说明”。

    在下面的示例中,选择了 HsGetValue 函数。

    图 12-2 函数生成器的“支持的函数列表”面板


    函数生成器中显示了支持的函数列表,可从中选择要使用的函数。已选择 HsGetValue

    单击选择后,所选函数的面板显示在函数生成器中。以下示例显示了函数生成器中 HsGetValue 的字段。这些字段会随所选函数而异。

    图 12-3 函数生成器的“成员列表”面板


    默认的函数生成器面板,所有维和成员参数字段均为空
  6. 对于 HsGetValue:
    1. 连接中,输入您在步骤 2 中指定的连接名称。
    2. 成员列表中,使用以下任何方法为多维数据集中的每个维添加参数:
      • 单击参数文本框旁边的选择成员按钮 用于打开“成员选择”对话框的“成员选择器”按钮,然后在成员选择器中选择维和成员。对多维数据中的每个维重复操作。
      • 手动输入参数,方法是按以下格式在文本框中键入维和成员对:dimension#member。例如 Year#Qtr1Year#Jan。对多维数据中的每个维重复操作。
      • 要使用单元格引用,请按照“使用单元格引用”中的过程进行操作。

      以下示例显示了 HsGetValue 函数的已完成的成员列表。

      图 12-4 基于 Planning Vision 示例数据库的函数生成器 HsGetValue 面板


      函数生成器的已填充 HsGetValue 函数面板
    3. 可选:要在成员列表中添加更多行,请单击添加
  7. 对于 HsSetValue:
    1. 中,输入要设置的值。
    2. 连接中,输入您在步骤 2 中指定的连接名称。
    3. 成员列表中,为多维数据集中的每个维添加参数。
    4. 可选:要在成员列表中添加更多行,请单击添加
  8. 对于 HsAlias:
    1. 连接中,输入您在步骤 2 中指定的连接名称。
    2. 成员名称目标别名源别名唯一名称字段中输入值。
  9. 对于 HsGetSheetInfo:工作表属性列表中选择属性。
  10. 单击验证,然后更正任何错误。

    错误标注在函数生成器面板中的问题区域旁边。

    以下是一些可能会看到的错误:

    • 连接脱机或无效
    • 选择无效
    • 成员名称无效或与选定的别名不匹配
    • 维名称无效或与选定的别名不匹配
    • Dimension#Member 组合不完整
    • 缺失引号或其他轻微语法错误等一般“错误”

    例如,“函数生成器验证错误”显示了一些简单的拼写错误,这些错误导致连接名称无效、一个参数中的维名称无效以及另一个参数中的成员名称无效。

    图 12-5 函数生成器验证错误


    连接名称、维名称和成员名称中的拼写错误导致紧接着出现指出问题的内嵌消息。

    注:

    验证仅适用于手动键入文本框的 dimension#member 组合,不适用于使用成员选择器对话框添加的那些 dimension#member。如果所有 dimension#member 组合都是使用成员选择器输入的,则不显示关于那些组合的验证消息。如果连接名称拼写错误,您可能仍会看到关于该名称的错误。

    • 如果连接名称正确并且所有其他 dimension#member 组合都是使用成员选择器对话框添加的,则不会显示“验证成功”消息。
    • 如果连接名称正确并且一个或多个 dimension#member 组合是手动正确键入的,则会显示“验证成功”消息。
  11. 解决错误,然后再次单击验证

    当函数正确验证后,将显示一条消息,指明验证成功。

  12. 单击应用
  13. 按照“运行函数”中的过程执行函数。