flashduty-knowledge-base 1.3.0 → 1.3.1

package/dist/esm/zh.js

@@ -3180,7 +3180,7 @@ hooks:
 
 
 </div>
-`,T=`---
+`,S=`---
 title: "Sentry 告警事件"
 description: "通过 webhook 的方式同步 Sentry 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -3291,7 +3291,7 @@ Sentry 提供了两类告警机制：Issue Alerts 和 Metric Alerts。Issue Aler
 |resolved|Ok|恢复|
 
 </div>
-`,A=`---
+`,T=`---
 title: "监控宝告警事件"
 description: "通过 webhook 的方式同步监控宝告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-08-20T10:00:00+08:00"
@@ -3386,7 +3386,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/jiankongbao-integration-guide"
 |2|Info|提醒|
 
 </div>
-`,S=`---
+`,A=`---
 title: "AWS EventBridge 告警事件"
 description: "通过 webhook 的方式同步 AWS EventBridge 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-08-20T10:00:00+08:00"
@@ -3491,7 +3491,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/aws-eventbridge-integration-guide
 
 </div>
 
-`,C=`---
+`,I=`---
 title: "Dynatrace 告警事件"
 description: "通过 webhook 的方式同步 Dynatrace 告警事件到 Flashduty，实现告警事件自动化降噪处理。"
 date: "2024-08-20T10:00:00+08:00"
@@ -3605,7 +3605,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dynatrace-integration-guide"
 |CUSTOM_ALERT|Info|提醒|
 
 </div>
-`,I=`---
+`,C=`---
 title: "华为云日志服务 LTS 告警事件"
 description: "通过 webhook 的方式同步华为云日志服务 LTS 告警事件到 Flashduty，实现告警事件自动化降噪处理。"
 date: "2024-08-20T10:00:00+08:00"
@@ -4059,7 +4059,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/appdynamics-integration-guide"
 |INFO|Info|提醒|
 
 </div>
-`,M=`---
+`,N=`---
 title: "SolarWinds 告警事件"
 description: "通过 webhook 的方式同步 SolarWinds 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-08-20T10:00:00+08:00"
@@ -4164,7 +4164,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/solarwinds-integration-guide"
 |Info|Info|提醒|
 
 </div>
-`,E=`---
+`,M=`---
 title: "火山引擎云监控告警事件"
 description: "通过 webhook 的方式同步火山引擎云监控告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-08-20T10:00:00+08:00"
@@ -4255,7 +4255,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-metric-integration-gui
 |通知|Info|提醒|
 
 </div>
-`,N=`---
+`,R=`---
 title: "火山引擎云监控事件中心告警事件"
 description: "通过 webhook 的方式同步火山引擎云监控事件中心告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -4344,7 +4344,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/volcengine-event-integration-guid
 |通知|Info|提醒|
 
 </div>
-`,$=`---
+`,E=`---
 title: "火山引擎日志服务 TLS 告警事件"
 description: "通过 webhook 的方式同步火山引擎日志服务 TLS 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -4616,7 +4616,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/opmanager-integration-guide"
 | Attention      | Info     | 提醒 |
 
 </div>
-`,R=`---
+`,j=`---
 title: "Meraki 告警事件"
 description: "通过 webhook 的方式同步 Meraki 告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -4692,7 +4692,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/meraki-integration-guide"
 | informational      | Info     | 提醒 |
 
 </div>
-`,z=`---
+`,$=`---
 title: "天翼云告警事件"
 description: "通过 webhook 的方式同步天翼云告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -4780,7 +4780,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/statecloud-integration-guide"
 
 
 </div>
-`,j=`---
+`,z=`---
 title: "观测云告警事件"
 description: "通过 webhook 的方式同步观测云告警事件到 Flashduty，实现告警事件自动化降噪处理"
 date: "2024-07-05T10:00:00+08:00"
@@ -5425,7 +5425,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-alert-integration-guide"
 
 当前钉钉告警集成推送到 Flashduty 的严重程度均为Warning。
 
-`,J=`---
+`,G=`---
 title: "飞书告警集成"
 description: "在 Flashduty 生成唯一的飞书机器人地址，通过飞书的方式将告警的发生与恢复同步到 Flashduty"
 date: "2025-05-19T10:00:00+08:00"
@@ -5508,7 +5508,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/feishu-alert-integration-guide"
 
 当前飞书告警集成推送到 Flashduty 的严重程度均为 Warning。
 
-`,G=`---
+`,J=`---
 title: "自定义变更事件集成指引"
 description: "通过标准协议推送自有系统变更事件到 Flashduty，大部分故障由变更导致，变更和告警事件联动有助于快速定位故障原因。"
 date: "2025-05-19T10:00:00+08:00"
@@ -5776,7 +5776,7 @@ sidebarDepth: 3
     |给同一个用户或同一个群发消息|最高频率 5 次/秒|
 
     **注意：** 超出限制后将无法正常推送消息，建议合理使用通知渠道
-`,X=`---
+`,Q=`---
 title: "钉钉集成"
 description: "通过集成钉钉自建应用，实现在钉钉端内接收和响应告警的能力"
 date: "2025-05-19T10:00:00+08:00"
@@ -5937,7 +5937,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/dingtalk-integration-guide"
 |专属版|550万次|60|     每月1日          |
 
 **注意：** 超出限制后将无法正常推送消息，建议合理使用通知渠道
