> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashduty.com/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` 等。

#### 故障标签中获取

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

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

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

```text theme={null}
https://cmdb.com/vm?sn=VM123456
```

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

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

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

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

```text theme={null}
https://cmdb.com/vm?sn=VM123456
```

### 注意事项

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