函數語法準則

請參閱函數描述，以取得各個函數的語法。

  • 若要使用共用連線，您必須將 WSFN 識別碼新增至函數，該識別碼會指定 Workspace 函數以及連線字串。格式為：

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

    例如，在 Oracle Essbase 資料來源之共用連線的 HsGetValue 函數中，WSFN ID 和連線字串會以下列方式新增至函數：

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

    如果是 ProviderType，請使用下列其中一個區分大小寫的字串：

    • Essbase (僅限 Essbase 內部部署；Oracle Essbase 雲端需要專用連線語法)

    • HFM (代表 Oracle Hyperion Financial Management)

    • HP (用於 Oracle Hyperion Planning、Planning、Planning Modules、Financial Consolidation and Close、Tax Reporting)

    如果是財務管理，Database 參數可以省略，或可以和 Application 參數相同。為求一致性，Oracle 建議輸入 Database 參數的應用程式名稱。

  • 若要使用 URL 連線，您必須將 URLFN 識別碼新增至函數，該識別碼會指定 URL 函數以及連線字串。格式為：

    URLFN|URL|Server|Application|Database

    例如，使用 Planning 商業流程連線 URL 之 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"

  • 下列為函數中的別名支援方式：

    • 請勿混用維度名稱及其別名。
    • 至於成員，您可以使用成員名稱，或是使用該成員在已選取別名表中的別名。
    • 您必須使用相同的別名表來選取所有別名。
    • 當您使用具名的專用連線時，請確保您為該連線設定了正確的別名表。
    • 如果別名表中的值與另一個成員名稱相同，畫面就會顯示「無效的成員」訊息。