> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashcat.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Link 集成

> 通过 Link 集成，可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数，实现快速访问

通过 Link 集成，可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数，实现快速访问

## 配置说明

Link 集成功能支持从故障属性、标签等信息中提取关键参数，实现与外部系统的快速跳转。通过自动化填充和跳转，避免了手动输入，提高了问题定位与处理的效率。该功能适用于故障排查、性能监控和系统调试等场景，有助于优化运维流程，提升响应速度与准确性

### 打开方式

#### 1. 弹窗

在故障详情的当前页面中弹出窗口，保持原有界面状态，适合快速查看或操作后返回

#### 2. 新标签页

在浏览器新标签中打开链接，适用于需要保留当前操作上下文并同时访问外部内容的场景

### URL 配置

URL的参数引用内容为标签时以 labels. 开头；引用内容为自定义字段时，以 fields. 开头；引用内容为故障属性时，直接引用即可，如 .title、.severity 等

#### 故障标签中获取

支持通过 \${} 的方式从参数中动态取值，用于构造请求地址。例如参数值从故障标签（labels）中自动填充，无需手动输入：

```
https://cmdb.com/vm?sn=${labels.sn}
```

在上述示例中，\${labels.sn} 表示将故障中的 sn 标签值动态注入至 URL 中。如果故障数据中包含 sn=VM123456，则最终请求地址为：

```
https://cmdb.com/vm?sn=VM123456
```

#### 自定义字段中获取

支持通过 \${} 的方式从参数中动态取值，用于构造请求地址。例如参数值从自定义字段（fields）中自动填充，无需手动输入：

```
https://cmdb.com/vm?sn=${fields.sn}
```

在上述示例中，\${fields.sn} 表示将故障中的 sn 自定义字段值动态注入至 URL 中。如果自定义字段数据中包含 sn=VM123456，则最终请求地址为：

```
https://cmdb.com/vm?sn=VM123456
```

### 注意事项

1. 当引用的内容不存在时，Link 集成会正常生成对应的链接，但无法获取到值
2. 同一个协作空间至多绑定三个 Link 集成
3. 注意引用语法，如未按照要求进行书写引用变量，会导致无法正常获取对应值
