參數

參數可讓您與使用者提供的資料互動。舉例來說，您可以建立包含報告使用者輸入內容的計算欄位，也可以將值傳回資料來源使用的 SQL 查詢。使用參數可讓報表更具互動性。您也可以使用參數建立報表範本。

參數的運作方式

參數的運作方式類似於程式設計語言中的變數。參數主要有三種用途：

• 您可以在計算欄位中使用參數，根據使用者輸入內容顯示結果。
• 您可以在 BigQuery 資料來源中，將參數傳回自訂 SQL 查詢。
• 您可以將參數傳回社群連結器。

參數可從下列位置取得資料：

• 從為參數定義的預設值
• 透過元件屬性面板
• 從報表中的控制項
• 透過報表連結

在報表和資料來源編輯器的欄位清單底部，您會看到參數。參數會顯示為紫色欄位。

參數如何在報表中分享資料

報表和資料來源的編輯者可以存取參數控管的任何資料。報表編輯者可透過參數要求與預設值不同的資料。

為資料來源啟用參數前，請務必瞭解參數值變更可能對報表資料造成的影響。部分參數可能只會傳回相對「安全」的資料，例如新地區的天氣。但其他參數可能會允許使用者要求全新的資料集。

舉例來說，帳號參數或資料庫表格名稱可能會傳回您不打算分享的資料。這兩者都可能傳回不同的結構定義，而這可能與報表中的現有圖表不相容。

建立參數

您可以在下列位置建立參數：

在資料來源中

1. 編輯資料來源。
2. 按一下右上角的「新增參數」。 您也可以在編輯報表時建立參數，方法是選取元件，然後按一下右下方的「新增參數」。請務必根據所需資料來源選取元件。
3. 設定參數的選項和預設值 (請參閱下文)。

編輯報表時，您可以使用資料面板中的「+新增參數」連結，在所選資料來源中建立參數。

在 BigQuery 連接器中

您可以在 BigQuery 連接器中，將參數傳遞至自訂 SQL 查詢。BigQuery 連接器定義了幾個標準參數，可傳遞報表的開始和結束日期，以及使用者的電子郵件地址 (如有)。您也可以傳遞自訂參數。瞭解詳情。

參數和社群連接器

社群連結器可以包含可覆寫的參數，讓報表編輯者在資料來源中修改預設值。如果您可以編輯使用社群連結器建立的資料來源連線，就能指定報表編輯者可變更的參數：

1. 編輯資料來源。
2. 按一下左上方的「編輯連結」。
3. 如果連接器提供可編輯的參數，這些參數會顯示在頁面底部。如果連接器允許您定義自訂參數，頁面會顯示相關操作說明。
4. 使用「允許在報表中修改 <參數名稱>」核取方塊，允許或禁止在報表中編輯參數。
5. 按一下右上方的「重新連結」。

使用社群連接器建立資料來源後，該連接器的參數變更不會自動顯示在資料來源中。如要查看任何新增、移除或變更的參數，請重新連結資料來源

編輯現有參數

如要變更現有參數的設定：

1. 編輯含有參數的資料來源。
2. 在欄位清單中找出參數。
3. 按一下參數名稱右側的 @ 符號。
4. 進行變更，然後按一下右下方的「儲存」。

設定參數

使用這些選項設定資料來源中的參數。如需 BigQuery 連接器和社群連接器參數，請參閱上述文章。

參數名稱：您會在報表和資料來源的欄位清單中看到這個名稱。您也會使用這個名稱，在計算欄位中參照參數。

參數 ID：預設設定。Looker Studio 會在內部使用參數 ID 識別參數。報表檢視者不會看到這項資訊。

重要事項： 變更參數 ID 會導致包含該參數的元件和計算欄位無法運作。

資料類型：參數可儲存文字、數字或布林值 (true/false)。

允許的值：指定使用者可輸入的值。

如要指定值清單，請選擇該選項，然後輸入可接受的值和顯示名稱 (選填)。按一下「新增選項」，即可在清單中新增更多項目。

如要指定允許的值範圍，請輸入範圍的最小值和最大值。

預設值：指定參數的起始值。

設定參數值

您可以透過下列方式設定參數值：

設定參數的預設值

建立參數時，您可以設定參數的預設值。如要調整預設值，請按照上述步驟編輯參數。

使用控制項取得使用者輸入內容

控制項是可讓使用者與報表互動的元件。如要將使用者輸入內容儲存在參數中，請將該參數新增至控制項的「控制項欄位」屬性：

1. 編輯報表。
2. 按一下頂端的「新增控制項」。
3. 選擇要新增的控制項類型。
4. 在「屬性」面板中，選取「設定」分頁標籤。
5. 在「控制欄位」中新增參數。

進一步瞭解控制項。

在元件中覆寫預設參數值

如要覆寫參數的預設值，請編輯報表中的個別元件：

1. 編輯報表。
2. 根據包含參數的資料來源選取元件。
3. 在元件「資料」分頁的底部，編輯預設參數值。

您也可以在報表和網頁層級編輯參數：

1. 編輯報表。
2. 依序選取「檔案」>「報表設定」或「頁面」>「目前頁面設定」。
3. 編輯參數值。

