本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 在 Amazon Quick 中使用带有参数的控件
参数控件

在控制面板中，参数控件显示在数据表顶部，该表包含一组视觉对象。通过提供一个控件，可以允许用户选择要在预定义的筛选条件或 URL 操作中使用的值。控制面板用户可以使用控件在控制面板上的所有视觉对象数据集中应用筛选，不必自行创建筛选条件。

以下规则适用：
+ 要创建或编辑参数的控件，请确保该参数存在。
+ 多选列表控件与分析 URLs、仪表板 URLs、自定义操作和自定义筛选器兼容。筛选条件必须等于或不等于提供的值。不支持其他比较。
+ 列表最多显示 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 中快速格式化](formatting-a-visual.md)。
+ **Delete（删除）**，用于删除控件。您可以通过选择参数上下文菜单来重新创建它。

在工作区中，您还可以调整控件的大小和重新整理控件。控制面板用户在您执行这些操作时可以看到控件，只不过不能编辑或删除控件。