参数

通过参数，您可以与用户提供的数据进行互动。例如，您可以创建包含报告使用者的输入的计算字段，也可以将值传递回数据源使用的 SQL 查询。使用参数可让报告更具互动性。您还可以使用参数创建报告模板。

参数的运作方式

参数的作用类似于编程语言中的变量。参数主要有以下三种用途：

  • 您可以在计算字段中使用参数来显示基于用户输入的结果。
  • 您可以将参数传递回 BigQuery 数据源中的自定义 SQL 查询。
  • 您可以将参数传递回社区连接器。

形参可以从以下位置获取数据：

  • 从为参数定义的默认值
  • 通过组件属性面板
  • 从放置在报告中的控件
  • 通过报告链接

您可以在报告编辑器和数据源编辑器的字段列表底部找到参数。参数显示为紫色字段。

参数如何在报告中共享您的数据

报告和数据源的编辑者可以访问由参数控制的任何数据。借助参数，报告编辑者可以请求与默认数据不同的数据。

在为数据源启用参数之前，请务必了解参数值的更改可能会对报告中的数据产生怎样的影响。某些参数可能只会返回相对“安全”的数据，例如新语言区域的天气。不过，其他参数可能会允许用户请求全新的数据集。

例如，账号参数或数据库表的名称可能会返回您不打算分享的数据。这两者都可能会返回不同的架构，而这些架构可能与报告中的现有图表不兼容。

创建参数

您可以在以下位置创建参数：

在数据源中

  1. 修改数据源。
  2. 点击右上角的添加参数。 您还可以在修改报告时创建参数，方法是选择一个组件，然后点击右下角的添加参数。请务必根据所需的数据源选择相应组件。
  3. 配置参数的选项和默认值（请参见下文）。

在修改报告时，您可以使用数据面板中的 + 添加参数链接在所选数据源中创建参数。

在 BigQuery 连接器中

您可以在 BigQuery 连接器中将参数传递给自定义 SQL 查询。BigQuery 连接器定义了多个标准参数，用于传递报告的开始日期和结束日期，以及用户的电子邮件地址（如果有）。您还可以传递自定义参数。了解详情。

参数和社区连接器

社区连接器可以包含可替换参数，以便报告编辑者修改数据源中的默认值。如果您可以修改使用社区连接器构建的数据源的连接，则可以指定报告编辑者可以更改哪些参数：

  1. 修改数据源。
  2. 点击左上角的修改关联。
  3. 如果连接器提供可修改的参数，这些参数会显示在页面底部。允许您定义自定义参数的连接器会在页面上提供相关说明。
  4. 使用允许在报告中修改 <参数名称> 复选框允许或禁止在报告中修改相应参数。
  5. 点击右上角的重新连接。

使用社区连接器创建数据源后，该连接器中的参数更改不会自动显示在数据源中。您需要重新连接数据源，才能看到任何新增、移除或更改的参数

修改现有参数

如需更改现有参数的配置，请执行以下操作：

  1. 修改包含相应形参的数据源。
  2. 在字段列表中找到相应参数。
  3. 点击形参名称右侧的 @ 符号。
  4. 进行所需更改，然后点击右下角的保存。

配置参数

使用这些选项可配置数据源中的参数。如需了解 BigQuery 连接器和社区连接器参数，请参阅上文提及的文章。

参数名称：您会在报告和数据源的字段列表中看到此名称。您还可以在计算字段中使用此名称来引用相应参数。

参数 ID：默认设置。参数 ID 由 Looker Studio 在内部用于标识参数。报告查看者看不到此内容。

数据类型：参数可以存储文本、数字或布尔值（true/false）。

允许的值：指定用户可以输入的值。

如需指定值列表，请选择相应选项，然后输入可接受的值以及可选的显示名称。点击添加选项可向列表中添加更多内容。

如需指定允许的值范围，请输入该范围的最小值和最大值。

默认值：为参数指定一个起始值。

设置参数值

您可以通过以下方式设置参数的值：

为参数设置默认值

您可以在创建参数时为其设置默认值。如需调整默认值，请按照上述步骤修改相应参数。

使用控件获取用户输入

控件是允许用户与报告互动的组件。如需将用户输入内容存储在参数中，请将相应参数添加到控件的控制字段属性中：

  1. 修改报告。
  2. 点击顶部的 控制图标。 添加控制项。
  3. 选择要添加的控件类型。
  4. 在属性面板中，选择设置标签页。
  5. 将参数添加到控制字段。

详细了解控件。

替换组件中的默认参数值

您可以通过修改报告中的各个组件来替换参数的默认值：

  1. 修改报告。
  2. 选择基于包含参数的数据源的组件。
  3. 在组件的“数据”标签页底部，修改默认参数值。

您还可以在报告和网页级修改参数：

  1. 修改报告。
  2. 依次选择文件 > 报告设置或页面 > 当前页面设置。
  3. 修改参数值。

