---
order: 4
navTitle: 如何手动查询页面数据
---
# 如何手动查询页面数据

通常数据的条件发生变化后，系统会自动刷新页面的数据。但是有些场景下希望条件修改后，需要手动点击查询按钮后才刷新数据。比如当一个页面顶部有多个过滤筛选条件时，希望把多个条件设置好后再执行查询数据，而不是每次修改一个条件，系统就自动查询数据，这样也可以避免系统发起不必要的查询请求。

下面分别介绍在[报表手动查询](#report-forms)、[仪表板手动查询](#instrument-panel)中，如何手动查询页面数据。

## 报表手动查询{#report-forms}

报表可以在参数栏的属性中控制修改参数时不查询数据，同时再配合查询按钮来实现手动刷新页面数据，给按钮添加查询交互来实现手动查询页面数据，此处以**各地区销售情况表**为例手动查询页面数据。

![手动查询页面数据](./images/2024-01-16-00-00-02.gif)

[点击此处体验](https://demo.succbi.com/v5/bi/%E6%89%8B%E5%8A%A8%E6%9F%A5%E8%AF%A2%E9%A1%B5%E9%9D%A2%E6%95%B0%E6%8D%AE)

实现报表手动查询的具体操作步骤如下：

1. 勾选下拉框的‘自动过滤’属性，点击**查询日期**>**数据**>**自动过滤**，**大区**设置同**查询日期**的设置，可以设置**查询日期**与**大区**的默认值

2. 点击**参数栏**>**高级**>勾选>**初始化查询**，启用初始化查询后，修改参数时查询默认不勾选

3. 给**查询**按钮设置交互，点击**查询**>**交互**>添加>**查询**，保存后点击查询按钮进行页面数据手动查询

![报表手动查询](./images/2024-01-16-00-00-01.gif)

## 仪表板手动查询{#instrument-panel}

仪表板手动查询页面数据主要有2种方式：

- [通过刷新数据交互手动刷新](#interactive)：通过设置数据刷新交互控制手动查询，过滤组件去掉自动过滤。
- [通过交互手动传递过滤条件](#parameters)：设置参数对数据进行手动查询，参数设置方法参考[设置参数](../dash/design/data/param.md#settings)，用参数来隔离过滤组件，数据集上使用参数过滤，过滤组件的值修改后，通过按钮将过滤组件的值设置到数据集的过滤参数上过滤。

![仪表板手动查询](./images/2024-01-16-00-00-05.png)

[点击此处体验](https://demo.succbi.com/v5/bi/%E6%89%8B%E5%8A%A8%E6%9F%A5%E8%AF%A2%E9%A1%B5%E9%9D%A2%E6%95%B0%E6%8D%AE_1)

### 通过刷新数据交互手动刷新{#interactive}

将过滤条件全部采用全局参数控制实现手动查询页面数据具体步骤如下：

1. **查询日期**和**大区**下拉框取消勾选`自动过滤`，下拉框>**过滤**>**自动过滤**

2. 明细表所在的数据源勾选`手动刷新`与`初始时不查询`，**门店销售明细表**>右键设置>**查询**，勾选`手动刷新`与`初始时不查询`

3. 明细表所在的数据源添加过滤条件，依据下拉框选项进行过滤，**门店销售明细表**>右键设置>**过滤**

4. 给查询按钮设置交互，点击按钮添加**刷新数据**交互，具体设置参考[设置交互](https://docs.succapp.com/v5/rpt/action/invoke-component-method)

![刷新数据](./images/2024-01-19-10-06-00.gif)

### 通过交互手动传递过滤条件{#parameters}

通过交互手动传递过滤条件具体操作如下：

1. 设置**参数**，添加**cxrq**和**dq**两个参数，无需设置默认值

2. **查询日期**和**大区**下拉框取消勾选`自动过滤`，下拉框>**过滤**>**自动过滤**

3. 设置数据集**过滤**条件，**门店销售明细表**>右键设置>**过滤**，添加**cxrq**和**dq**参数的过滤条件

4. 设置数据集**查询**条件，**门店销售明细表**>右键设置>**查询**，取消勾选**手动刷新**和**初始时不查询**

5. 给查询按钮设置交互，点击按钮添加**设置参数值**交互

![参数交互](./images/2024-01-19-10-21-00.gif)