模板变量

# 1. 模板变量

模板变量是通过在当前视图定义一组变量，并由子视图的搜索条件引用变量，来快速的改变子视图的搜索条件，就可达到在一个视图仅需要改变变量的值，就可以查看其对应的视图，而无需仅因搜索条件的不同而构建多个相同的可视化面板。

可通过模板变量列表对模板变量进行统一的管理。

如下图所示，在模板变量列表中，支持① 新增、② 删除、③ 修改操作，支持在⑤ 搜索栏中输入任意字符串，也支持④ 设置列宽的展示方式，如均分列宽，按内容分配列宽。

00-模版变量列表

需要对当前视图构建一些快速搜索条件时，则可新建模板变量来实现。例如：构建应用可观测性视图时，需要快速查看不同应用的视图，则可将应用这个搜索条件为构建一个模板变量。

第一步：点击视图详情页面的① 设置按钮，选择② 管理模板变量

01-第一步

第二步：点击模板变量列表弹出框的③ 新建模板变量按钮

02-第二步

第三步：根据所需，创建模板变量。DeepFlow 平台一共提供三种类型的模板变量，分别为下拉选择、文本输入、分组，详细描述见后续对应章节。

03-第三步

下拉选择类型的模板变量，是通过下拉框切换的形式来改变搜索条件。目前支持对 DeepFlow 平台的数据库 resource 和 xx_enum 类型的 Tag 构建此类型的模板变量。

04-下拉选择

① 查询类型: 不同的数据传值方式不同
- 按ID查询：支持传输 id 查询
- 按名称查询：支持传输 string 查询
② 取值范围:：支持静态取值与动态取值两种方式设置模板变量的取值
- 静态取值：引用后，取值范围固定
- 动态取值：与静态取值相比，动态取值的取值范围可受静态取值或取值Tag影响，使用详情，请参阅【创建与引用】章节
- ③ 数据来源: 确定模板变量取值所在的数据表
- ④ 取值Tag: 确定模板变量取值对应的 Tag
- ⑤ 取值范围: 选择模板变量对应的取值
⑥ 选择模式: 通过下拉框切换的形式来改变搜索条件，默认为单选
- 多选：勾选多选，则可切换为多选模式
- 全选：勾选全选，则候选项中出现全选，即选中当前模板变量全部的取值
如何引用：图表的搜索栏中添加查询条件时，输入Tag，已建立的相同Tag模版变量，将以候选项的形式出现在下拉框中，使用详情，请参阅【创建与引用】章节