# 创建按钮

您可使用按钮来：

* 添加快速链接以便利地进行选择并在您的应用程序中导航

* 重新加载数据

您可以在正在编辑的工作表上创建按钮。这显示了如何创建进行选择的按钮然后导航至另一工作表。还可创建直接执行操作或进行导航的按钮。

执行以下操作：

1. 在资产面板中，打开图表并在仪表板对象下，将按钮对象拖动到工作表。

2. 在属性面板的操作下，单击添加操作。

3. 选择您要使用的操作。

   对于某些操作，您需要提供操作的详细信息。例如，对于选择字段中的值操作，您需要选择字段，以及确定在字段中选择哪个值。

4. 在导航下选择要使用哪个导航选项。您可以导航到另一个工作表、故事或网站。

5. 在属性面板中在 常规 下的 标签 中设置按钮的标签。

您现在将拥有一个按钮，该按钮可进行数据选择，然后导航到您在应用程序中选择的位置。

## 设置操作

您可添加要在单击按钮时执行的一个或多个操作。对于某些操作，您需要提供操作的详细信息。

以在 操作 下列出操作的顺序执行操作。您可拖动操作更改操作的顺序。

打开或关闭运行时计算以更改按钮中表达式的计算时间。如果禁用此设置，则按钮中的表达式（例如，变量的值表达式）将相互独立地计算。启用该设置后，每个操作的表达式都将在操作的运行时进行计算。这允许将在操作中设置的表达式值继续用于将来的操作。

提示注释如果您只希望按钮执行导航，则不必添加操作。

### 相关视频内容

为按钮配置操作类似于设置工作表操作。主要差异在于：

* 当工作表是焦点对象时，在“属性”面板的操作下配置工作表操作。

* 选择按钮时，在属性面板的操作和导航下配置按钮操作。

* 按钮和工作表可用的操作之间存在一些差异。

有关描述工作表操作配置的视频内容，请参阅[向工作表添加操作](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Sheets/setting-sheet-actions.htm)。

### 应用书签

您可应用在您所选的书签中定义的选择。

### 清除所有选择项

您可以清除应用程序中所有状态下的所有选择。您可选择性覆盖锁定的选择。

### 清除其它字段中的选择项

您可从除了您指定的字段之外的所有字段清除选择。您可选择性覆盖锁定的选择。

如果未在指定字段中进行任何选择，则会选择此字段中的所有值。

### 在您的选择项中向前移动

您可在选择历史记录中向前移动一步。

### 在您的选择项中向后移动

您可在选择历史记录中向后移动一步。

### 清除字段中的选择项

您可从您指定的字段清除所有选择。

### 锁定所有选择项

您可锁定应用程序中的所有选择。

### 锁定特定字段

您可从您指定的字段锁定选择。

### 将所有选择项解锁

您可解锁应用程序中的所有选择。

### 将特定字段解锁

您可从您指定的字段解锁选择。

### 选择字段中的所有值

您可选择您指定的字段中的所有值。您可选择性覆盖锁定的选择。

### 选择字段中的值

您可从您指定的字段选择一系列值。以逗号分隔要选择的值。您可选择性覆盖锁定的选择。

信息注释不能使用具有日期、时间戳或货币数据类型的字段。

信息注释此按钮操作不会选择存储或分类为文本的数值。为此，请改用操作选择匹配搜索条件的值。

### 选择与搜索条件匹配的值

可以从您指定的搜索条件中选择与搜索结果匹配的所有值。您需要将搜索条件指定为字符串。您可选择性覆盖锁定的选择。

* 如果要使用表达式，需要用单引号将其括起来，例如 ='=Sum([Sales Amount]) > 200000'。
* 如果要搜索部分字符串，则需要使用通配符 (\*, ?,^)。如果不使用通配符，则只选择完全匹配的字符串。

### 选择替代项

选择您指定的字段中的所有替代值。您可选择性覆盖锁定的选择。

### 步骤循环维度

向前或向后循环选定循环维度中的字段。

#### 限制

步骤循环维度存在以下限制：

* 在 Qlik Analytics 移动应用程序中，具有操作 步骤循环维度 的按钮将仅在按钮位于容器中时循环维度。

* 在 Qlik Analytics 移动应用程序中，具有操作 步骤循环维度 的按钮不会在脱机模式下循环维度。

