原文:《ITSM 平台怎么接入现有系统:服务门户、API 对接与流程集成的实施要点》

ITSM(IT Service Management,IT 服务管理)平台上线后,决定使用率的往往不是工单功能本身,而是它能否接进员工已在用的入口与系统。入口不通,用户仍会绕过流程直接找人;数据不通,工单进度就要靠人工来回同步。闪扬科技资料中同时留存《ITSM服务管理系统API接口》《itsmAPI》与《企业智能化信息和流程管理平台 功能清单》,把「怎么进」「怎么传」「怎么配」拆成三份可核对的依据。集成顺序建议从入口开始,而不是从接口参数开始。

一、先定入口:服务门户与服务目录

功能清单把 IT 服务门户放在 IT 管理场景首位:流程申报和查询、访问知识库和公告、支持定义服务目录、按分类提供服务流程入口,并可按组织授权访问权限。关键是「按分类」与「按组织」——用户不必先知道该找哪个部门,只需选择服务类型,系统再依据服务目录把请求导向对应流程。流程名称、运营时间关联、服务级别关联也在此层定义,入口确定后计时与分派才有依据。移动端适配同属入口范畴,资料列出微信服务号、企业号、钉钉等应用接入方式。

二、再定数据:接口对接与工单状态同步

接口层面解决「已有系统如何落单、工单状态如何回传」。《ITSM服务管理系统API接口》与《itsmAPI》对应这一层。实施时先约定三件事:由哪一方作为工单创建源、字段映射如何对应(系统类型、事件级别、联系人等)、状态回传的触发时点与失败重试规则。字段映射不统一,后续报表口径就会分叉;状态只单向推送,用户在原系统里仍看不到进度。接口文档还应有必填字段、重复提交判定、附件传递方式等边界说明,联调前确认比上线后逐条补省事。本文不列举具体路径与参数,以接口文档版本为准。

三、流程与通知:把集成落在可配置的引擎上

功能清单的平台底层引擎列出流程图设计与多版本管理,受理、搁置、退回、撤回、终止等特殊动作;流程规则引擎支持按组、按人、按业务分类、项目、值班组流转;通知引擎覆盖站内信、邮件与移动端;自动化引擎支持定时触发动作,例如服务级别超时转派、超时自动关单。集成真正要复用的是这些可配置能力,而非为每个外部系统单独写一套逻辑。同一请求从门户进入、经规则引擎分派、由通知引擎推送进度、必要时超时升级,整条链路在配置层完成。

写在最后

集成的目标不是把系统连起来,而是让入口、数据与流程口径保持一致。建议按「服务门户与目录 → 字段映射与状态回传 → 流程与通知规则 → 组织数据与初始化」推进,每阶段留一份可核对的映射表。边界条件先写清楚,后续扩展才不必反复改接口。