函数语法准则

有关各个函数的语法,请参阅“函数说明”。

  • 要使用共享连接,必须将指定 workspace 函数的 WSFN 标识符以及连接字符串添加到函数中。格式为:

    "WSFN|ProviderType|Server|Application|Database","POV"

    例如,在 Oracle Essbase 数据源的共享连接的 HsGetValue 函数中,将 WSFN 标识符和连接字符串添加到如下所示的函数中:

    =HsGetValue("WSFN|Essbase|myserver|Sample|Basic","Market#South")

    对于 ProviderType,使用以下区分大小写的字符串之一:

    • Essbase(仅限 Essbase 内部部署Oracle Essbase 云需要使用专用连接语法)

    • HFM(适用于 Oracle Hyperion Financial Management

    • HP(适用于 Oracle Hyperion PlanningPlanningPlanning 模块Financial Consolidation and CloseTax Reporting

    对于 Financial ManagementDatabase 参数可以省略,或者它可以与 Application 参数相同。为了保持一致,Oracle 建议为 Database 参数输入应用程序名称。

  • 要使用 URL 连接,必须将指定 URL 函数的 URLFN 标识符以及连接字符串添加到函数中。格式为:

    URLFN|URL|Server|Application|Database

    例如,使用 URL 表示 Planning 业务流程连接的 HsGetValue 函数语法如下:

    HsGetValue("URLFN|URL|Server|Application|Database","POV")

    建立连接所需的所有信息是令牌的一部分,如上文所示。如果令牌包含任何无效信息,则通常会显示 #NoConnection 错误,但服务器令牌存在以下例外:

    • 对于 Oracle Enterprise Performance Management Cloud 业务流程(例如 Planning),服务器令牌可以为空(或无效)
    • Essbase 服务器令牌只能为空
    • Financial Management 需要服务器令牌参数
  • 专用连接参数可包含以下值:

    • :默认连接

    • HsActive:活动的关联连接

    • 专用连接的用户定义名称

    如果指定专用连接,则它必须位于 POV 之前。

  • POV 是由 dimension#member 对构成的,例如:

    Entity#Connecticut
  • 父子关系是通过句点 (.) 指定的;例如:

    Entity#UnitedStates.Maine
  • 连接和每个 POV dimension#member 对可以拆分为单独的函数参数,每个参数都用引号 (") 括起来,并用逗号 (,) 分隔;例如:

    "My_connection","Entity#UnitedStates","Account#Sales"

    或者,可以用逗号 (,) 将连接与 POV 分隔;并且整个 POV 用引号 (") 括起来,每个 dimension#member 对用分号 (;) 分隔;例如:

    "My_connection","Entity#UnitedStates;Account#Sales"
  • 支持在函数中使用别名,具体如下:

    • 不要混合使用维名称及其别名。
    • 对于成员,可以使用成员名称或其来自选定别名表的别名。
    • 所有别名必须使用同一别名表。
    • 如果使用命名的专用连接,请确保为连接设置了正确的别名表。
    • 如果别名标签与其他成员名称具有相同值,则将显示“无效成员”消息。