flashduty-knowledge-base 1.3.0 → 1.3.1

package/dist/iife/en.js

@@ -1370,7 +1370,7 @@ Alibaba Cloud Monitor event alert to Flashduty severity level mapping:
 | WARNING              | Warning   | Warning |
 | INFO                 | Info      | Info |
 
-</div>`,h=`---
+</div>`,u=`---
 title: "Alibaba Cloud Monitor CM Metrics Integration"
 description: "Sync Alibaba Cloud Monitor alert events to Flashduty via webhook for automated alert noise reduction"
 date: "2025-05-19T10:00:00+08:00"
@@ -1595,7 +1595,7 @@ Alibaba Cloud SLS monitoring to Flashduty alert severity mapping:
 | 2                | Info      | Info |
 
 </div>
-`,u={CustomAlert:t,Email:a,N9e:i,Prometheus:o,Grafana:s,Zabbix:r,UptimeKuma:l,AliyunARMS:d,AliyunCmEvent:c,AliyunCm:h,AliyunSLS:e,AWSCW:e,AzureMonitor:`---
+`,h={CustomAlert:t,Email:a,N9e:i,Prometheus:o,Grafana:s,Zabbix:r,UptimeKuma:l,AliyunARMS:d,AliyunCmEvent:c,AliyunCm:u,AliyunSLS:e,AWSCW:e,AzureMonitor:`---
 title: "AWS CloudWatch Integration"
 description: "Sync AWS CloudWatch alert events to Flashduty via webhook to achieve automated alert noise reduction"
 date: "2025-05-19T10:00:00+08:00"
@@ -7806,4 +7806,288 @@ https://cmdb.com/vm?sn=VM123456
 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
