在函式建置器中建立函式

在「函式建置器」中,您可以選取函式並指定函式要使用的連線和成員。

「函式建置器」接著會使用適當語法建立函式,並將其輸入到選取儲存格。您可以編輯這些函式。

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

您可以為每個函式引數選取儲存格參照。每個引數都具有輸入功能。

若要使用「函式建置器」建立函式,請執行下列動作:

  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#members。如果所有 dimension#member 都是用成員選取器輸入,則無論是否顯示這些組合,都不會有任何驗證訊息。如果連線名稱有拼寫錯誤的情形,您仍然會看到錯誤訊息。

    • 如果連線名稱正確,且所有其他 dimension#member 組合都是使用成員選取器對話方塊新增,則不會顯示驗證成功訊息。
    • 如果連線名稱正確,且一或多個手動輸入的 dimension#member 組合正確,則會顯示驗證成功訊息。
  11. 解決錯誤,然後再按一次驗證

    當函式驗證正確無誤時,系統就會顯示說明驗證成功的訊息。

  12. 按一下套用
  13. 若要執行函式,請依照執行函式中的程序。