參數繼承

參數的沿用規則與篩選器屬性相同。具體來說，優先順序較高元件的參數會覆寫優先順序較低元件的參數。優先順序 (由低至高) 如下：

1. 資料來源 (預設)
2. 檢舉
3. 頁面
4. 群組
5. 個別圖表或控制項

透過報表連結修改參數

開發人員和進階使用者可以透過報表網址設定參數，以程式輔助方式建構報表。

系統會使用「params」查詢參數，將 Looker Studio 報表參數及其對應值，以網址編碼的 JSON 字串形式附加至報表網址。

詳情請參閱開發人員指南。

管理報表參數

根據預設，您無法透過報表網址編輯報表中的參數。

如要選取報表使用者可修改的參數，請按照下列步驟操作：

1. 編輯報表。
2. 依序選取「資源」>「管理變數 (參數)」。
3. 在「允許在報表網址中修改」欄中，勾選要允許的參數。

這個頁面也會顯示每個參數的網址參數。建構編碼參數物件時，您會使用這個名稱，而不是參數名稱。如要編輯這個名稱，請按一下編輯鉛筆圖示。報表中的每個網址參數都不得重複。

編輯網址參數名稱不會影響報表中使用參數的方式。

使用參數

建立完成後，您就能在計算欄位和報表元件中使用參數，就像使用維度和指標一樣。

在計算結果欄位中使用參數

您可以在計算結果欄位中使用參數，就像使用維度或指標一樣。

含有參數的計算結果欄位。按一下即可展開。

舉例來說，假設您想讓使用者輸入上季銷售額的乘數，藉此顯示預測銷售額。

首先，請建立參數來存放預測乘數：

1. 登入 Looker Studio。
2. 編輯資料來源。
3. 按一下右上方的「新增參數」。
4. 為參數命名 (例如「預測乘數」)。
5. 將「資料類型」設為「數字」。
6. 為求簡單，請將「允許的值」選項設為「任何值」。
   您可以使用其他選項，讓使用者從值清單中挑選，也可以將輸入內容限制在特定範圍內。
7. 將「Default value」(預設值) 設為 1。
8. 按一下 [儲存]。
9. 如要返回資料來源欄位清單，請按一下左側的「所有欄位」。

接著，建立計算欄位：

1. 按一下右上方的「新增欄位」 。
2. 為欄位命名 (例如「含參數的銷售預測」)。
3. 在公式中，將資料來源的「銷售量」欄位乘以 Forecast multiplier 參數。舉例來說，如果資料來源有名為「收益」的欄位，請輸入下列內容：
   Revenue * Forecast multiplier
4. 按一下 [儲存]。

接著，加入控制項來收集使用者輸入的內容：

1. 編輯或建立報表。
2. 視需要將資料來源新增至報表。
3. 按一下頂端的 />「新增控制項」 。
4. 選取「輸入方塊」控制項。
   您可以使用「輸入方塊」控制項直接輸入參數值。其他類型的控制項則可供您從清單中選取項目、使用滑桿，或透過核取方塊切換布林值。
5. 在右側的「DATA properties」中，新增您先前建立的 Forecast multiplier 參數。

最後，在圖表中以視覺化方式呈現參數化計算欄位。

1. 按一下頂端的 「新增圖表」。
2. 為求簡單，請選取「評量表」。
3. 在右側的「DATA properties」(資料屬性) 中，將 Sales forecast with parameter 計算結果欄位新增為指標。

現在試試看：

1. 按一下右上方的「查看」。
2. 在「預測乘數」控制項中輸入數字，然後按下 Enter 鍵。
3. 您輸入的值會與評量表中的值相乘，因此評量表中的值會隨之變動。

在視覺化中加入參數

您可以為圖表新增參數，就像新增維度或指標一樣。如果您使用數值參數做為指標，系統會彙整其值。

在報表中顯示或隱藏參數

您可以顯示或隱藏在資料來源中建立的參數：

1. 編輯資料來源。
2. 找出參數。
3. 按一下參數右側的「選項」圖示 。
4. 按一下「顯示」 (如果參數目前處於隱藏狀態) 或「隱藏」 (如果參數目前處於顯示狀態)。

隱藏參數會將其從「資料」面板的欄位清單中移除，並毀損任何使用該參數的元件。如果參數用於計算欄位，公式會使用參數的預設值。

複製含參數的元件

複製元件時，系統會複製屬性面板中設定的參數值。您可以編輯元件，覆寫副本的參數。

修正無效參數

如果連結器中的參數設定有變更，使用這些參數的任何圖表可能會無法正常運作。舉例來說，連接器的開發人員可能會移除覆寫參數值的功能，而您在報表中提供的參數值不再傳回有效資料。在這種情況下，受變更影響的圖表會顯示錯誤訊息。

如要修正這個問題，請找出含有無效參數的元件。然後在該元件的「資料」屬性「參數」部分，按一下「修正無效值」。

請注意，參數可以在報表、網頁和群組層級設定，也可以在個別圖表上設定，因此您可能需要在多個位置尋找並修正錯誤。

相關資源

關於控制選項