SuperAPI AI 工具集

fluent-brownfield-migration

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:将只存在于实例上的 scoped app 迁移到由 git 管理的 ServiceNow SDK(Fluent)项目,先做到零功能变更,再逐表转换为 TypeScript。基于 @servicenow/sdk 4.x(now-sdk CLI)。snow_fluent_* 工具仅在本地 stdio 运行的 MCP 服务器中可用;通过托管 HTTP 传输时不可调用,应改用 git + CI 流程。

主要能力与用法:

  1. 先原样拉取:now-sdk init --from <sys_id> 默认不生成 Fluent 代码,记录以 XML 存于 metadata/,此时应用无任何变化,可立即提交基线、构建并安装。
  2. 增量转换:用 now-sdk transform --table <表名> 逐表转换,转换后文件进入 generated/。每步务必立即 snow_fluent_build,修复后提交,避免一次性全量转换。全量转换会产生不可审查的扁平输出、未知实例字段导致构建失败、表单布局重复等问题。
  3. 优先级规则:同一记录同时存在 XML 与 Fluent 时 XML 生效,需确认 XML 已从 metadata/ 移除;构建时用 --errorOnConflict 使冲突致命,CI 中用 --frozenKeys 检测 keys.ts 过期。
  4. 适合早转换:Table、BusinessRule、Acl、ClientScript、ScriptInclude、UiAction、Role、Property、ScheduledScript、RestApi。表单需 SDK ≥4.6 且注意重复转换问题;Flow 仍成熟中。Workflow、报表、PA、UI 宏/脚本、处理器、调度、数据源建议保留 XML。
  5. ES5 规则仅适用于实例 Rhino 上执行的脚本体;Fluent DSL 本身须用现代 TypeScript。
  6. 迁移期间用 now-sdk download <目录> --incremental 拉取实例变更,评审 diff 后再继续转换,避免覆盖同事工作。安装绕过 update set 且无回滚,reinstall 是唯一且破坏性的回滚方式,安装仅限 dev/test,生产走 App Repository。

限制与注意事项:keys.ts 必须提交,否则下次安装会产生重复记录;仓库需提交 now.config.json、metadata/、src/、keys.ts、package.json;构建后工作区应保持干净。全局 app 转换自 SDK 4.4.0 起支持(需 Australia 版本实例),属高级用法,scoped app 是成熟路径。资料未提供收费、价格或平台支持信息。