在函數建置器中建立函數

在「函數建置器」中，您可以選取函數並指定函數要使用的連線和成員。「函數建置器」接著會使用適當語法建立函數，並將其輸入到選取儲存格。您可以編輯這些函數。

所指定「函數建置器」欄位中提供的選取項目會受您在「函數建置器」其他欄位所選取項目的限制。例如，只會顯示所選函數支援的連線以及所選函數支援的維度。

您可以為每個函數引數選取儲存格參照。若您知道引數輸入值，您可以在離線模式下建立函數。每個引數都具有輸入功能。

函數描述

註：

您可以使用在「函數建置器」(版本 11.1.2.2.310 之前) 中建立的函數。然而，從版本 11.1.2.2.310 開始，「函數建置器」使用逗號 (,) 來區分成員清單引數，而非分號 (;)。新的「函數建置器」同時支援兩種字元，但是當您修改先前版本中建立的函數時，系統會提示您轉換成以逗號區隔的新格式。若您選擇不轉換，則不會套用該函數所做的任何變更。

若要使用「函數建置器」建立函數，請執行下列動作：

  1. 連線適當的資料來源。

    函數建置器支援共用、專用及 URL 連線。最佳作法是，確保您已在立方體層級連線。如果您已在應用程式層級連線，則在使用 Smart View 函數 (例如 HsGetValue 或 HsSetValue) 時，可能會收到「未選取立方體」訊息。不過，對於 Oracle Hyperion Financial Management，您可以繼續在應用程式層級連線以使用 Smart View 函數。

    Oracle Essbase：如果您使用專用連線而且您的函數將要使用別名表格，您必須確定針對該連線設定正確的別名表格或「預設」別名表格。在智慧型檢視面板中，在資料庫名稱上按一下滑鼠右鍵，然後選取設定別名表格。確定已選取正確的別名表格，然後重新整理工作表。

  2. 在工作表中選取要輸入函數的儲存格。
  3. 在智慧型檢視面板中，導覽至您要作為函數基礎的資料庫，接著在資料庫名稱上按一下滑鼠右鍵，然後選取建置函數。

    以這種方式存取「函數建置器」將會在函數引數對話方塊的連線欄位預先植入特定連線資訊 (如步驟 4 所述)。

    或者，請從「智慧型檢視」功能區中選取函數，然後選取建置函數。

    您以這種方式存取「函數建置器」時，函數引數對話方塊中的連線欄位會空白。您可以提供連線資訊 (如步驟 4 所述)。或者，如果工作表上有作用中的連線，請從下拉清單選取 HSACTIVE。

  4. 在選取函數中，從清單中選取函數，然後按一下確定。

    圖 17-1 函數建置器 - 選取函數對話方塊


    依本節所述，選取「函數建置器 - 選取函數」對話方塊及 HsGetValue

    註：

    並非所有提供者都可以使用所有函數。請參閱表格 17-1以取得函數清單與支援的提供者。

    隨即顯示函數引數對話方塊，其中連線欄位會以下列其中一個格式自動填入連線資訊。

    • 如果是共用連線：

      WSFN|ProviderType|Server|Application|Database

      上述 WSFN 參數表示此函數為工作區函數，並使用共用連線。工作區函數支援 Oracle Hyperion Enterprise Performance Management Workspace 或 Oracle Enterprise Performance Management Cloud 連線。

    • 如果是專用連線：

      PrivateConnectionName

    • 如果是 URL 連線：

      URLFN|URL|Server|Application|Database

    連線所需的所有資訊都是憑證的一部分，如上所示。如果憑證包含任何無效資訊，則一般會顯示 #NoConnection 錯誤，伺服器憑證則有下列例外：

    • EPM Cloud 商業流程 (例如 Planning) 的伺服器憑證可以空白 (或無效)
    • Essbase 伺服器憑證只能是空白的
    • Financial Management 需要伺服器憑證參數

    若要手動輸入連線資訊，請使用以上的語法。

  5. 在函數引數中，針對所選函數中的個別引數執行下列其中一個動作：

    • 按一下最右邊的按鈕 「成員選擇」按鈕，開啟「成員選擇」對話方塊。

      例如，若為 HsGetValue，請按一下 「成員選擇」按鈕，開啟「成員選擇」對話方塊，以選取成員選取中的成員；若為 HsLabel 和 HsGetVariable，則從標籤或變數的下拉清單中選取。

      Essbase：請注意，當變數名稱重複時，其完整名稱會顯示在下拉清單中。這可以協助識別定義在全球、應用程式和資料庫層級的變數。

    • 若要手動輸入引數，請在文字方塊中輸入引數。例如，若要輸入成員，請使用以下格式：dimension#member；例如 Year#Qtr1 或 Year#Jan。

    • 若要使用儲存格參照，請依照使用儲存格參照中的程序。

    圖 17-2 顯示 HsGetValue 函數的完整函數引數對話方塊。

    圖 17-2 根據 Essbase 基本範例資料庫之 HsGetValue 的函數建置器 - 函數引數對話方塊


    HsGetValue 函數的「函數建置器」對話方塊與「函數引數」對話方塊。有一個「連線」欄位以及輸入每個函數引數之維度和成員的欄位。

    函數引數中列出的引數會視在上一步所選取的函數而有所差異。

    註：

    請考量下列最佳作法：

    • 如果是 HsGetSheetInfo，請使用儲存格參照。請參閱使用儲存格參照以取得詳細資訊。

    • 僅限 HsSetValue：選取資料或儲存格參照，然後輸入要提交的值。

    • 僅限 HsGetText 和 HsSetText：

      • 選取備註或儲存格參照，然後輸入要提交的儲存格文字

      • 選取儲存格文字標籤，然後從下拉功能表選取標籤

    • 若有作用中的工作表連線，您可以從連線下拉清單中選取 HSACTIVE。

  6. 按一下驗證並更正任何指出的錯誤。

    以下是您部分可能看到的錯誤：

    • 連線離線或無效

    • 無效的選擇

    • 成員名稱無效或和選取的別名不相符

    • 維度名稱無效或和選取的別名不相符

    • 未完成 Dimension#Member 組合

    • 遺漏引號或其他次要語法錯誤的一般性「錯誤」

    圖 17-3 顯示按一下驗證按鈕之後「函數引數」對話方塊中的錯誤。在下列 Financial Management Simple 應用程式的範例中，兩個 Dimension#Member 組合的語法發生錯誤。第一個錯誤是「維度」名稱無效或和選取的別名不相符。第二個錯誤是成員名稱無效或者和選取的別名不相符。

    圖 17-3 函數建置器驗證錯誤


    HsGetValue 函數的「函數建置器」對話方塊與「函數引數」對話方塊。兩個 Dimension#Member 組合的語法發生錯誤第一個錯誤是「維度」名稱無效或和選取的別名不相符。第二個錯誤是成員名稱無效或者和選取的別名不相符。
  7. 當函數驗證成功時，請按一下確定，將函數插入至選取的儲存格。
  8. 若要執行函數，請依照執行函數中的程序。