-`,Y=`---
+`,X=`---
 title: "企业微信集成"
 description: "通过集成企业微信第三方应用，实现在企业微信端内接收和响应告警的能力"
 date: "2025-05-19T10:00:00+08:00"
@@ -6017,7 +6017,7 @@ url: "https://docs.flashcat.cloud/zh/flashduty/wecom-integration-guide"
 7. **故障通知失败，提示\`未开通企微许可\`？**
 
    - 联系 Flashduty 客服或专属支持，为您购买开通
-`,Q=`---
+`,Y=`---
 title: "Slack 集成"
 description: "通过集成Slack第三方应用，实现在Slack内接收和响应告警的能力"
 date: "2025-05-19T10:00:00+08:00"
@@ -6923,6 +6923,288 @@ url: "https://docs.flashcat.cloud/zh/flashduty/jira-sync"
 - Flashduty 会按照默认的字段映射以及您配置的自定义字段映射进行同步信息，如果您的 Jira 事务类型中有必选的字段且没有配置映射关系，则会遇到创建 Jira Issue 失败的情况。
 - Jira 的 Issue 详情是基于项目 KEY + 编号的格式进行访问的，如果您修改了项目 KEY，可能无法通过 Flashduty 中保存的 Issue 地址进行访问，请谨慎修改项目 KEY。
 `,ln=`---
+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  |      |
+`,dn=`---
 title: "配置通知模版"
 description: "通过自定义配置模版，可以实现个性化通知内容的需求"
 date: "2024-05-10T10:00:00+08:00"
@@ -8049,7 +8331,7 @@ msg_type 必填，值为 post
 <img src="https://download.flashcat.cloud/flashduty/changelog/20230720/email_render.png" alt="drawing" style="display: block; margin: 0 auto;" width="500"/>
 
 </div>
-`,dn=`---
+`,on=`---
 title: "Link 集成"
 description: "通过 Link 集成，可直接从故障属性、标签等信息中获取访问外部链接所需的关键参数，实现快速访问"
 date: "2025-05-19T10:00:00+08:00"
@@ -8106,4 +8388,4 @@ https://cmdb.com/vm?sn=VM123456
 1. 当引用的内容不存在时，Link 集成会正常生成对应的链接，但无法获取到值
 2. 同一个协作空间至多绑定三个 Link 集成
 3. 注意引用语法，如未按照要求进行书写引用变量，会导致无法正常获取对应值
-`,on={CustomAlert:n,Email:t,N9e:e,Prometheus:a,Grafana:s,Zabbix:i,UptimeKuma:l,AliyunARMS:d,AliyunCmEvent:o,AliyunCm:r,AliyunSLS:c,AWSCW:u,AzureMonitor:h,BaiDuBCM:p,HuaWeiCES:m,InfluxDB:g,OpenFalcon:y,PagerDuty:f,TencentBK:b,TencentCLS:v,TencentCm:w,TencentEb:_,OceanBase:k,Graylog:F,Skywalking:x,Sentry:T,Jiankongbao:A,AWSEventBridge:S,Dynatrace:C,HuaweiyunLTS:I,GoogleCM:L,Splunk:D,AppDynamics:P,SolarWinds:M,VolcEngineMetric:E,VolcEngineEvent:N,VolcEngineTLS:$,OpManager:W,Meraki:R,Zilliz:U,StateCloud:z,Guance:j,CustomChange:G,Jira:K,Lark:Z,Dingtalk:X,Wecom:Y,Slack:Q,MicrosoftTeams:nn,AlertWebhook:tn,IncidentWebhook:en,CustomAction:an,Templates:ln,HuaweiyunAPM:O,JiraSync:sn,ZStack:H,Keep:q,ElastAlert2:B,DingtalkAlert:V,FeishuAlert:J,Link:dn};module.exports=on;
+`,rn={CustomAlert:n,Email:t,N9e:e,Prometheus:a,Grafana:s,Zabbix:i,UptimeKuma:l,AliyunARMS:d,AliyunCmEvent:o,AliyunCm:r,AliyunSLS:c,AWSCW:u,AzureMonitor:h,BaiDuBCM:p,HuaWeiCES:m,InfluxDB:g,OpenFalcon:y,PagerDuty:f,TencentBK:b,TencentCLS:v,TencentCm:w,TencentEb:_,OceanBase:k,Graylog:F,Skywalking:x,Sentry:S,Jiankongbao:T,AWSEventBridge:A,Dynatrace:I,HuaweiyunLTS:C,GoogleCM:L,Splunk:D,AppDynamics:P,SolarWinds:N,VolcEngineMetric:M,VolcEngineEvent:R,VolcEngineTLS:E,OpManager:W,Meraki:j,Zilliz:U,StateCloud:$,Guance:z,CustomChange:J,Jira:K,Lark:Z,Dingtalk:Q,Wecom:X,Slack:Y,MicrosoftTeams:nn,AlertWebhook:tn,IncidentWebhook:en,CustomAction:an,Templates:dn,HuaweiyunAPM:O,JiraSync:sn,ZStack:H,Keep:q,ElastAlert2:B,DingtalkAlert:V,FeishuAlert:G,Link:on,ServiceNowSync:ln};module.exports=rn;