[Adding step cyclic dimensions to button](https://play.vidyard.com/t2UCwyGFhDr2CHZc1L1Zp5)

### 设定激活字段

设定循环维度中的激活字段。

#### 限制

设定激活字段字段有以下限制：

* 设定激活字段使用所选字段在循环维度中的位置。如果字段在循环维度中重新排序，则设定激活字段将使用与初始选择的字段处于相同位置的字段。要解决此问题，请在按钮属性中再次选择字段。

### 选择排除值

选择您指定的字段中的所有排除值。您可选择性覆盖锁定的选择。

### 选择字段中的可能值

选择您指定的字段中的所有可能值。您可选择性覆盖锁定的选择。

### 切换字段选择

您可设定按钮以在当前选择项和添加通过搜索字符串定义的选择之间切换。您可在搜索字符串中使用通配符。如果您希望定义需要使用格式 (A|B) 的一系列值（其中 A 和 B 是要选择的值）。

### 设置变量值

您可将值分配至变量。

### 重新加载数据

可以运行加载脚本来重新加载数据。

您还可选择部分重新加载。有关更多信息，请参阅[部分加载](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptPrefixes/PartialReload.htm)。

### 刷新动态视图

根据当前选择刷新工作表上所有动态对象的显示。

### 执行信息

您可以从工作表上的按钮运行使用 Qlik Automate 创建的自动化。您可以在应用程序中包括所做的选择，并向自动化传递额外的输入值。要了解更多信息，请参阅[Qlik Automate](https://alphahelp.qliktech.com/ld/en-US/cloud-services/Subsystems/Hub/Content/Sense_QlikAutomation/introduction/home-automation.htm)。

#### 推荐方法：共享的空间

将自动化放置在共享空间中，并授予用户编辑权限。具有编辑权限的用户可以执行自动化，而无需修改它们。

这种方法有重要的优点：

* 用户使用他们自己的令牌进行身份验证，而不是静态执行令牌。这意味着他们必须登录到 Qlik Cloud。
* 自动化使用用户的ID运行，因此您可以审计是谁触发了它。
* 只有自动化所有者可以编辑它，无论空间角色如何。

您还可以：

* 选择 包括选择 以将当前应用程序选择传递给自动化。
* 通过为每个参数定义键和值，添加用于自动化特定值的输入参数。
* 单击复制输入块以将生成的输入结构复制到您的自动化中。

#### 替代方法：触发模式

如果共享空间设置不符合您的用例，您可以使用运行模式：触发来代替。使用此模式，任何有权访问工作表的用户都可以运行自动化，无论他们是否直接拥有其访问权限。

请注意以下限制和风险：

* 任何有权访问工作表和按钮的人都可以运行自动化。

* 单击该按钮时，执行令牌在浏览器网络流量中可见。

* 自动化运行时使用所有者的凭据，而不是用户的凭据。

* 对于使用区域权限的应用程序，这可能会暴露单击用户在区域权限规则下通常不允许访问的数据。

* 此令牌可用于从外部调用该自动化 Qlik Cloud。

* 可变自动化 ID 无法使用，因为在编辑器中需要交互式用户会话才能更新按钮对象定义中的执行令牌。

#### 配置执行自动化

执行以下操作：

1. 在属性面板的操作和导航下，单击添加操作。

2. 在操作下，选择执行自动化。

3. 在自动化下，选择要作为操作触发的自动化。

   可用的自动化功能会出现在下拉菜单中。

4. 选择包含选择项框。

   选择该选项时，按钮会为当前选择创建书签。包含以下输入：

   * 应用程序 ID

   * 书签 ID

   * 工作表 ID

   * 用户 ID

   * 空间 ID

   * 租户 ID

   * 时间

   应用程序 ID 和书签 ID 用作自动化的输入，它们用于在执行自动化时应用数据选择。

5. 或者，如果共享空间不适用，并且您希望任何有权访问工作表的用户能够运行自动化，请选择运行模式：触发。

   您还必须是自动化的所有者才能配置此选项。在使用此模式之前，请参阅上文中的安全注意事项。

6. 如果您的自动化需要执行参数，请执行以下操作：

   1. 单击添加输入参数。

   2. 在键下输入参数 ID。

   3. 在值下，输入要使用的值。

   4. 对所需的任何其他参数重复上述步骤。

7. （可选）要在自动化中为按钮粘贴输入块，请单击复制输入块。

   当粘贴到您的自动化中时，它将按钮信息作为输入块传递。

通过[主动智能教程](https://help.qlik.com/en-US/cloud-services/Subsystems/ApplicationAutomation/Content/tutorials/active-intelligence.htm) （仅提供英文版本）了解如何将按钮连接到自动化。

#### 执行自动化限制

执行自动化存在以下限制：

* 在自动化下最多可以显示 100 个自动化供选择。如果您可以访问 100 多个自动化，但找不到所需的自动化，则可以使用自动化 ID。自动化 ID 在段中，位于 URL中 /edit 或 /history之前的 /editor/ 之后。

  例如，在 qlik.com/automations/editor/6c201b49-cz2e-00dc-8040-464ca41457b0/edit?resourceName=Active%20Intelligence 中，自动化 ID 为 6c201b49-cz2e-00dc-8040-464ca41457b0。

* Qlik Sense Mobile 中不支持使用执行自动化的按钮。

* 当使用执行自动化来运行包含 Qlik 报告块的自动化时，选择不会传递到自动化中的报告。Qlik Automate 的会话状态无法转移到传递给 Qlik 报告服务 的报表组合定义。因此，报告组成和数据将不会反映所做的选择。

  警告注释对于使用部分访问的应用程序，使用自动化所有者的凭据而不是触发报告的用户来运行自动化报告。这可能会暴露用户在应用程序区域权限规则中无法访问的数据。

* 嵌入式按钮不支持执行自动化。

* 如果按钮触发的自动化运行时间超过 10 分钟，则在自动化完成时不会发送通知。

## 导航

当单击按钮时，您可以选择导航到另一个工作表、故事或网站。如果您希望创建简单的导航按钮，则不必指定操作。一个按钮一次只能有一个导航选项。

信息注释在故事中不支持导航。

### 转至下个工作表

按顺序导航到下一个工作表。

### 转到前一个工作表

按顺序导航到上一个工作表。

### 转到最后一个工作表

导航至最后一个工作表。

### 转到第一个工作表

导航至第一个工作表。

### 转至工作表

导航到特定的工作表，并可以选择高亮显示工作表上的特定图表。

在工作表下，输入所需工作表的名称或从列表中选择该工作表。在图表 ID 下，输入图表的对象 ID 或从列表中选择所需的图表。

提示注释

可以使用以下任一方法获取对象 ID：

* 在分析模式下，右键单击可视化或工作表，然后单击the 共享 icon > the 嵌入 icon 。然后您可以在对话框中找到对象 ID。

* 对于某些图表类型，可以使用 ObjectId 图表函数。例如，将 `=ObjectId()` 作为维度与任何度量一起添加。此时会显示图表 ID，您可以将其写下来以供将来参考。有关详细信息，请参阅 [ObjectId - 图表函数](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/SystemFunctions/ObjectId.htm).

信息注释如果使用表达式，则表达式应解析为工作表 ID。

### 转到通过工作表 ID 定义的工作表

导航到特定工作表 。输入所需工作表的工作表 ID。您可在工作表打开的情况下，查找浏览器 URL 中工作表的 ID。工作表 ID 在 `/sheet/` 后面，后接 `/`。

示例： 工作表 URL

```
qlik.com/sense/app/8f8ffa0e-3fde-48a5-a127-59645923a1fc/sheet/7300b241-f221-43db-bb8b-8c8cc1887531/state/analysis
```

此例中工作表的 ID 是 `7300b241-f221-43db-bb8b-8c8cc1887531`。

信息注释如果使用表达式，则表达式应解析为工作表 ID。

### 转到故事

导航到特定故事 。输入所需故事的名称，或从列表中选择。

### 打开网站或电子邮件

打开指定的网站或电子邮件客户端。输入要导航到的 URL。或者，选择在同一窗口中打开，使网站或电子邮件客户端在同一窗口中打开。

### 生成 On-demand 应用程序

根据当前选择项创建 On-demand 应用程序。您必须选择一个 On-demand 应用程序导航链接（请参阅[构建按需应用程序](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/creating-OnDemand-app.htm)）。应用程序的状态在创建时显示。

### 应用程序链接

您可以在应用当前选择的情况下打开另一个现有应用程序。通过应用程序 ID 指定要打开的应用程序。或者，您可以指定一个逐个工作表 ID，以及是否希望在同一窗口中打开新应用程序。

信息注释在 Qlik Analytics 移动应用程序中，应用程序始终在同一窗口中打开。

## 设定按钮样式

在属性面板中的外观下有大量样式设定按钮可供您使用。

单击外观>演示文稿下的the 样式 icon以进一步自定义图表的样式。样式面板包含常规和图表选项卡下的各个部分。

您可以通过单击每个部分旁的 ![重置](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/Icons/reset.svg) 重置样式。单击 ![重置](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/Icons/reset.svg) 全部重置可重置样式面板中所有可用标签的样式。

有关设置单个可视化样式的常规信息，请参见[将自定义样式应用于可视化](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/style-visualization.htm)。

### 添加图标

您可以向外观 > 图标下的按钮添加图标。从多个预设选项中进行选择。

### 自定义文本

可以在外观 > 常规下设置标题、副标题和脚注的文本。若要隐藏这些元素，请将显示标题设置切换为关闭。

此外，您还可以设置标签按钮的文本。

您可以设置图表中显示的文本的样式。

执行以下操作：

1. 在外观 > 展示下，单击the 样式 icon 。

2. 在常规选项卡上，设置以下文本元素的字体、强调样式、字体大小和颜色：

   * 标题

   * 副标题

   * 脚注

3. 在图表选项卡上，设置标签按钮的文本属性。设置字体、强调样式、文本对齐方式、字体大小和颜色。

   您也可以在布局行为下从该标签的多个文本布局选项中进行选择。有以下选项可用：

   * 响应式：您可以调整标签的字体大小，并根据按钮大小和文本长度进行额外的文本大小调整。将进行调整以使所有文本内容都适合按钮。

   * 流式：您可以调整标签的字体大小，并仅根据按钮大小进行额外的文本大小调整。这种文本的重新缩放与文本长度无关。如果文本太长，则在末尾插入省略号。

   * 固定式：您可以调整标签的字体大小（以像素为单位）。如果文本太长，则在末尾插入省略号。

### 自定义背景

您可以自定义一般背景，以及按钮本身的背景。可以通过颜色和图像来设置每项的背景。可以通过展开属性面板中的外观 > 演示，然后单击 the 样式 icon 来配置背景选项。

#### 设置一般背景

按钮的一般背景包括标题区域以及图表本身，图表本身可能部分被按钮本身覆盖。

执行以下操作：

1. 在属性面板中，展开外观部分。

2. 在外观 > 展示下，单击 the 样式 icon 。

3. 在样式面板的一般选项卡上，您可以选择背景颜色（单色或表达式）。您也可将背景设置为媒体库或 URL 中的图像。

   信息注释

   要从 URL 添加背景图像，需要将 URL 的来源添加到租户的内容安全策略中的允许列表中。源必须添加以下指令：img-src。这是由租户管理员完成的。

   有关更多信息，请参阅[创建 CSP 条目](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-content-security-policy.htm#AddEntry)。

   使用背景色时，请使用滑块调整背景的不透明度。

   使用背景图像时，可以调整图像大小和位置。

#### 设置按钮的背景

按钮的背景包括用户可以单击以执行操作的部分。

执行以下操作：

1. 在属性面板中，展开外观部分。

2. 在外观 > 展示下，单击 the 样式 icon 。

3. 在样式面板的图表选项卡上，您可以选择背景颜色（单色或表达式），并且也可将背景设置为媒体库中的图像。

   使用背景图像时，可以调整图像大小和位置。

### 调整按钮交互式部分的边框

您可以调整与用户交互的按钮部分的边框，以执行预期的操作。

执行以下操作：

1. 在外观 > 展示下，单击the 样式 icon。

2. 在图表选项卡的边框下，将边框切换为打开以将其显示在按钮上。

3. 调整拐角半径和宽度。

4. 设置边框的颜色，可以是单一颜色，也可以使用表达式来设置。

### 自定义整个对象的边框和阴影

可以自定义按钮所在的整个对象的边框和阴影。请注意，您也可以调整可点击按钮本身的边框。

执行以下操作：

1. 在属性面板中，展开外观部分。

2. 在外观 > 展示下，单击 the 样式 icon。

3. 在样式面板的常规选项卡上的边框下，调整轮廓大小以增加或减少图表周围的边框线。

4. 选择边框的颜色。

5. 调整拐角半径以控制边框的圆度。

6. 在常规选项卡的阴影下，选择阴影大小和颜色。选择无以移除阴影。

## 禁用和启用按钮

在启用图表下，您可以设置一个计算条件来启用图表。如果将条件计算为 0，则会禁用按钮。

## 在 Button for navigation 中从 Dashboard bundle 转换

您可将现有 Button for navigation 控件转换成按钮。在您进行转换时，存在一些限制。

* 不支持切换到编辑模式（Switch to edit mode）的导航选项。
* 不支持选择值然后锁定字段（Select a value and lock field）的操作。这将转换为两个连续的操作，选择字段中的值并锁定特定字段。