4. 源系统分析（二）：ITSM服务台系统（ServiceNow/Jira）的工单数据模型与API

在事故响应台账跨系统同步中，ITSM服务台系统（以ServiceNow和Jira Service Management为代表）是事故工单的核心生产源。理解其工单数据模型与API能力，是设计同步映射规则、评估增量拉取策略、处理状态机冲突的前提。本节将分别拆解两大平台的核心表结构、关键字段语义及REST API调用模式。

4.1 ServiceNow 工单数据模型核心

ServiceNow采用CMDB驱动的表继承体系，事故（Incident）表 incident 是核心基表 task 的子表。同步关注的核心字段如下：

4.2 Jira Service Management 工单数据模型核心

Jira采用Issue模型，事故对应Issue Type = "Incident"。核心字段通过自定义字段（Custom Field）扩展，同步需关注以下结构：

4.3 数据模型对比与映射策略

下表列出两个平台在同步映射时的核心差异点及应对策略：

4.4 REST API 调用模式与限流策略

两个平台均提供RESTful API用于工单数据拉取。以下是核心API端点及调用注意事项：

4.4.1 ServiceNow REST API

• 表查询API： GET /api/now/table/incident
• 增量查询参数： sysparm_query=sys_updated_on>=2024-01-01 00:00:00^ORDERBYsys_updated_on
• 分页控制： sysparm_limit=1000 + sysparm_offset=0（最大偏移量建议不超过10000）
• 限流阈值： 默认每分钟600次请求（可协商提升）

4.4.2 Jira REST API

• 搜索API： GET /rest/api/3/search
• JQL增量查询： jql=updated >= '2024-01-01 00:00' AND issuetype = Incident ORDER BY updated ASC
• 分页控制： maxResults=100 + startAt=0（单次最大100条）
• 限流阈值： 按用户/按IP，通常为每分钟100-200次（需确认Jira实例配置）

4.5 增量同步游标设计

基于上述API特性，设计统一的增量同步游标方案：

-- 台账增量同步游标表结构（示例）
CREATE TABLE sync_cursor (
    source_system     VARCHAR(32)   NOT NULL,  -- 'servicenow' 或 'jira'
    cursor_field      VARCHAR(64)   NOT NULL,  -- 'sys_updated_on' 或 'updated'
    cursor_value      DATETIME(3)   NOT NULL,  -- 上次成功同步的最大时间戳
    batch_size        INT           DEFAULT 1000,
    retry_count       INT           DEFAULT 0,
    last_sync_time    DATETIME(3),
    PRIMARY KEY (source_system, cursor_field)
);

-- 每次同步前读取游标
SELECT cursor_value FROM sync_cursor 
WHERE source_system = 'servicenow' AND cursor_field = 'sys_updated_on';

-- 同步完成后更新游标
UPDATE sync_cursor 
SET cursor_value = '2024-06-15 14:30:00.123',
    last_sync_time = NOW()
WHERE source_system = 'servicenow' AND cursor_field = 'sys_updated_on';

4.6 数据模型与API架构总览

下图展示从源系统数据模型到同步中间件的整体架构，突出核心字段映射与API调用路径：

4.7 状态机映射表设计

由于两个平台的状态定义不同，同步时必须维护一张状态映射表，将源系统状态转换为台账统一状态：

-- 状态映射表示例（JSON格式存储于配置表）
{
  "servicenow": {
    "1": "open",       // 新建 → 待处理
    "2": "in_progress",// 处理中 → 处理中
    "3": "on_hold",    // 等待 → 挂起
    "6": "resolved",   // 已解决 → 已解决
    "7": "closed"      // 已关闭 → 已关闭
  },
  "jira": {
    "10000": "open",        // 待办 → 待处理
    "10001": "in_progress", // 处理中 → 处理中
    "10002": "on_hold",     // 阻塞 → 挂起
    "10003": "resolved",    // 已解决 → 已解决
    "10004": "closed"       // 已关闭 → 已关闭
  }
}