---
schema_version: "1"
id: 4eccc55599653a9c2dd5d4fda5c982a7d182219eaf0315d30f24286bcfaf4000
title: 自定义您的 Tableau 数据故事：上下文变量
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server-linux/data_stories_customize_context_variables.md
canonical_url: https://help.tableau.com/v0.0/server-linux/zh-cn/data_stories_customize_context_variables.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 54922045d4b47a0700092ff8db039e6aa0b7c242faeb5947d19d2906d106af94
description: Feature retired.
---
[跳转到主要内容](#main-content)

# 自定义您的 Tableau 数据故事：上下文变量

**Tableau 数据故事的重要变化**

Tableau 数据故事将于 2025 年 1 月 (2025.1) 在 Tableau Desktop、Tableau Cloud 和 Tableau Server 中停用。随着自然语言技术的进步，我们正在开发一种改进的界面，使您可以更轻松地提出数据问题并掌握变化。有关详细信息，请参见[由 Tableau AI 支持的 Tableau Pulse 如何重塑数据体验](https://www.tableau.com/zh-cn/blog/tableau-pulse-and-tableau-ai)。

上下文变量是可以被其他函数引用的函数。换句话说，您可以使用上下文变量将函数嵌套在其他函数中。

定义上下文变量后，它会显示为一个函数，您可以在将新函数添加到 Tableau 数据故事时使用该函数。

**注意：**您可以为每个自定义句子设置多个上下文变量，但您必须为每段自定义内容分别定义每个上下文变量。

## 设置上下文变量

1. 在您的数据故事中，单击“编辑”以打开“编辑”对话框。
2. 单击“添加自定义项”。
3. 单击自定义内容框右侧的菜单，然后选择“设置上下文”。  
      
    ![“编辑故事”对话框，其中一个故事句子被选中，因此菜单处于打开状态。“设置上下文”选项突出显示。](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_context_set.png)
4. 单击“添加上下文”。
5. 命名上下文变量并单击“设置函数”。
6. 定义您的自定义函数并选择一个维度。  
      
    ![一个用于命名上下文变量的开放字段、一个“添加上下文”按钮，以及用于定义自定义函数的字段。](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_context_add.png)
7. 单击“添加到版块”。
8. 单击返回到您设置上下文变量的句子。
9. 按照[添加函数](https://help.tableau.com/v0.0/server-linux/zh-cn/data_stories_customize.htm#Add)的步骤进行操作。  
      
    ![函数对话框打开，用于定义自定义函数的字段列出了自定义上下文选项。](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_context_shows.png)

现在，当您添加函数时，上下文变量将作为选项列在“维度值”下拉列表中。  

## 何时使用上下文变量：引用两个或多个度量  

假设您想在数据故事中的一个分析句子中引用两个或更多度量。如果没有上下文变量，我们一次只能为一个度量写一个句子。但如果我们使用上下文变量，我们可以在一个句子中引用多个度量。  

若要使用上下文变量引用两个或更多度量，您的数据故事必须有：

> - 1 个维度
> - 2 个或更多度量

1. 在您的数据故事中，单击“编辑”以打开“编辑”对话框。
2. 单击“添加自定义项”。
3. 单击自定义内容框右侧的菜单，然后选择“设置上下文”。
4. 单击“添加上下文”。
5. 命名上下文变量并单击“设置函数”。
6. 定义您的自定义函数并选择一个维度。
7. 单击“添加到版块”。  
      
    ![显示上下文变量的图像，其中包含排序降序标签、SUM(GDP) 度量、排名 1 和国家/地区维度的定义函数](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_context_setfuction.png)
8. 单击返回到您设置上下文变量的句子。
9. 添加您的第一个函数并填写必填字段。在此示例中，我们选择了 DimensionValueLabel，从“维度”中选择“国家/地区”，然后从“维度值”中选择 GDP 最高的国家/地区（我们的上下文变量）。  
      
    ![函数对话框打开，步骤 9 中列出的选项处于选定状态。](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_custom_context_func1.png)

1. 单击“添加到版块”。
2. 添加您的第二个函数并填写必填字段。在这个例子中，我们选择了 Value，然后从“维度”中选择“国家/地区”，从“度量”中选择“SUM(Lending Interest)”，并从“维度值”中选择 GDP 最高的国家/地区（我们的上下文变量）。  
      
    ![函数对话框打开，步骤 10 中列出的选项处于选定状态。](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_custom_context_func2.png)

1. 单击“添加到版块”。
2. 单击“保存”。

您的数据故事编写了一个句子，让我们深入了解我们感兴趣的国家/地区（GDP 最高的国家/地区）的次要衡量标准（贷款利息）。  
  
![图像显示数据故事中呈现的句子，表明美国在该数据集中拥有最高的 AVG (GDP) 和 $0.7B 的贷款利息。](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_context_sentence.png)  

## 何时使用上下文变量：跨周期分析

当您想要分析数据故事中两个不同周期的性能时，上下文变量会很有帮助。您可以创建一个自定义句子来描述在您的向下钻取版块中显示的度量，并将该度量与不同的周期进行比较，例如逐年或逐月。  

若要设置跨周期分析，您的数据故事必须有：

> - 2 个维度：1 个时间段维度（主要）和 1 个非时间段维度（次要）
> - 1-3 个度量

1. 创建数据故事。
2. 在“字段”对话框中，确保您的时间段维度首先排序，然后单击“下一步”。
3. 在“故事”对话框中，选择“连续”，并单击“完成”。
4. 打开“编辑”对话框，然后在第一个向下钻取区域中选择“添加自定义项”。
5. 创建两个代表您的时间段的上下文变量。例如，“Current Quarter”（当前季度）和“Previous Quarter”（上一季度）。  
      
    ![显示两个上下文变量集的图像，一个用于当前季度，一个用于上一季度](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_context_quarters.png)
6. 通过添加自定义语言和函数来创建一个 _increased_ 句子。这个句子的内容生成“\[CurrentDimensionValueLabel\] increased \[X%\] over the quarter”（\[CurrentDimensionValueLabel\] 在本季度增加了 \[X%\]）。
7. 在自定义文本框中键入函数，后跟单词“increased”。
8. 添加返回您的时间段内度量百分比变化的函数。  
      
    ![函数对话框打开，步骤 1 至步骤 8 中列出的选项处于选定状态。](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_context_increased.png)
9. 单击“添加到版块”。
10. [复制自定义内容](https://help.tableau.com/v0.0/server-linux/zh-cn/data_stories_customize.htm#Duplicat)并通过将单词“increased”替换为“decreased”来创建 _decreased_ 版本。函数保持不变。  
      
    ![“编辑故事”对话框，其中一个故事句子被选中，因此菜单处于打开状态。“复制”选项突出显示。](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_context_duplicate.png)
11. 为每个句子[添加条件](https://help.tableau.com/v0.0/server-linux/zh-cn/data_stories_customize.htm#Add2)，以便只写入一个，具体取决于数据。  
      
    ![条件对话框打开，并且为自上一季度以来的增加输入了自定义内容。](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_context_addcondition.png)
12. 对于 _increased_ 句子，请按照以下示例设置条件：

> 左侧参数 = 值函数
> 
> 维度 = Quarter(OrderDate)。选择您的时间段维度
> 
> 度量 = SUM(Total Orders)。选择用于计算的度量
> 
> 维度值 = 当前季度。上下文变量之一
> 
> 筛选维度值 = 当前区域值（动态）。这是预设的上下文变量
> 
> 中间参数 = >（大于）
> 
> 右侧参数 = 值函数
> 
> 维度 = Quarter(OrderDate)。选择您的时间段维度
> 
> 度量 = Total(Total Orders)。选择用于计算的度量
> 
> 维度值 = 上一季度。上下文变量之一
> 
> 筛选维度值 = 当前区域值（动态）。这是预设的上下文变量  
>   
> ![条件对话框打开，并按照步骤 12 中所述输入自定义内容。](/tableau/next/zh-cn/server-linux/zh-cn/Img/data_stories_context_period_analysis.png)  

1. 对于 _decreased_ 句子，设置相同的条件，但将 >（大于）符号替换为 <（小于）符号。左侧和右侧参数保持不变。
2. 单击“保存”，您的数据故事会写一个句子，其中包含通过分析两个时间段得出的洞察。