本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # Amazon Quick 中的參數 *參數*是具名變數，可以傳輸供動作或物件使用的值。透過使用參數，您可建立更簡單的方法，讓儀表板使用者能以較淺顯易懂的方式與儀表板功能互動。參數也可以將某個儀表板連接到另一個，讓使用者能夠深入探索不同分析中的資料。 例如，儀表板使用者可以使用清單來選擇一個值。該值會設定一個參數，接著對選擇的值設定一個篩選條件、計算或 URL 動作。然後，儀表板中的視覺效果會回應使用者的選擇。 若要讓儀表板檢視者可以存取參數，請新增參數控制項。您可以設定階層式控制項，以便某個控制項中的選擇可以篩選另一個控制項中顯示的選項。控制項可以選項清單、滑桿或文字輸入區域形式出現。如果您未建立控制項，則仍可將一值傳遞至您在儀表板 URL 中的參數。 若要讓參數運作，無論其是否具有相關控制項，都需要將其連接至分析中的某項。您可以在下列項目中參考參數： + 計算欄位 (多值參數除外) + 篩選條件 + 儀表板和分析 URL + 動作 + 整個分析過程中的標題和描述 一些您可以使用參數的方式如下： + 您可以使用計算來轉換分析中顯示的資料。 + 如果您將具有篩選條件的控制項新增至您正要發布的分析，則儀表板使用者可以篩選資料，無需建立自己的篩選條件。 + 您可以使用控制項和自訂動作，讓儀表板使用者設定 URL 動作的值。 **Topics** + [在 Amazon Quick 中設定參數](parameters-set-up.md) + [在 Amazon Quick 中使用具有參數的控制項](parameters-controls.md) + [在 Amazon Quick 中建立參數預設值](parameters-default-values.md) + [連線至 Amazon Quick 中的參數](parameters-connections.md) # 在 Amazon Quick 中設定參數 請使用下列程序來建立或編輯基本參數。 **若要建立或編輯基本參數** 1. 選擇要使用的分析，然後決定您想要將哪些欄位參數化。 1. 從頁面頂端的圖示清單中選擇**參數**圖示。 1. 選擇窗格頂部附近的加號 (**\$1 新增**) 來新增參數。 編輯現有的參數，方法是先選擇參數名稱附近的 `v` 形圖示，然後選擇 **Edit parameter (編輯參數)**。 1. 對於**名稱**，輸入參數的英數值。 1. 針對**資料類型**，選擇**字串**、**數字**、**整數**或**日期時間**，然後完成下列步驟。 + 如果您選擇**字串**、**數字**或**整數**，請執行下列動作： 1. 對於**值**，請選擇**單一值**或**多個值**。 為只能包含一個值的參數選擇單一值選項。為可以包含一個或多個值的參數選擇多個值選項。多值參數不得為 `datetime` 資料類型。其亦不支援動態預設值。 若要將現有的參數從單一值切換為多個值或反向切換，請刪除並重新建立該參數。 1. (選用) 對於**靜態預設值**或**多個靜態預設值**，請輸入一或多個值。 如果未提供動態預設值或 URL 參數，則在載入第一個頁面期間即會使用此靜態值類型。 1. (選用) 選擇**預設顯示為空白**。 選取此選項可將多值清單的預設值顯示為空白。此選項僅適用於多值參數。 + 如果您選擇**日期時間**，請執行下列動作： 1. 對於**時間精細程度**，請選擇**日**、**小時**、**分鐘**或**秒**。 1. 針對**預設日期**，選取**固定日期**或**相對日期**，然後執行下列動作： + 如果您選取**固定日期**，請使用日期和時間選擇器輸入日期和時間。 + 如果您選取**相對日期**，請選擇滾動日期。您可以選擇**今天**、**昨天**，也可以指定**篩選條件** (「開頭」或「結束」)、**範圍** (這個、上一個或下一個) 和**期間** (年、季、月、週或日)。 1. (選用) 選擇**設定動態預設值**，來建立使用者特定的預設值。 *動態預設值*是載入儀表板的第一個頁面時每個使用者的預設值。使用動態預設值可為每位使用者建立個人化檢視。 計算欄位無法用做動態預設值。 動態預設值不會防止使用者選取不同的值。如果您想要保護資料，則可以新增資料列層級鎖定。如需詳細資訊，請參閱[透過以使用者為基礎的規則使用資料列層級安全來限制對資料集的存取使用以使用者為基礎的規則](restrict-access-to-a-data-set-using-row-level-security.md)。 此選項僅限於選擇單一值參數時才會出現。多值參數不能有動態預設值。 **注意** 如果您選擇了多值參數，畫面將會變更而移除預設選項。反之，您會看到內文為 **Enter values you want to use for this control (輸入要用於此控制項的數值)** 的方塊。您可以在該方塊中輸入多個值，每個值各佔一行。這些值會做為參數控制項的預設選定值。此處的值將與您所選擇為參數控制項輸入的內容進行聯集。如需參數控制項的詳細資訊，請參閱[參數控制項](parameters-controls.md)。 1. (選用) 設定保留值以決定**全部選取**值。參數的**「保留值」是當您選擇**全部選取**作為參數值時，指定給參數的值。當您為參數設定特定的保留值時，不會再將該值視為資料集中的有效參數值。保留值無法用於任何**「參數取用者」，例如篩選條件、控制項和計算欄位以及自訂動作。此外，它不會出現在參數控制項清單中。您可以從**建議值**、**Null** 和**自訂值**中選擇。**建議值**是預設值。如果您選擇**建議值**，則會根據值類型將保留值設定為下列值： + 字串：`"ALL_VALUES"` + 數字：`"Long.MIN_VALUE"-9,223,372,036,854,775,808` + 整數：`Int.MIN_VALUE"-2147483648` 若要在新參數中設定保留值，請在**建立新參數**頁面或**編輯參數**頁面中選擇**進階設定**下拉式清單，然後選取您要的值。 1. 選擇 **Create (建立)** 或 **Update (更新)** 來完成建立或更新參數。 在建立參數之後，您可以採用各種方式使用它。您可以建立控制項 (例如按鈕)，以便能夠為您的參數選擇一值。如需詳細資訊，請參閱下列區段。 # 在 Amazon Quick 中使用具有參數的控制項 在儀表板中，參數控制項會出現在資料表的頂部，其中包含一組視覺效果。提供控制項可讓使用者選擇要在預先定義的篩選條件 或 URL 動作中使用的值。使用者可以使用控制項，在儀表板上的所有視覺效果資料集之中套用篩選條件，而不必自行建立篩選條件。 適用的規定如下： + 若要建立或編輯參數的控制項，請確定該參數存在。 + 多選清單控制項與分析 URL、儀表板 URL、自訂動作和自訂篩選條件相容。篩選條件必須等於或不等於提供的值。不支援其他比較。 + 清單最多可顯示 1,000 個值。如果有超過 1,000 個不同值，則會出現一個搜尋方塊，以便您篩選清單。當篩選清單中包含的值小於 1,001 時，清單的內容會顯示為行項目。 + **Style (樣式)** 選項只會顯示適用於參數的資料類型和單一值或多值設定的樣式類型。若您想要使用的樣式不在清單中，可以透過適當的設定重新建立該參數，然後再試一次。 + 如果您的參數連結至資料集欄位，則其必須是實際欄位。不支援計算欄位。 + 除非有 1,000 個以上的相異值，否則在控制項中，這些值依字母順序顯示。控制項接著會顯示搜尋方塊。每次您想要搜尋值時，即啟動新的查詢。如果結果包含 1,000 個以上的值，您可以使用分頁捲動值。支援萬用字元搜尋。若要進一步了解萬用字元搜尋，請參閱 [使用字元搜尋](search-filter.md#search-filter-wildcard)。 請使用下列程序來建立或編輯現有參數的控制項。 **若要為現有的參數建立或編輯控制項** 1. 選擇現有參數的內容功能表、參數名稱附近的 `v` 圖示，然後選擇 ** Add control (新增控制項)**。 1. 輸入名稱以賦予新的控制項一個標籤。此標籤會顯示在工作區項部，而且稍後會顯示在儀表板顯示所在之資料表的頂部。 1. 從下列樣式中選擇控制項的樣式： + **文字欄位** 文字欄位允許您輸入自己的值。文字欄位使用數字和文字 (字串)。 + **文字欄位 - 多行** 多行文字欄位可讓您輸入自己的值。使用此選項，您可以選擇使用換行符號、逗號、直線 (\$1) 或分號對您輸入到參數控制項中的值進行分隔。文字欄位使用數字和文字 (字串)。 + **下拉式清單** 可用來選取單一值的下拉式清單控制項。此類清單使用數字和文字 (字串)。 + **下拉式清單 - 多選** 可用於選取多個值的清單控制項。此類清單使用數字和文字 (字串)。 + **清單** 可用於選取單一值的清單控制項。此類清單使用數字和文字 (字串)。 + **清單 - 多選** 可用於選取多個值的清單控制項。此類清單使用數字和文字 (字串)。 + **滑桿 (Slider)** 滑桿可讓您將控制項從列的一端滑至另一端來選取一個數值。滑桿使用數字。 + **Date-picker (日期選擇器)** 使用日期選擇器，您可以從行事曆控制項中選擇日期。當您選擇新增日期選擇器控制項時，您可以自訂如何格式化控制項中的日期。若要執行此作業，請針對**日期格式**，使用 [在 Quick 中自訂日期格式](format-visual-date-controls.md) 中所述的記號輸入您想要的日期格式。 1. (選用) 如果您選擇下拉式清單控制項，則畫面會展開，因此您可以選擇要顯示的值。您可以指定值清單，或使用資料集中的欄位。選擇下列其中一項： + **Specific values (特定值)** 若要建立特定值的清單，請一行輸入一個特定值，沒有分隔空格或逗號，如以下螢幕擷取畫面所示。 在控制項中，這些值會依字母順序顯示，而不是依您輸入它們的順序顯示。 + **Link to a data set field (連結到資料集欄位)** 若要連結到欄位，請選擇包含您欄位的資料集，然後從清單中選擇欄位。 如果您變更參數中的預設值，請選擇控制項上的 **Reset (重設)** 來顯示新值。 您在此處所選擇的值將與參數設定中的靜態預設值進行聯集。 1. (選用) 如果參數已設定預設值，則啓用選項**「隱藏控制項值中的「全部」選項」**。這樣做只會顯示資料值，並移除選項以選取控制項中的所有項目。如未設定參數的靜態預設值，此選項將無法運作。您可以選擇參數，然後選取 **Edit parameter (編輯參數)**，在新增控制項後新增預設值。 1. (選用) 您可以限制控制項中顯示的值，以便它們只顯示對其他控制項中選取之項目有效的值。這稱為階層式控制項。 若要建立一個，請選擇 **Show relevant values only (僅顯示相關值)**。選擇一或多個可以變更此控制項中所顯示項目的控制項。 建立串聯式控制項時，會套用下列限制。 + 串聯控制項必須繫結至相同資料集中的資料集資料欄。 + 子控制項必須是下拉清單或清單控制項。 + 對於參數控制項，子控制項必須連結至資料集資料欄。 + 對於篩選條件控制項，子控制項必須鏈接到篩選條件 (而不是僅顯示特定值)。 + 父控制項必須是下列其中一種。 + 字串、整數或數值參數控制項。 + 字串篩選控制項 (不包括「上下」篩選條件)。 + 非彙總的數字篩選控制項。 + 日期篩選控制項 (不包括「上下」篩選條件)。 1. 當您為控制項完成選擇選項時，請選擇 **Add (新增)**。 完成的控制項會出現在工作區的頂部。形狀類似 `v` 的內容功能表會提供四個選項： + **Reset (重設)** 可將使用者的選擇還原為其預設狀態。 + **重新整理清單**僅適用於連結到資料集內欄位的下拉式清單。選擇 **Refresh list (重新整理清單) ** 可查詢資料來檢查變更。控制項中使用的資料會進行快取。 + **Edit (編輯)** 可重新開啟控制項建立畫面，以便您可以變更設定。 開啟**編輯控制項**窗格後，您可以點選不同的視覺效果和控制項以檢視特定視覺效果或控制項的格式化資料。如需格式化視覺效果的詳細資訊，請參閱 [在 Amazon Quick 中格式化](formatting-a-visual.md)。 + **Delete (刪除)** 可控制項。您可以選擇參數內容功能表來重新建立它。 在工作區中，您也可以調整控制項的大小和重新排列控制項。儀表板使用者會看到控制項如您所做的樣子，但無法編輯或刪除它們。 # 在 Amazon Quick 中建立參數預設值 使用本節來進一步了解可以使用哪些類型的參數預設值，以及如何設定各個參數預設值。 每個欄位都可以有一個參數和一個與其關聯的控制項。當有人檢視儀表板或電子郵件報告時，任何已設定靜態預設值的工作表控制項都會使用靜態預設值。預設值可以變更資料的篩選方式、自訂動作的行為方式，以及動態工作表標題中顯示的文字。電子郵件報告也支援動態預設值。 最簡單的預設值是靜態 (不變) 預設值，它向每個人顯示相同的值。身為儀表板的設計者，您可以選擇預設值。儀表板的使用者無法變更。但是，該人員可以從控制項中選擇任何值。設定預設值並不會變更這一點。若要限制人員可以選取的值，請考慮使用資料列層級安全性。如需詳細資訊，請參閱[透過以使用者為基礎的規則使用資料列層級安全來限制對資料集的存取使用以使用者為基礎的規則](restrict-access-to-a-data-set-using-row-level-security.md)。 **若要建立或編輯，適用於每個人的儀表板檢視的靜態預設值** 1. 依您想要編輯的參數選擇內容選單 (`v`)，或遵循 [在 Amazon Quick 中設定參數](parameters-set-up.md) 中的步驟來建立新的參數。 1. 在**靜態預設值**中輸入值以設定靜態預設值。 若要根據檢視儀表板之人員顯示不同的預設值，請建立動態預設參數 (DDP)。使用動態預設值需要一些準備，將人員映射至其指派的預設值。首先，您需要建立資料庫查詢或資料檔案，其中包含要顯示之人員、欄位和預設值的相關資訊。您可以將其新增至資料集中，然後將資料集新增至分析中。接下來，您可以尋找可用來收集資訊、建立資料集，以及將動態預設值新增至參數的程序。 為動態預設值建立資料集時，請遵循下列指引： + 建議您使用單一資料集來包含使用者或群組邏輯分組的所有動態預設定義。如果可以的話，請將它們保留在單一資料表或檔案中。 + 也建議您資料集中的欄位名稱與分析中的欄位名稱盡量相似。並非所有資料集欄位都需要成為分析的一部分，例如，如果您正在多個儀表板中為預設值使用相同的資料集。欄位可以是任意順序的。 + 不建議您將使用者和群組名稱合併在相同的資料欄中，甚至是在相同的資料集中。這種配置將需要更多的工作來進行維護和疑難排解。 + 如果您使用逗號分隔的檔案來建立資料集，則請務必移除檔案中值之間的任何空格。下列範例顯示了正確的逗號分隔值 (CSV) 格式。以單引號或雙引號括住包含非英數字元 (例如空格、單引號等) 的文字 (字串)。您可以用引號括住日期或時間的欄位，但這並非必要動作。您可以用引號括住數字欄位，例如，如果數字包含特殊字元，如下所示。 ``` "Value includes spaces","Field contains ' other characters",12345.6789,"20200808" ValueWithoutSpaces,"1000,67","Value 3",2020-AUG-08 ``` + 建立資料集之後，請務必仔細檢查 Quick 為欄位選取的資料類型。 在開始之前，您需要使用動態預設值的使用者或群組名稱的清單。若要產生使用者或群組的清單，您可以使用 AWS CLI 來取得資訊。若要執行 CLI 命令，請確認您已經安裝及設定 AWS CLI 。如需詳細資訊，請參閱「AWS CLI 使用者指南」**中的[安裝 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)。 這只是如何取得使用者名稱或群組名稱清單的其中一個範例。使用最適合您的任何方法。 **若要識別適合動態預設參數 (DDP) 的人員** + 列出個別使用者名稱或群組名稱： + 若要列出個別使用者名稱，請加入可識別 DDP 人員的資料欄。此欄應包含每個人的系統使用者名稱，用於從您的身分提供者連線至 Quick。此使用者名稱通常與 @ 符號前的人員的電子郵件別名相同，但並非總是如此。 若要取得使用者清單，請使用 [ListUsers](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUsers.html) Quick API 操作或 AWS CLI 命令。CLI 命令如下列範例所示。為您的身分提供者指定 AWS 區域 ，例如 `us-east-1`。 ``` awsacct1="111111111111" namespace="default" region="us-east-1" aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region ``` 下列範例會加入將結果限制為作用中使用者的查詢，以變更前一個命令。 ``` awsacct1="111111111111" namespace="default" region="us-east-1" aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region --query 'UserList[?Active==`true`]' ``` 得到的結果看起來類似以下範例。此範例摘自 JSON 輸出 (`--output json`)。擁有聯合身分使用者名稱的人員擁有以單字 `federated` 開頭的主體 ID。 ``` [ { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/anacasilva", "UserName": "anacarolinasilva", "Email": "anacasilva@example.com", "Role": "ADMIN", "Active": true, "PrincipalId": "federated/iam/AIDAJ64EIEIOPX5CEIEIO" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/Reader/liujie-stargate", "UserName": "Reader/liujie-stargate", "Role": "READER", "Active": true, "PrincipalId": "federated/iam/AROAIJSEIEIOMXTZEIEIO:liujie-stargate" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/embedding/cxoportal", "UserName": "embedding/cxoportal", "Email": "saanvisarkar@example.com", "Role": "AUTHOR", "Active": true, "PrincipalId": "federated/iam/AROAJTGEIEIOWB6BEIEIO:cxoportal" }, { "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/zhangwei@example.com", "UserName": "zhangwei@example.com", "Email": "zhangwei@example.com", "Role": "AUTHOR", "Active": true, "PrincipalId": "user/d-96123-example-id-1123" } ] ``` + 若要列出群組名稱，請加入資料欄，以識別包含 DDP 使用者名稱的群組。此欄應包含用於從您的身分提供者連線至 Quick 的系統群組名稱。若要識別您可以新增至資料集的群組，請使用下列一或多個快速 API 操作或 CLI 命令： + [ListGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroups.html) – 列出包含您的身分提供者之 的 AWS 帳戶 ID 和命名空間 AWS 區域 的快速群組。 + [ListGroupMemberships](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroupMemberships.html) – 列出指定 Quick 群組中的使用者。 + [ListUserGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUserGroups.html) – 列出 Quick 使用者所屬的 Quick 群組。 或者，您可以要求網路管理員查詢您的身分提供者以取得此資訊。 接下來的兩個程序會提供如何完成建立動態預設值之資料集的指示。第一個程序是為單值 DDP 建立資料集。第二個是為多值 DDP 建立資料集。 **若要建立單值 DDP 的資料集** 1. 使用單值參數建立資料集資料欄。查詢或檔案中的第一欄應適用於使用儀表板的人員。此欄位可以包含使用者名稱或群組名稱。不過， 群組的支援僅適用於 Quick Enterprise Edition。 1. 針對每個顯示單值參數動態預設值的欄位，將資料欄新增至資料集。資料欄的名稱並不重要，您可以使用與欄位或參數相同的名稱。 如果使用者實體和動態預設值的組合對該參數的欄位而言是唯一的，則單值參數才能正常運作。如果使用者實體的預設欄位有多個值，則該欄位的單一值控制項會改為顯示靜態預設值。如果未定義靜態預設值，則控制項不會顯示預設值。如果您使用群組名稱，則請務必小心，因為某些使用者名稱可能是多個群組的成員。如果這些群組具有不同的預設值，則此類型的使用者名稱會當做重複項目運作。 下列範例顯示包含兩個單值參數的資料表。我們這樣假設是因為沒有使用者名稱與多個預設值配對。為了使此表更易於理解，我們在分析中的字段名稱前面新增單字 `'default'`。因此，您可以透過下列陳述式、變更每個資料列的值來讀取資料表：由 `anacarolinasilva` 檢視時，控制項會顯示預設區域 `NorthEast` 與預設區段 `SMB`。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/parameters-default-values.html) 1. 將此資料匯入 Quick，並將其儲存為新資料集。 1. 在分析中，新增您建立的資料集。分析需要至少使用一個與您為預設值定義之資料欄相符的其他資料集。如需詳細資訊，請參閱[將資料集新增至分析](adding-a-data-set-to-an-analysis.md)。 **若要建立多值 DDP 的資料集** 1. 使用多值參數建立資料集資料欄。查詢或檔案中的第一欄應適用於使用儀表板的人員。此欄位可以包含使用者名稱或群組名稱。不過， 群組的支援僅適用於 Quick Enterprise Edition。 1. 針對每個顯示多值參數動態預設值的欄位，將資料欄新增至資料集。資料欄的名稱並不重要，您可以使用與欄位或參數相同的名稱。 與單值參數不同，多值參數允許在與參數相關聯的欄位中使用多個值。 下列範例顯示包含一個單值參數和一個多值參數的資料表。我們可以進行此假設，因為每個使用者名稱在一個資料欄中都有唯一的值，並且某些使用者名稱在另一資料欄中具有多個值。為了使此表更易於理解，我們在分析中的字段名稱前面新增單字 `'default'`。因此，您可以透過建立下列陳述式、變更每一列的值來讀取資料表：如果 `viewed-by` 是 `liujie`，控制項會顯示 `default-region` 的值 `SouthEast`，以及 `default-city` 的值 `Atlanta`。如果我們提前讀一列，就會看到，`liujie` 在 `default-city` 中還有 `Raleigh`。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/parameters-default-values.html) 在此範例中，無論是單值還是多值參數，我們套用 `default-region` 的參數都能正常運作。如果它是單值參數，則兩個項目適用於一個使用者，因為兩個項目有相同的值 `SouthEast`。如果它是多值參數，它仍然有效，除了預設情況下只選擇一個值。但是，如果我們將使用 `default-city` 作為其預設值的參數從多值變更為單值參數，則不會看到選取這些預設值。相反地，參數會使用靜態預設值 (如果有定義的話)。例如，如果靜態預設值設定為 `Atlanta`，則已在該控制項中為 `liujie` 選取 `Atlanta`，但未選取 `Raleigh`。 在某些情況下，您的靜態預設值也可能會用作動態預設值。如果是這樣，請務必測試使用者名稱的控制項，確保其不使用兩者皆可同時使用的預設值。 如果使用者名稱屬於多個群組，則具名使用者會看到一組預設值，這是兩個群組預設值的聯集。 1. 將此資料匯入 Quick，並將其儲存為新資料集。 1. 在分析中，新增您建立的資料集。分析需要至少使用一個與您為預設值定義之資料欄相符的其他資料集。如需詳細資訊，請參閱[將資料集新增至分析](adding-a-data-set-to-an-analysis.md)。 使用以下程序，將動態預設參數新增至分析。開始之前，請確定您有資料集，且其中包含每個使用者名稱或群組名稱的動態預設值。此外，請確定您的分析正在使用此資料集。如需這些需求的說明，請參閱前面的程序。 **若要將 DDP 新增至您的分析** 1. 在快速主控台中，選擇頁面頂端的**參數**圖示，然後選擇現有的參數。從參數選單中選擇**編輯參數**。若要新增參數，請選擇**參數**附近的加號 (`+`)。 1. 選擇 **Set a dynamic default (設定動態預設值)**。 1. 使用您的設定配置以下選項： + **Dataset with default values and user information** – 選擇您建立並新增至分析的資料集。 + **使用者名稱資料欄** – 若要建立以使用者名稱為基礎的預設值，請在資料集中選擇包含使用者名稱的資料欄。 + **群組名稱資料欄** – 若要建立以群組名稱為基礎的預設值，請在資料集中選擇包含群組名稱的資料欄。 + **適用於預設值的資料欄** – 選擇包含此參數預設值的資料欄。 1. 選擇**套用**以儲存設定變更，然後選擇**更新**以儲存參數變更。若要退出而不儲存變更，則請選擇**取消**。 1. 為每個包含動態預設值的欄位新增篩選條件，以使預設值正常運作。若要進一步了解如何使用篩選條件與參數搭配，請參閱 [在 Amazon Quick 中使用具有參數的篩選條件](parameters-filtering-by.md) Amazon Quick 會針對其使用者名稱不存在於資料集、未指派預設值，或沒有唯一預設值的任何人使用靜態預設值。每個人只能有一組預設值。若您不想使用動態預設值，則可以設定靜態預設值。 # 連線至 Amazon Quick 中的參數 在已設定參數之後，請使用本節來連接它並使其運作。 在建立參數之後，您可以建立參數的消費者。「參數使用者」**是使用參數值的元件，例如篩選條件、控制項、計算欄位或自訂動作。 您可以改採另一種方式導覽至上述各個選項，如下所示： + 若要建立篩選條件，請選擇頁面頂端的**篩選條件**圖示。簡言之，您將建立 **Custom Filter (自訂篩選條件)** 並啟用 **Use parameters (使用參數)**。清單中只會顯示合格的參數。 + 若要為 參數新增控制項，請選擇頁面頂端的**參數**圖示。簡言之，您將選擇所需參數，然後選擇 **Add control (新增控制項)**。 + 若要在計算欄位內使用參數，請編輯現有的計算欄位，或是選擇左上方的 **Add (新增)** 以進行新增。參數清單將顯示於欄位清單下方。 **注意** 多值參數不能用於計算欄位。 + 若要建立 URL 動作，請從視覺效果上選擇 **v** 形功能表，然後選擇 **URL Actions (URL 動作)**。 如需上述個別主題的詳細資訊，請參閱以下各節。 **Topics** + [使用篩選條件與參數搭配](parameters-filtering-by.md) + [使用計算欄位與參數搭配](parameters-calculated-fields.md) + [搭配參數使用自訂動作](parameters-custom-actions.md) + [URL 中的參數](parameters-in-a-url.md) + [標題和說明中的參數](parameters-in-titles.md) # 在 Amazon Quick 中使用具有參數的篩選條件 遵循本節所述步驟，依單一值參數值篩選分析或儀表板中的資料。若要使用多值參數，亦即搭配複選下拉清單控制項的參數，請建立等於 (或不等於) 其值的自訂篩選條件。 在使用篩選條件與參數搭配之前，您應該已經知道如何使用篩選條件。 1. 確認您的分析已建立參數。從參數或控制項的選單中選擇**編輯**，以了解正在使用哪些設定。 1. 從畫面左側選擇 **Filter (篩選條件)** 窗格。如果已有一個篩選條件用於您想要使用的欄位，請選擇它來開放其設定。否則，為您要依參數篩選的欄位建立一個篩選條件。 1. 選擇 **Use Parameters (使用參數)**。 1. 從 **Use parameters (使用參數)** 下方的一個或多個清單中選擇您的參數。對於文字 (字串) 欄位，先選擇 **Custom Filter (自訂篩選條件)**，然後啟用 **Use Parameters (使用參數)**。 對於日期欄位，選擇 **Start date (開始日期)** 和 **End date (結束日期)** 參數，如下列螢幕擷取畫面所示。 對於其有其他資料類型的欄位，選擇 **Select a parameter (選取參數)**，然後從清單中選擇您的參數。 **注意** 能夠容納多個值的參數必須使用等於或不等於做為比較類型。 1. 選擇 **Apply (套用)** 來儲存您的變更。 選擇分析頂部附近的控制項來測試您的新篩選條件。在此範例中，我們使用沒有預設值的基本參數，以及連結到**區域**欄位的動態控制項，而此欄位位於名為 **Sales Pipeline** 的範例資料集中。此控制項會查詢資料，傳回所有值。 如果刪除或重新建立您在篩選條件中使用的參數，則您可以使用新參數來更新篩選條件。若要這樣做，請開啟篩選條件、選擇您想要使用的新參數，然後選擇 **Apply (套用)**。 如果您重新命名參數，則不需要更新篩選條件或任何其他消費者。 # 在 Amazon Quick 中使用計算欄位搭配參數 您可以將參數值傳遞給分析中的計算欄位。當您建立計算時，您可以從 **Parameter list (參數清單)** 下的參數清單中選擇現有參數。您無法建立含有多值參數 (其將使用複選下拉式控制項) 的計算欄位。 對於公式，您可以使用任何可用的函數。您可以將檢視者的選擇從參數控制項傳遞給 `ifElse` 函數。之後，您會得到一個指標。下列顯示一個範例。 ``` ifelse( ${KPIMetric} = 'Sales',sum({Weighted Revenue}), ${KPIMetric} = 'Forecast',sum({Forecasted Monthly Revenue}), ${KPIMetric} = '# Active', distinct_count(ActiveItem), NULL ) ``` 上述範例會建立您可以在欄位中適當地使用的指標 (小數)。然後，當使用者從參數控制項中選擇一值時，視覺效果會更新以反映他們的選擇。 # 在 Amazon Quick 中使用具有參數的自訂動作 「自訂動作」**可讓您在視覺效果中選取一個資料點，或是從內容選單中選擇動作名稱，來啟動 URL 或篩選視覺效果。當您搭配參數使用 URL 動作時，您可以傳遞或動態傳送參數至 URL。若要使此作業運作，您可以設定參數，然後在您使用 **URL action (URL 動作)** 動作類型建立自訂動作時，在 URL 中使用該參數。傳送端和接收端上的參數必須具有相符的名稱和資料類型。所有參數都與 URL 動作相容。 如需建立 URL 動作的詳細資訊，請參閱 [在 Amazon Quick Sight 中建立和編輯自訂動作](custom-actions.md)。如果您只想要在連結中使用參數，而不建立 URL 動作，請參閱[在 URL 中使用參數](parameters-in-a-url.md)。 # 在 URL 中使用參數 您可以在 Amazon Quick 的 URL 中使用參數名稱和值，在儀表板或分析中設定該參數的預設值。 以下範例顯示由某個儀表板的 URL 為另一個儀表板設定參數。 ``` https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.myParameter=12345 ``` 在上述範例中，第一個部分是目標儀表板的連結：`https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234`。井字號 (`#)` 接在第一部分後面，以引進*片段*，其中包含您想要設定的數值。 AWS 伺服器不會接收或記錄片段中的值。此功能可讓您的資料值更為安全。 `#` 之後的片段遵循下列規則： + 參數的字首為 `p.`。其名稱是參數名稱，而非控制項名稱。您可透過開啟分析並由左側列選擇 **Parameter (參數)** 以檢視參數名稱。 + 值是使用等號 (`=`) 進行設定。適用的規定如下： + 常值不會使用引號。 + 數值內的空格將由瀏覽器自動進行編碼，所以您手動建立 URL 時無須使用逸出字元。 + 若要傳回全部的值，請將參數設為等於 `"[ALL]"`。 + 若要將參數的值指派給 `null`，請將它設為等於 `%00`。例如 `p.population=%00`。 + 在自訂動作中，目標參數名稱會以 `$` 開頭，例如：`<<$passThroughParameter>>` + 在自訂動作中，參數值會伴隨角括弧 `<< >>` 顯示，例如 `<>`)。儀表板使用者將看到查詢值而不是變數。 + 對於自訂 URL 動作，多值參數在片段中同一參數只需要一個執行個體，例如：`p.city=<<$city>>` + 對於導向 URL，單一參數的多個值在片段中同一參數會有兩個執行個體。如需範例，請參閱下文。 + `&` 符號可區隔多個參數。如需範例，請參閱下文。 伺服器會將日期轉換成 UTC 並以無時區的字串形式傳送至後端。若要使用國際標準時間 (UTC) 日期，請排除時區。以下是一些可以運作的日期格式範例： + `2017-05-29T00%3A00%3A00` + `2018-04-04 14:51 -08:00` + `Wed Apr 04 2018 22:51 GMT+0000` ``` https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30 08:01&p.city=New York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3 ``` 在瀏覽器中，此程式碼會變成下列程式碼。 ``` https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30%2008:01&p.city=New%20York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3 ``` 上述範例設定四個參數： + `shipDate` 是日期參數：`Sept 30, 2018`。 + `city` 是多值字串參數：`New York` 和 `Seattle` + `teamMember` 是整數參數：`12`。 + `percentageRank` 是小數參數：`2.3`。 以下範例示範如何為接受多個值的參數設定其值。 ``` https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.MultiParam=WA&p.MultiParam=OR&p.MultiParam=CA ``` 若要根據使用者所選資料點，將數值從某個儀表板 (或分析) 傳遞至另一儀表板，請使用自訂 URL 動作。您也可選擇手動產生這類 URL，並將其用於共享特定的資料檢視。 如需建立自訂動作的資訊，請參閱 [使用自訂動作進行篩選和導覽](quicksight-actions.md)。 # 在 Amazon Quick 的標題和描述中使用參數 當您在 Amazon Quick 中建立參數時，您可以在圖表和分析的標題和描述中使用它們，以動態顯示參數值。 您可以在分析的下列區域中使用參數： + 圖表標題和字幕 + 軸標題 + 圖例標題 + 參數控制項標題 + 工作表標題和說明 下圖顯示使用參數的圖表標題。 ![\[「格式化視覺化效果」窗格的影像，其中包含圖表標題中的參數，以及標題中的參數值以紅色圈出的圖表。\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/images/parameters-in-titles-labels2.png) 使用下列程序來了解如何在整個分析中將參數加入至區域。如需參數及其建立方式的詳細資訊，請參閱 [Parameters](parameters-in-quicksight.md)。 ## 為圖表標題和字幕新增參數 請使用下列程序來了解如何將參數新增至圖表標題和字幕。 **若要將參數新增至圖表標題或字幕** 1. 為您要格式化的視覺效果開啟**屬性**窗格。 1. 在**屬性**窗格中，選擇**標題**索引標籤。 1. 選擇**顯示標題**或**顯示字幕**。這些選項可能已經被選取。 1. 在**編輯標題**或**編輯字幕**右側選擇三個點，然後從清單中選擇一個參數。 參數會新增至**屬性**窗格中的標題。在圖表中，參數值會顯示在標題中。 如需在視覺效果中編輯標題和字幕的詳細資訊，請參閱 [Quick 中視覺效果類型的標題和字幕](customizing-a-visual-title.md)。 ## 將參數新增到軸標題 使用以下程序，了解如何將參數新增到軸標題。 **若要將參數加入至軸標題** 1. 為您要格式化的視覺效果開啟**屬性**窗格。 1. 在**屬性**窗格中，選擇您要格式化的軸。 1. 選取**顯示標題**。 1. 選擇預設軸標題右側的三個點，然後從清單中選擇參數。 參數會新增至**屬性**窗格中的軸標題。在圖表中，參數值會顯示在軸標題中。 如需編輯軸標題的詳細資訊，請參閱 [軸和網格線](showing-hiding-axis-grid-tick.md)。 ## 將參數新增到圖例標題 使用以下程序，了解如何將參數新增到圖例標題。 **若要將參數加入至圖例標題** 1. 為您要格式化的視覺效果開啟**屬性**窗格。 1. 在**屬性**窗格中選擇**圖例**。 1. 選取**顯示圖例標題**。 1. 選擇**圖例標題**右側的三個點，然後從清單中選擇參數。 參數會新增至**屬性**窗格中的圖例標題。在圖表中，參數值會顯示在圖例標題中。 如需格式化這些圖例的詳細資訊，請參閱 [Quick 中視覺效果類型的圖例](customizing-visual-legend.md)。 ## 將參數新增到控制項標題 使用下列程序來了解如何將參數新增至參數控制項標題。 **若要將參數新增至參數控制項標題** 1. 選取您要編輯的參數控制項，選擇參數控制項標題右側的三個點，然後選擇**編輯**。 1. 在開啟的**編輯控制項**頁面中，選取**顯示標題**。 1. 選擇**顯示名稱**右側的三個點，然後從清單中選擇參數。 參數會加入至參數控制項標題。 如需使用參數控制項的詳細資訊，請參閱 [參數控制項](parameters-controls.md)。 ## 將參數加入到工作表標題和描述 使用下列程序來了解如何將參數加入到分析中的工作表標題和描述。 **若要將參數加入到工作表標題或描述** 1. 在分析頁面，選擇應用程式列中的**工作表**，然後選擇**新增標題**或**新增描述**。 工作表標題或描述將顯示在工作表上。 1. 對於**表標題**或**描述**，請選擇右側的三個點，然後從清單中選擇參數。 參數會加入到工作表標題或描述中，當您關閉文字方塊時，參數值會顯示在文字中。 如需新增工作表標題與描述的詳細資訊，請參閱 [新增分析的標題和描述](adding-a-title-and-description.md)。