参数继承

参数遵循与过滤条件属性相同的继承规则。具体而言，优先级较高的组件上的参数会替换优先级较低的组件上的参数。优先级顺序（从最低到最高）如下：

  1. 数据源（默认）
  2. 举报
  3. 页面
  4. 群组
  5. 单个图表或控件

通过报告的网址设置参数可让开发者和高级用户构建可通过程序进行配置的报告。

Looker Studio 报告参数及其对应的值以网址编码的 JSON 字符串形式传递，并使用“params”查询参数附加到报告网址。

如需了解详情，请参阅开发者指南。

管理报告参数

默认情况下，您无法通过报告网址修改报告中的参数。

如需选择允许报告用户修改哪些参数，请执行以下操作：

  1. 修改报告。
  2. 依次选择资源 > 管理变量（参数）。
  3. 在允许在报告网址中修改列中，选中您要允许的参数。

此页面还会显示每个参数的网址参数。这是您在构建编码后的参数对象时将使用的名称，而不是参数名称。您可以点击修改铅笔图标来修改此名称。报告中的每个网址参数都必须是唯一的。

修改网址参数名称不会影响该参数在报告中的使用方式。

使用参数

创建参数后，您可以在计算字段和报告组件中使用参数，就像使用维度和指标一样。

在计算字段中使用参数

您可以使用参数，就像在计算字段中使用维度或指标一样。

包含参数的计算字段。点击即可展开。

例如，假设您想直观呈现预测的销售额，并允许用户输入上个季度的销售额倍数。

首先，创建用于保存预测乘数的形参：

  1. 登录 Looker Studio。
  2. 修改数据源。
  3. 点击右上角的添加参数。
  4. 为参数命名（例如“预测乘数”）。
  5. 将数据类型设置为数字。
  6. 为简单起见，请将允许的值选项设置为任意值。

    您可以使用其他选项让用户从值列表中进行选择，也可以将用户的输入限制在一定的值范围内。
  7. 将默认值设置为 1。
  8. 点击保存。
  9. 如需返回到数据源字段列表，请点击左侧的所有字段。

接下来，创建计算字段：

  1. 点击右上角的添加字段 。
  2. 为该字段命名（例如“含参数的销售预测”）。
  3. 在该公式中，将数据源中的“销售额”字段乘以 Forecast multiplier 参数。例如，如果您的数据源包含一个名为 Revenue 的字段，请输入以下内容：

    Revenue * Forecast multiplier
  4. 点击保存。

接下来，添加一个控件来收集用户输入的内容：

  1. 修改或创建报告。
  2. 如有必要，请将数据源添加到报告中。
  3. 点击顶部的 控制图标。 /> 添加控制项 。
  4. 选择输入框控件。

    借助“输入框”控件，您可以直接输入参数值。其他类型的控件可让您从列表中进行选择、使用滑块或通过复选框切换布尔值。
  5. 在右侧的数据属性中，添加您之前创建的 Forecast multiplier 参数。

最后，在图表中直观呈现参数化计算字段。

  1. 点击顶部的 添加图表图标。 添加图表。
  2. 为简单起见，请选择一个统计信息摘要。
  3. 在右侧的数据属性中，添加 Sales forecast with parameter 计算字段作为指标。

现在，尝试一下：

  1. 点击右上角的查看。
  2. 在预测乘数控件中输入一个数字，然后按 Enter 键。
  3. 您会看到，统计信息摘要中的值会随着您输入的倍数值而变化。

在可视化图表中使用参数

您可以像添加维度或指标一样向图表添加参数。如果您将某个数值参数用作指标，系统会汇总其值。

在报告中显示或隐藏参数

您可以显示或隐藏在数据源中创建的参数：

  1. 修改数据源。
  2. 找到相应参数。
  3. 点击参数右侧的更多选项。“选项”。
  4. 点击显示（如果相应参数目前处于隐藏状态）或隐藏（如果相应参数目前处于显示状态）。

隐藏参数会将其从数据面板的字段列表中移除，并会破坏使用该参数的所有组件。如果该参数用于计算字段，则公式会使用该参数的默认值。

复制带有参数的组件

复制组件会复制其在“属性”面板中设置的参数值。您可以修改组件来替换副本的参数。

修正无效参数

如果连接器中的参数配置发生变化，使用这些参数的任何图表都可能会损坏。例如，连接器的开发者可能会移除替换参数值的功能，而您在报告中提供的值将不再返回有效数据。在这种情况下，您会在受相应更改影响的任何图表中看到一条错误消息。

如需解决此问题，请找到包含现在无效的参数的组件。然后，在该组件的“数据”属性的参数部分中，点击修正无效值。

请注意，参数可以在报告、网页和群组级别设置，也可以在各个图表上设置，因此您可能需要在多个位置查找并修正错误。

控制简介