-`};n.FlashDocsEn=u})(window);
+`,ServiceNowSync:`---
+title: "ServiceNow Sync"
+description: "Sync incidents with ServiceNow Incidents through ServiceNow sync webhook."
+date: "2025-05-19T10:00:00+08:00"
+url: "https://docs.flashcat.cloud/en/flashduty/service-now-sync"
+---
+
+Through ServiceNow sync webhook, Flashduty incidents are associated and synchronized with ServiceNow Incidents to achieve integration between Flashduty and ServiceNow.
+
+## In ServiceNow
+
+### Create User
+
+1. Log in to the ServiceNow instance console, select \`ALL\`, enter \`USERS\` and select \`Organization\`-\`Users\`.
+2. Click \`New\` to create a new user.
+3. In the edit page, enter \`flashduty\` in the \`User ID\` field.
+4. Keep \`Password needs reset\`, \`Web service access only\`, and \`Internal Integration User\` unchecked.
+5. Submit and save.
+
+<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/snow/snow-1.png" />
+
+### Configure User
+
+The user used to access ServiceNow needs to have administrator roles.
+
+1. On the user list page, find the newly created \`flashduty\` user and go to the configuration page.
+2. In the edit page, click \`Set Password\` to set a password.
+3. Click \`Roles\` to add **admin and itil** roles.
+4. Click \`Update\` to update the configuration.
+
+<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/snow/snow-2.png" />
+
+## In Flashduty
+
+### Configure Integration
+
+Enter the username/password and instance name configured above into the integration information on the left and click Next to configure.
+
+- **Integration Name:** Define a name for the current integration.
+- **Management Team:** When a management team is selected, only team members and tenant administrators can edit this integration.
+- **Channel:** Select the channel where this integration takes effect.
+- **Sync Direction:**
+  - To_ServiceNow: Sync Flashduty incidents to ServiceNow.
+  - From_ServiceNow: Sync ServiceNow Incidents to Flashduty.
+  - Two-way: Bidirectional sync between Flashduty and ServiceNow.
+- **Trigger Mode**:
+  - Auto Trigger: Requires configuration of corresponding conditions, Flashduty will automatically sync incidents that meet the conditions to ServiceNow.
+  - Manual Trigger: Requires manual triggering of ServiceNow sync in the More Actions section of the incident details page (the integration configuration name is the trigger name).
+- **Severity Mapping:** ServiceNow's Priority is determined by the combined values of Impact and Urgency, so you can refer to ServiceNow's \`Priority Lookup Rules\` for configuration. Additionally, note that only when ServiceNow Incident's Urgency changes will it trigger updates to Flashduty incident severity.
+- **Custom Field Mapping:** You can choose to sync certain labels or all labels of incidents as well as custom field content to ServiceNow fields (only text-type fields are supported).
+
+## In ServiceNow
+
+When sync direction is set to From_ServiceNow or Two-way, additional configuration is required in ServiceNow to sync ServiceNow Incidents to Flashduty. When syncing to Flashduty, there are two methods available, choose based on your actual needs.
+
+### Manual Sync
+
+This method relies on ServiceNow's UI Action and Script Include configuration. The effect achieved by following the steps below: When creating or updating an Incident, you can see a button to send sync requests in the function area. Triggering this button will sync the current Incident content to Flashduty. Note that if the request fails when triggered, please retry (retry interval should be greater than 10 seconds).
+
+#### Configure UI Action
+
+1. Log in to the ServiceNow instance console, select \`ALL\`, enter \`UI Actions\` and select \`System Definition\`-\`UI Actions\`.
+2. Click \`New\` to create a new Action.
+3. Enter **Send To Flashduty** in \`Name\`, select **Incident** in \`Table\`.
+4. Keep \`Form button\`, \`Active\`, \`Show insert\`, \`Show update\`, \`Client\`, \`List v2/3 Compatible\` checked.
+5. Enter **onClick();** in \`Onclick\`.
+6. Enter the following in \`Script\`:
+
+   \`\`\`js
+   function onClick() {
+     g_form.save();
+
+     var ga = new GlideAjax("IncidentWebhookHelperAjax");
+     ga.addParam("sysparm_name", "sendWebhook");
+     ga.addParam("sysparm_sys_id", g_form.getUniqueValue());
+
+     ga.getXMLAnswer(function (response) {
+       alert("Webhook Triggered: " + response);
+     });
+   }
+   \`\`\`
+
+7. Submit and save.
+
+#### Configure Script Include
+
+1. Log in to the ServiceNow instance console, select \`ALL\`, enter \`Script Includes\` and select \`System Definition\`-\`Script Includes\`.
+2. Click \`New\` to create a new Script Include.
+3. Enter **IncidentWebhookHelper** in \`Name\`, select **All application scopes** in \`Accessible from\`.
+4. Keep \`Client callable\` and \`Active\` checked.
+5. Enter the following content in \`Script\`, where you need to add the integration push URL in **request.setEndpoint**:
+
+<div class="hide">
+
+Note: The body configures default receiving fields. If you have custom fields that need to be synced to Flashduty, you need to manually add content to the body. For example, if you want to add a field named: test_001 (this field name can be obtained when adding custom fields in the integration configuration, do not use the field name displayed in the ServiceNow Incident form), then you need to add to the body: test_001: current.getDisplayValue("test_001").
+
+</div>
+
+\`\`\`js
+var IncidentWebhookHelper = Class.create();
+IncidentWebhookHelper.prototype = {
+  initialize: function () {},
+
+  sendIncidentWebhook: function (current) {
+    function getLastComment(sysId) {
+      var journalGR = new GlideRecord("sys_journal_field");
+      journalGR.addQuery("element_id", sysId);
+      journalGR.addQuery("element", "comments");
+      journalGR.orderByDesc("sys_created_on");
+      journalGR.setLimit(1);
+      journalGR.query();
+      if (journalGR.next()) {
+        return journalGR.getValue("value");
+      }
+      return "";
+    }
+
+    var body = {
+      action_type: current.isNewRecord() ? "insert" : "update",
+      number: current.getValue("number"),
+      sys_id: current.getUniqueValue(),
+      short_description: current.getValue("short_description"),
+      description: current.getValue("description"),
+      state: current.getDisplayValue("state"),
+      impact: current.getDisplayValue("impact"),
+      urgency: current.getDisplayValue("urgency"),
+      comments: getLastComment(current.getUniqueValue()),
+<label name='field_mapping' tab='6'>{original.key}: current.getDisplayValue("{original.key}")</label>
+    };
+
+    try {
+      var request = new sn_ws.RESTMessageV2();
+      request.setHttpMethod("POST");
+      request.setEndpoint("PUSH URL");
+      request.setRequestHeader("Content-Type", "application/json");
+      request.setRequestBody(JSON.stringify(body));
+      request.executeAsync();
+    } catch (ex) {
+      gs.error("Webhook Call failed: " + ex.message);
+    }
+  },
+
+  type: "IncidentWebhookHelper",
+};
+\`\`\`
+
+6. Submit and save.
+7. Return to the Script Includes list and continue creating.
+8. Click \`New\` to create a new Script Include.
+9. Enter **IncidentWebhookHelperAjax** in \`Name\`, select **All application scopes** in \`Accessible from\`.
+10. Keep \`Client callable\` and \`Active\` checked.
+11. Enter the following content in \`Script\`:
+
+    \`\`\`js
+    var IncidentWebhookHelperAjax = Class.create();
+    IncidentWebhookHelperAjax.prototype = Object.extendsObject(
+      global.AbstractAjaxProcessor,
+      {
+        sendWebhook: function () {
+          var sysId = this.getParameter("sysparm_sys_id");
+          var gr = new GlideRecord("incident");
+          if (gr.get(sysId)) {
+            var helper = new IncidentWebhookHelper();
+            helper.sendIncidentWebhook(gr);
+            return "Success";
+          }
+          return "Request failed";
+        },
+      }
+    );
+    \`\`\`
+
+12. Submit and save.
+
+### Auto Sync
+
+This method relies on ServiceNow's Business Rules configuration. Using this method, you can automatically sync Incidents to Flashduty when there are new or update events.
+
+#### Configure Business Rules
+
+1. Log in to the ServiceNow instance console, select \`ALL\`, enter \`Business Rules\` and select \`System Definition\`-\`Business Rules\`.
+2. Click \`New\` to create a new Business Rule.
+3. Enter **Send To Flashduty** in \`Name\`, select **Incident** in \`Table\`.
+4. Keep \`Advanced\` and \`Active\` checked.
+5. In the \`When to run\` section, select **async** in \`When\`, keep \`Insert\` and \`Upsert\` checked, configure others as needed.
+6. In the \`Advanced\` section, enter the following content in \`Script\`, where you need to add the integration push URL in **endpoint**:
+
+<div class="hide">
+
+Note: The body configures default receiving fields. If you have custom fields that need to be synced to Flashduty, you need to manually add content to the body. For example, if you want to add a field named: test_001 (this field name can be obtained when adding custom fields in the integration configuration, do not use the field name displayed in the ServiceNow Incident form), then you need to add to the body: test_001: current.getDisplayValue("test_001").
+
+</div>
+
+\`\`\`js
+(function executeRule(current, previous) {
+  function getLastComment(recordSysId) {
+    var journalGR = new GlideRecord("sys_journal_field");
+    journalGR.addQuery("element_id", recordSysId);
+    journalGR.addQuery("element", "comments");
+    journalGR.orderByDesc("sys_created_on");
+    journalGR.setLimit(1);
+    journalGR.query();
+    if (journalGR.next()) {
+      var comment = journalGR.getValue("value");
+      return comment;
+    }
+
+    return "";
+  }
+
+  var operation = current.operation() || "unknown";
+  var isPreviousNull = previous === null;
+  var createdOn = current.getValue("sys_created_on");
+  var updatedOn = current.getValue("sys_updated_on");
+  var isNewRecord = createdOn === updatedOn;
+
+  var action = "update";
+  if (isPreviousNull && isNewRecord) {
+    action = "insert";
+  }
+
+  var body = {
+    action_type: action,
+    number: current.getValue("number"),
+    sys_id: current.getUniqueValue(),
+    short_description: current.getValue("short_description"),
+    description: current.getValue("description"),
+    state: current.getDisplayValue("state"),
+    impact: current.getDisplayValue("impact"),
+    urgency: current.getDisplayValue("urgency"),
+    comments: getLastComment(current.getUniqueValue()),
+<label name='field_mapping' tab='4'>{original.key}: current.getDisplayValue("{original.key}")</label>
+
+  };
+
+  try {
+    var endpoint = "";
+    var request = new sn_ws.RESTMessageV2();
+    request.setHttpMethod("POST");
+    request.setEndpoint(endpoint);
+    request.setRequestHeader("Content-Type", "application/json");
+    request.setRequestBody(JSON.stringify(body));
+    request.executeAsync();
+  } catch (ex) {
+    gs.error("Error sending webhook: " + ex.message);
+  }
+})(current, previous);
+\`\`\`
+
+7. Submit and save.
+
+## Sync Information
+
+### Form Fields
+
+| ServiceNow          | Flashduty     | Notes |
+| ------------------- | ------------- | ----- |
+| Short_description   | Title         |       |
+| Description         | Description   |       |
+| Additional comments | Comments      |       |
+| State               | Progress      |       |
+| Urgency             | Severity      |       |
+| Others              | Custom Fields |       |
+
+### Status Mapping
+
+| ServiceNow  | Flashduty  | Notes                  |
+| ----------- | ---------- | ---------------------- |
+| New         | Trigger    |                        |
+| In Progress | Processing |                        |
+| On Hold     | Snoozed    | Default snooze 2 hours |
+| Resolved    | CLosed     |                        |
+| Closed      | CLosed     |                        |
+| Canceled    | CLosed     |                        |
+
+### Priority Mapping
+
+Only when ServiceNow's Urgency value changes will it affect Flashduty's Severity
+
+| ServiceNow | Flashduty | Notes |
+| ---------- | --------- | ----- |
+| Low        | Info      |       |
+| Medium     | Warning   |       |
+| High       | Critical  |       |
+`};n.FlashDocsEn=h})(window);

