Merge pull request #53 from flashcatcloud/test

Test

Author: niuweili

flashduty/en/1. On-call/8. Integrations/8.6 Other/8.6.1 Link Integration.md

@@ -0,0 +1,57 @@
+---
+title: "Link Integration"
+description: "Through Link integration, you can quickly access external links by obtaining key parameters from incident attributes, labels, and other information"
+date: "2025-05-19T10:00:00+08:00"
+url: "https://docs.flashcat.cloud/en/flashduty/link-integration-guide"
+---
+
+Through Link integration, you can quickly access external links by obtaining key parameters from incident attributes, labels, and other information
+
+## Configuration Guide
+
+Link integration supports extracting key parameters from incident attributes, labels, and other information to enable quick navigation to external systems. Through automated parameter filling and redirection, it eliminates manual input, improving the efficiency of problem identification and resolution. This feature is applicable to incident troubleshooting, performance monitoring, and system debugging scenarios, helping optimize operations processes and enhance response speed and accuracy.
+
+### Opening Methods
+
+#### 1. Pop-up Window
+Opens a window in the current incident details page, maintaining the original interface state, suitable for quick viewing or returning after operations
+
+#### 2. New Tab
+Opens the link in a new browser tab, suitable for scenarios where you need to retain the current operation context while accessing external content
+
+### URL Configuration
+
+When referencing content from labels, start with labels.; when referencing custom fields, start with fields.; when referencing incident attributes, reference them directly, such as .title .severity
+
+#### Retrieving from Incident Labels
+Supports dynamic value retrieval through ${} syntax to construct request URLs. For example, parameter values can be automatically filled from incident labels, requiring no manual input:
+  
+```
+https://cmdb.com/vm?sn=${labels.sn}
+```
+
+In the above example, ${labels.sn} indicates that the sn label value from the incident will be dynamically injected into the URL. If the incident data contains sn=VM123456, the final request URL will be:
+
+```
+https://cmdb.com/vm?sn=VM123456
+```
+
+
+#### Retrieving from Custom Fields
+Supports dynamic value retrieval through ${} syntax to construct request URLs. For example, parameter values can be automatically filled from custom fields, requiring no manual input:
+  
+```
+https://cmdb.com/vm?sn=${fields.sn}
+```
+
+In the above example, ${fields.sn} indicates that the sn custom field value will be dynamically injected into the URL. If the custom field data contains sn=VM123456, the final request URL will be:
+
+```
+https://cmdb.com/vm?sn=VM123456
+```
+
+### Notes
+
+1. When referenced content does not exist, Link integration will still generate the corresponding link but will not be able to retrieve the value
+2. Each channel can bind up to three Link integrations
+3. Pay attention to reference syntax; improper variable reference formatting will result in failure to retrieve corresponding values

flashduty/zh/1. On-call/5. 集成引导/8.6 其他集成/8.6.1 Link 集成指引.md

@@ -0,0 +1,57 @@
+---
+title: "Link 集成"
+description: "通过 Link 集成，可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数，实现快速访问"
+date: "2025-05-19T10:00:00+08:00"
+url: "https://docs.flashcat.cloud/zh/flashduty/link-integration-guide"
+---
+
+通过 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. 注意引用语法，如未按照要求进行书写引用变量，会导致无法正常获取对应值

src/en.ts

@@ -73,6 +73,11 @@ import JiraSync from "../flashduty/en/1. On-call/8. Integrations/8.5 Webhooks/8.
 /** 模版 */
 import Templates from "../flashduty/en/1. On-call/4. Configure On-call/4.7 Templates.md?raw";
 
+/** ⬇️⬇️⬇️⬇️ Other ⬇️⬇️⬇️⬇️ */
+import Link from  "../flashduty/en/1. On-call/8. Integrations/8.6 Other/8.6.1 Link Integration.md?raw";
+/** ⬆️⬆️⬆️⬆️ Other ⬆️⬆️⬆️⬆️ */
+	
+
 const docs = {
   CustomAlert,
   Email,
@@ -134,5 +139,6 @@ const docs = {
   ElastAlert2,
   DingtalkAlert,
   FeishuAlert,
+  Link,
 };
 export default docs;

src/zh.ts

@@ -73,6 +73,10 @@ import JiraSync from "../flashduty/zh/1. On-call/5. 集成引导/8.5 Webhooks/8.
 /** 模版 */
 import Templates from "../flashduty/zh/1. On-call/3. 配置管理/4.7 配置通知模板.md?raw";
 
+/** ⬇️⬇️⬇️⬇️ Other ⬇️⬇️⬇️⬇️ */
+import Link from  "../flashduty/zh/1. On-call/5. 集成引导/8.6 其他集成/8.6.1 Link 集成指引.md?raw";
+/** ⬆️⬆️⬆️⬆️ Other ⬆️⬆️⬆️⬆️ */
+
 const docs = {
   CustomAlert,
   Email,
@@ -134,5 +138,6 @@ const docs = {
   ElastAlert2,
   DingtalkAlert,
   FeishuAlert,
+  Link,
 };
 export default docs;