使用函数生成器创建函数
在函数生成器中，选择一个函数，并指定希望函数使用的连接和成员。然后，函数生成器将使用正确的语法创建函数，并将其输入到选定的单元格中。您可以对这些函数进行编辑。
在给定函数生成器字段中可供使用的选项，受限于您在函数生成器的其他字段中所做的选择。例如，只会显示所选函数支持的连接，并且只会显示该函数支持的维。
可以为每个函数参数选择单元格引用。如果知道参数输入值，则可以在脱机模式下创建函数。键入功能对每个参数可用。
注：
可以使用在发行版 11.1.2.2.310 之前的函数生成器中创建的函数。不过，从发行版 11.1.2.2.310 开始，函数生成器使用逗号 (,) 而不是分号 (;) 来分隔成员列表参数。新函数生成器支持这两种字符，但如果要修改在以前版本中创建的函数，系统将提示您转换为使用逗号分隔的新格式。如果选择不转换，则不会应用对函数所做的任何修改。
使用函数生成器创建函数：
- 在选择函数中，从列表中选择一个函数，然后单击确定。
图 17-1 函数生成器，“选择函数”对话框
注：
不是所有的提供程序都可使用所有函数。有关函数和支持的提供程序的列表，请参阅表 17-1。
此时将显示函数参数对话框，其中的连接字段使用以下格式之一自动填充了连接信息。
-
对于共享连接：
WSFN|ProviderType|Server|Application|Database上面的
WSFN参数说明该函数是一个 Workspace 函数并使用共享连接。Workspace 函数支持 Oracle Hyperion Enterprise Performance Management Workspace 或 Oracle Enterprise Performance Management Cloud 连接。 -
对于专用连接：
PrivateConnectionName -
对于 URL 连接：
URLFN|URL|Server|Application|Database
建立连接所需的所有信息是令牌的一部分，如上文所示。如果令牌包含任何无效信息，则通常会显示
#NoConnection错误，但服务器令牌存在以下例外：- 对于 EPM 云业务流程（例如 Planning），服务器令牌可以为空（或无效）
- Essbase 服务器令牌只能为空
- Financial Management 需要服务器令牌参数
要手动输入连接信息，请使用上面的语法。
-
- 在函数参数中，对所选函数中的每个参数执行以下操作之一：
-
单击最右边的按钮
。例如，对于 HsGetValue，单击
可从成员选择中选择成员；对于 HsLabel 和 HsGetVariable，可从标签或变量下拉列表中进行选择。Essbase：请注意，当变量名称重复时，其全限定名将显示在下拉列表中。这有助于确定在全局、应用程序和数据库级别定义的变量。
-
要手动键入参数，请在文本框中输入参数。例如，要键入成员，请使用格式：dimension#member；例如
Year#Qtr1或Year#Jan。 -
要使用单元格引用，请按照“使用单元格引用”中的过程进行操作。
图 17-2 显示了 HsGetValue 函数的完整函数参数对话框。
图 17-2 基于 Essbase Sample Basic 数据库的 HsGetValue 的函数生成器、函数参数对话框
函数参数中列出的参数因上一步中选择的函数而异。
注：
请注意以下最佳做法：-
对于 HsGetSheetInfo，请使用单元格引用。有关详细信息，请参阅“使用单元格引用”。
-
仅限 HsSetValue：选择数据或单元格引用，并输入要提交的值。
-
仅限 HsGetText 和 HsSetText：
-
选择注释或单元格引用，然后输入要提交的单元格文本
-
选择单元格文本标签，然后从下拉菜单中选择标签
-
-
如果有活动工作表连接可用，则可以从连接下拉列表中选择 HSACTIVE。
-
- 单击验证，然后更正可能提出的错误。
以下是一些可能会看到的错误：
-
连接脱机或无效
-
选择无效
-
成员名称无效或与选定的别名不匹配
-
维名称无效或与选定的别名不匹配
-
Dimension#Member 组合不完整
-
缺失引号或其他轻微语法错误等一般“错误”
图 17-3 显示了单击验证按钮后“函数参数”对话框中出现的错误。在以下来自 Financial Management 示例应用程序的示例中，有两个 Dimension#Member 组合存在语法错误。第一个错误是维名称无效或与选定的别名不匹配。第二个错误是成员名称无效或与选定的别名不匹配。
图 17-3 函数生成器验证错误
-