package/dist/iife/zh.js

@@ -8106,4 +8106,286 @@ https://cmdb.com/vm?sn=VM123456
 1. 当引用的内容不存在时，Link 集成会正常生成对应的链接，但无法获取到值
 2. 同一个协作空间至多绑定三个 Link 集成
 3. 注意引用语法，如未按照要求进行书写引用变量，会导致无法正常获取对应值
+`,ServiceNowSync:`---
+title: "ServiceNow 同步"
+description: "通过 ServiceNow 同步 Webhook，实现故障与 ServiceNow Incident 的关联。"
+date: "2025-05-19T10:00:00+08:00"
+url: "https://docs.flashcat.cloud/zh/flashduty/service-now-sync"
+---
+
+通过 ServiceNow 同步 Webhook，将 Flashduty 的故障与 ServiceNow Incident 进行关联同步，实现 Flashduty 与 ServiceNow 的联动。
+
+## 在 ServiceNow
+
+### 创建用户
+
+1. 登录 ServiceNow 实例控制台，通过选择 \`ALL\` ，输入 \`USERS\` 选择\`Organization\`-\`Users\` 。
+2. 点击 \`New\` 新建用户。
+3. 在编辑页面中，\`User ID\` 输入：flashduty 。
+4. \`Password needs reset\` 和 \`Web service access only\` 以及 \`Internal Integration User\` 保持取消勾选状态。
+5. 提交保存。
+
+<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/snow/snow-1.png" />
+
+### 配置用户
+
+用于访问 ServiceNow 的用户需要是管理员角色。
+
+1. 在用户列表页面，找到新创建的 \`flashduty\` 用户并进到配置页面。
+2. 在编辑页面中，点击 \`Set Password\` 设置一个密码。
+3. 点击 \`Roles\` 添加 **admin 和 itil** 角色。
+4. 点击 \`Update\` 更新配置。
+
+<img alt="drawing" width="600" src="https://download.flashcat.cloud/flashduty/doc/snow/snow-2.png" />
+
+## 在 Flashduty
+
+### 配置集成
+
+将以上配置的用户名/密码以及实例名称输入到左侧集成信息中并点击下一步进行配置。
+
+- **集成名称：** 为当前集成定义一个名称。
+- **管理团队：** 当选择管理团队后，只有该团队成员以及租户管理员可以编辑此集成。
+- **协作空间**：选择该集成生效的协作空间，。
+- **同步方向：**
+  - To_ServiceNow：将 Flashduty 的故障同步至 ServiceNow。
+  - From_ServiceNow：将 ServiceNow 的 Incident 同步至 Flashduty。
+  - Two-way：Flashduty 和 ServiceNow 互相同步。
+- **触发模式**：
+  - 自动触发：需要配置相应的条件，Flashduty 会自动将符合条件的故障同步到 ServiceNow 中。
+  - 手动触发：需要在故障详情页的更多操作中手动触发 ServiceNow 同步（该集成配置的名称为触发器名称）。
+- **严重程度映射**：ServiceNow 的 Priority 是由 Impact 和 Urgency 的值共同决定的，所以可以参考 ServiceNow 的 \`Priority Lookup Rules\` 进行配置。另外需要注意的是，只有当 ServiceNow Incident 的 Urgency 发生变化时，才会触发 Flashduty 故障严重程度的更新。
+- **自定义字段映射**：可以选择将故障的某些标签或所有标签以及自定义字段内容同步至 ServiceNow 的字段中（仅支持文本类型的字段）。
+
+## 在 ServiceNow
+
+当同步方向选择 From_ServiceNow 或 Two-way 时，还需要在 ServiceNow 中做相应的配置，以便将 ServiceNow Incident 同步至 Flashduty， 在同步至 Flashduty 时，有以下两种方式，可根据实际需求选择即可。
+
+### 手动同步
+
+该方式依赖 ServiceNow 提供的 UI Action 和 Script Include 的配置，根据以下步骤配置完成的效果：当新建 Incident 或更新 Incident 时，可以在功能区看到发送同步请求的按钮，触发该按钮，可以将当前 Incident 的内容同步至 Flashduty。需要注意的是，如果触发请求时遇到失败的情况，请重试（重试时间间隔需大于 10 秒）。
+
+#### 配置 UI Action
+
+1. 登录 ServiceNow 实例控制台，通过选择 \`ALL\` ，输入 \`UI Actions\` 选择\`System Definition\`-\`UI Actions\` 。
+2. 点击 \`New\` 新建 Action。
+3. \`Name\` 输入： **Send To Flashduty**， \`Table\` 选择 **Incident** 。
+4. \`Form button\` ，\`Active\` ，\`Show insert\` ，\`Show update\` ，\`Client\`， \`List v2/3 Compatible\` 保持勾选状态。
+5. \`Onclick\` 输入：**onClick();**。
+6. \`Script\` 输入：
+
+   \`\`\`js
+   function onClick() {
+     g_form.save();
+
+     var ga = new GlideAjax("IncidentWebhookHelperAjax");
+     ga.addParam("sysparm_name", "sendWebhook");
+     ga.addParam("sysparm_sys_id", g_form.getUniqueValue());
+
+     ga.getXMLAnswer(function (response) {
+       alert("Webhook Triggered: " + response);
+     });
+   }
+   \`\`\`
+
+7. 提交保存。
+
+#### 配置 Script Include
+
+1. 登录 ServiceNow 实例控制台，通过选择 \`ALL\` ，输入 \`Script Includes\` 选择\`System Definition\`-\`Script Includes\` 。
+2. 点击 \`New\` 新建 Script Include。
+3. \`Name\` 输入：**IncidentWebhookHelper** ， \`Accessible from\` 选择 **All application scopes**。
+4. \`Client callable\` 和 \`Active\` 保持勾选状态。
+5. \`Script\` 输入以下内容，其中 **request.setEndpoint** 中需要补充集成的推送地址：
+
+<div class="hide">
+
+注意： body 中配置的是默认接收字段，如果有自定义字段需要同步至 Flashduty ，需要额外手动补充内容到 body 中，比如希望添加一个字段名为：test_001 的字段（该字段名可以在配置集成中添加自定义字段的时候获取，不要使用 ServiceNow Inident 表单中显示的字段名），那么需要在 body 中补充：test_001: current.getDisplayValue("test_001")。
+
+</div>
+
+\`\`\`js
+var IncidentWebhookHelper = Class.create();
+IncidentWebhookHelper.prototype = {
+  initialize: function() {},
+
+  sendIncidentWebhook: function(current) {
+      function getLastComment(sysId) {
+          var journalGR = new GlideRecord('sys_journal_field');
+          journalGR.addQuery('element_id', sysId);
+          journalGR.addQuery('element', 'comments');
+          journalGR.orderByDesc('sys_created_on');
+          journalGR.setLimit(1);
+          journalGR.query();
+          if (journalGR.next()) {
+              return journalGR.getValue('value');
+          }
+          return '';
+      }
+
+      var body = {
+          action_type: current.isNewRecord() ? 'insert' : 'update',
+          number: current.getValue("number"),
+          sys_id: current.getUniqueValue(),
+          short_description: current.getValue("short_description"),
+          description: current.getValue("description"),
+          impact: current.getDisplayValue("impact"),
+          urgency: current.getDisplayValue("urgency"),
+          comments: getLastComment(current.getUniqueValue()),
+<label name='field_mapping' tab='10'>{original.key}: current.getDisplayValue("{original.key}")</label>
+      };
+
+      try {
+          var request = new sn_ws.RESTMessageV2();
+          request.setHttpMethod("POST");
+          request.setEndpoint("PUSH URL");
+          request.setRequestHeader("Content-Type", "application/json");
+          request.setRequestBody(JSON.stringify(body));
+          request.executeAsync();
+          } catch (ex) {
+          gs.error("Webhook Call failed: " + ex.message);
+      }
+  },
+  type: 'IncidentWebhookHelper'
+};
+
+\`\`\`
+
+6. 提交保存。
+7. 回到 Script Includes 列表，继续创建。
+8. 点击 \`New\` 新建 Script Include。
+9. \`Name\` 输入：**IncidentWebhookHelperAjax** ， \`Accessible from\` 选择 **All application scopes**。
+10. \`Client callable\` 和 \`Active\` 保持勾选状态。
+11. \`Script\` 输入以下内容：
+
+    \`\`\`js
+    var IncidentWebhookHelperAjax = Class.create();
+    IncidentWebhookHelperAjax.prototype = Object.extendsObject(
+      global.AbstractAjaxProcessor,
+      {
+        sendWebhook: function () {
+          var sysId = this.getParameter("sysparm_sys_id");
+          var gr = new GlideRecord("incident");
+          if (gr.get(sysId)) {
+            var helper = new IncidentWebhookHelper();
+            helper.sendIncidentWebhook(gr);
+            return "Success";
+          }
+          return "Request failed";
+        },
+      }
+    );
+    \`\`\`
+
+12. 提交保存。
+
+### 自动同步
+
+该方式依赖 ServiceNow 提供的 Business Rules 的配置，使用该方式可以实现当有新建或更新事件时，自动将 Incident 同步至 Flashduty。
+
+#### 配置 Business Rules
+
+1. 登录 ServiceNow 实例控制台，通过选择 \`ALL\` ，输入 \`Business Rules\` 选择\`System Definition\`-\`Business Rules\` 。
+2. 点击 \`New\` 新建 Business Rule。
+3. \`Name\` 输入：**Send To Flashduty** ， \`Table\` 选择 **Incident**。
+4. \`Advanced\` 和 \`Active\` 保持勾选状态。
+5. 在 \`When to run\` 区域中，\`When\` 选择 **async**，\`Insert\` 和 \`Upsert\` 保持勾选状态，其他按需配置。
+6. 在 \`Advanced\` 区域中，\`Script\` 填写以下内容，其中 **endpoint** 中需要补充集成的推送地址：
+
+<div class="hide">
+
+注意： body 中配置的是默认接收字段，如果有自定义字段需要同步至 Flashduty ，需要额外手动补充内容到 body 中，比如希望添加一个字段名为：test_001 的字段（该字段名可以在配置集成中添加自定义字段的时候获取，不要使用 ServiceNow Inident 表单中显示的字段名），那么需要在 body 中补充：test_001: current.getDisplayValue("test_001")。
+
+</div>
+
+\`\`\`js
+(function executeRule(current, previous) {
+  function getLastComment(recordSysId) {
+    var journalGR = new GlideRecord("sys_journal_field");
+    journalGR.addQuery("element_id", recordSysId);
+    journalGR.addQuery("element", "comments");
+    journalGR.orderByDesc("sys_created_on");
+    journalGR.setLimit(1);
+    journalGR.query();
+    if (journalGR.next()) {
+      var comment = journalGR.getValue("value");
+      return comment;
+    }
+    return "";
+  }
+
+  var operation = current.operation() || "unknown";
+  var isPreviousNull = previous === null;
+  var createdOn = current.getValue("sys_created_on");
+  var updatedOn = current.getValue("sys_updated_on");
+  var isNewRecord = createdOn === updatedOn;
+
+  var action = "update";
+  if (isPreviousNull && isNewRecord) {
+    action = "insert";
+  }
+
+  var body = {
+    action_type: action,
+    number: current.getValue("number"),
+    sys_id: current.getUniqueValue(),
+    short_description: current.getValue("short_description"),
+    description: current.getValue("description"),
+    state: current.getDisplayValue("state"),
+    impact: current.getDisplayValue("impact"),
+    urgency: current.getDisplayValue("urgency"),
+    comments: getLastComment(current.getUniqueValue()),
+<label name='field_mapping' tab='4'>{original.key}: current.getDisplayValue("{original.key}")</label>
+
+  };
+
+  try {
+    var endpoint = "";
+    var request = new sn_ws.RESTMessageV2();
+    request.setHttpMethod("POST");
+    request.setEndpoint(endpoint);
+    request.setRequestHeader("Content-Type", "application/json");
+    request.setRequestBody(JSON.stringify(body));
+    request.executeAsync();
+  } catch (ex) {
+    gs.error("Error sending webhook: " + ex.message);
+  }
+})(current, previous);
+\`\`\`
+
+7. 提交保存。
+
+## 同步信息
+
+### 表单字段
+
+| ServiceNow          | Flashduty     | 备注 |
+| ------------------- | ------------- | ---- |
+| Short_description   | Title         |      |
+| Description         | Description   |      |
+| Additional comments | Comments      |      |
+| State               | Progress      |      |
+| Urgency             | Severity      |      |
+| Others              | Custom Fields |      |
+
+### 状态映射
+
+| ServiceNow  | Flashduty  | 备注            |
+| ----------- | ---------- | --------------- |
+| New         | Trigger    |                 |
+| In Progress | Processing |                 |
+| On Hold     | Snoozed    | 默认暂缓 2 小时 |
+| Resolved    | CLosed     |                 |
+| Closed      | CLosed     |                 |
+| Canceled    | CLosed     |                 |
+
+### 优先级映射
+
+只有 ServiceNow 的 Urgency 值变化时，才会影响 Flashduty 的 Severity
+
+| ServiceNow | Flashduty | 备注 |
+| ---------- | --------- | ---- |
+| Low        | Info      |      |
+| Medium     | Warning   |      |
+| High       | Critical  |      |
 `};n.FlashDocsZh=t})(window);

package/dist/zh.d.ts

@@ -61,5 +61,6 @@ declare const docs: {
     DingtalkAlert: string;
     FeishuAlert: string;
     Link: string;
+    ServiceNowSync: string;
 };
 export default docs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flashduty-knowledge-base",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "flashduty knowledge base",
   "type": "module",
   "engines": {