Skip to content

Commit c192a16

Browse files
committed
update sdp docs
1 parent 41724ed commit c192a16

2 files changed

Lines changed: 12 additions & 49 deletions

File tree

flashduty/en/1. On-call/8. Integrations/8.5 Webhooks/8.5.6 ServiceDesk Plus sync.md

Lines changed: 6 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -70,30 +70,19 @@ Please select the corresponding API Endpoint and Accounts Server URL according t
7070
- Manual Trigger: Requires manual triggering of ServiceDesk Plus sync in the More Actions section of the incident details page (the integration configuration name is the trigger name).
7171

7272
5. **Channel:** Select the channel where this integration takes effect.
73-
6. **Request Template:** Select the template to use when creating requests.
74-
7. **Severity Mapping:** The mapping relationship between Flashduty severity and ServiceDesk Plus priority. For default mapping relationship, please refer to [Priority Mapping](#priority-mapping).
73+
6. **Request Template:** Select the template to use when creating requests. If empty, the default template will be used to create the request.
74+
7. **Severity Mapping:** You can choose to map the values of severity, incident labels, or custom fields to the Priority field in ServiceDesk Plus. If empty, this field will not be passed when creating requests.
7575
8. **Custom Field Mapping:** You can map labels or custom fields in incidents to corresponding text fields in ServiceDesk Plus tickets to achieve automatic information filling. This feature supports syncing common context information (such as service name, instance address, metric name, etc.) to ServiceDesk Plus for subsequent troubleshooting and tracking.
7676
- Only supports target fields of single-line text or multi-line text type.
7777
- Supports extracting values from incident labels (such as service, instance) or custom attributes.
7878
- If the source field is empty, the target field will also remain empty and will not overwrite existing content.
79-
- Mapping configuration is managed uniformly in integration settings without manual filling each time.
8079

8180
9. **Assignee Mapping:** When Flashduty incidents are synced to ServiceDesk Plus and need to be automatically assigned to Technician or Group, you can get the value of Flashduty incident labels as the assignee (if the corresponding assignee does not exist, it will cause sync failure, please choose carefully).
82-
83-
10. Click `Save` to complete the configuration.
81+
10. **Requester:** The requester to be specified when creating a request. This needs to be configured if the field is mandatory when creating requests.
82+
11. Click `Save` to complete the configuration.
8483

8584
### In ServiceDesk Plus
86-
#### Step 2 Create Requester
87-
When Flashduty incidents are synced to ServiceDesk Plus, the Requester automatically set by the system
88-
89-
1. Log in to the ServiceDesk Plus console and find the `Setup` configuration page.
90-
2. Select `Users & Permissions`, then enter the `Users` creation page and select `New Requester`.
91-
3. Fill in **flashduty** for `Name (Display Name)` and `First Name`, fill in **flashduty-sync@flashcat.cloud** for `Email`.
92-
4. Other settings can be configured as needed, click `Save` to save the configuration.
93-
94-
![2025-09-24-15-03-31](https://docs-cdn.flashcat.cloud/images/png/9ee174f85ac918476888efd759511d31.png)
95-
96-
#### Step 3 Configure Sync <span id="configure-sync"></span>
85+
#### Step 2 Configure Sync <span id="configure-sync"></span>
9786
To achieve synchronization of ServiceDesk Plus requests to Flashduty, please refer to this configuration item. **Note:** Different versions may have slightly different paths, but the configuration method is the same.
9887
##### Create Webhook
9988
1. Log in to the ServiceDesk Plus console and find the `Setup` configuration page.
@@ -132,7 +121,7 @@ To achieve synchronization of ServiceDesk Plus requests to Flashduty, please ref
132121

133122
![2025-09-23-13-32-32](https://docs-cdn.flashcat.cloud/images/png/94ca1d094ed38ebcaf299364eddfd0ac.png)
134123

135-
##### Create Trigger
124+
##### Step 3 Create Trigger
136125
1. Log in to the ServiceDesk Plus console and find the `Setup` configuration page.
137126
2. Select `Automation`, then enter the `Triggers` page and select `Request`.
138127
3. Click `New Trigger`, fill in **to_Flashduty** for `Name` in the edit page.
@@ -172,14 +161,6 @@ To achieve synchronization of ServiceDesk Plus requests to Flashduty, please ref
172161
| Canceled | CLosed | |
173162
| Rejected | CLosed | |
174163

175-
### Priority Mapping <span id="priority-mapping"></span>
176-
177-
| ServiceDesk Plus | Flashduty | Notes |
178-
| ---------- | --------- | ----- |
179-
| Low | Info | |
180-
| Medium | Warning | |
181-
| High | Critical | |
182-
183164

184165
## FAQ
185166

flashduty/zh/1. On-call/5. 集成引导/8.5 Webhooks/8.5.6 ServiceDesk Plus 同步.md

Lines changed: 6 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -70,30 +70,20 @@ url: "https://docs.flashcat.cloud/zh/flashduty/servicedesk-plus-sync"
7070
- 手动触发:需要在故障详情页的更多操作中手动触发 ServiceDesk Plus 同步(该集成配置的名称为触发器名称)。
7171

7272
5. **协作空间**:选择该集成生效的协作空间。
73-
6. **请求模版**:选择创建 request 时使用的模版。
74-
7. **严重程度映射**Flashduty 的严重程度与 ServiceDesk Plus 优先级的映射关系,默认映射关系,请参考[优先级映射](#优先级映射)
73+
6. **请求模版**:选择创建 request 时使用的模版,为空时使用默认模版创建工单
74+
7. **严重程度映射**可以选择使用严重程度、故障标签、自定义字段的值与 ServiceDesk Plus 的优先级字段进行映射,如果为空,在创建工单时不传该字段
7575
8. **自定义字段映射**:可以将故障中的标签或自定义字段,映射到 ServiceDesk Plus 工单中的对应文本字段,实现信息自动填充。该功能支持将常见上下文信息(如服务名、实例地址、指标名称等)同步至 ServiceDesk Plus,便于后续排查与跟踪。
7676
- 仅支持目标为单行文本或多行文本类型的字段。
7777
- 支持从故障标签(如 service、instance)或自定义属性中提取值。
7878
- 若源字段为空,目标字段也将保持为空,不会覆盖原有内容。
79-
- 映射配置在集成设置中统一管理,无需每次手动填写。
8079

8180
9. **指派对象映射**:当 Flashduty 的故障同步至 ServiceDesk Plus 并需要自动指派到 Technician 或 Group 时,可以获取 Flashduty 故障标签的值作为指派对象(如果对应的指派对象不存在,会导致同步失败,请谨慎选择)。
82-
83-
10. 点击`保存`完成配置。
81+
10. **请求者**:创建工单时指定的 requester,如果工单在创建时该字段是必须,则需要配置。
82+
11. 点击`保存`完成配置。
8483

8584
### 在 ServiceDesk Plus
86-
#### 步骤2 创建 Requester
87-
当 Flashduty 的故障同步到 ServiceDesk Plus 时,系统自动设置的 Requester
88-
89-
1. 登录 ServiceDesk Plus 控制台,找到 `Setup` 配置页面。
90-
2. 选择 `Users & Permissions` 之后,进入到 `Users` 创建页面,选择 `New Requester`
91-
3. `Name (Display Name)``First Name` 填写 **flashduty**`Email` 填写 **flashduty-sync@flashcat.cloud**
92-
4. 其他可按需设置,点击 `Save` 保存配置。
9385

94-
![2025-09-24-15-03-31](https://docs-cdn.flashcat.cloud/images/png/9ee174f85ac918476888efd759511d31.png)
95-
96-
#### 步骤3 配置同步 <span id="配置同步"></span>
86+
#### 步骤2 配置同步 <span id="配置同步"></span>
9787
要实现 ServiceDesk Plus 的 Request 向 Flashduty 的同步,请参考此配置项。**注意:** 不同版本的路径可能略有不同,但配置方法相同。
9888
##### 创建 Webhook
9989
1. 登录 ServiceDesk Plus 控制台,找到 `Setup` 配置页面。
@@ -132,7 +122,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/servicedesk-plus-sync"
132122

133123
![2025-09-23-13-32-32](https://docs-cdn.flashcat.cloud/images/png/94ca1d094ed38ebcaf299364eddfd0ac.png)
134124

135-
##### 创建触发器
125+
##### 步骤3 创建触发器
136126
1. 登录 ServiceDesk Plus 控制台,找到 `Setup` 配置页面。
137127
2. 选择 `Automation` 之后,进入到 `Triggers` 页面,并选择 `Request`
138128
3. 点击 `New Trigger`,在编辑页面中 `Name` 填写 **to_Flashduty**
@@ -172,14 +162,6 @@ url: "https://docs.flashcat.cloud/zh/flashduty/servicedesk-plus-sync"
172162
| Canceled | CLosed | 关闭 |
173163
| Rejected | CLosed | 关闭 |
174164

175-
### 优先级映射 <span id="优先级映射"></span>
176-
177-
| ServiceDesk Plus | Flashduty | 备注 |
178-
| ---------- | --------- | ---- |
179-
| Low | Info | 提示 |
180-
| Medium | Warning | 警告 |
181-
| High | Critical | 灾难 |
182-
183165

184166
## 常见问题
185167

0 commit comments

Comments
 (0)