用途:从 ServiceNow 实例内操作已关联 git 仓库的 scoped 应用的源代码管理,snow_source_control 通过 /api/sn_source_control 驱动。
前置条件(缺失时会表现为工具故障):应用必须是 scoped,全局范围无法关联;应用须已在 Studio 中关联仓库(Source Control → Link to Source Control),本工具不创建关联;实例上需有 sys_repo_credential 凭据(GitHub/GitLab 用 PAT,不是密码),远程需要认证时把别名作为 credentials_alias 传入;Source Control 插件需启用且实例能出站访问远程,受限网络需 MID server,失败表现为超时而非 401。建议先验证关联:await snow_query_table({ table: "sys_app", query: "scope=x_acme_ops", fields: "sys_id,name,scope,sys_class_name" }) 与 await snow_source_control({ action: "status", app_scope: "x_acme_ops" })。
主要能力与用法:commit 与 push 是分开的两步,顺序为 status → commit(带 commit_message)→ push(带 credentials_alias)。未 push 的提交只存在于该实例。pull 把远程变更应用到工作副本,应在编辑前拉取,冲突需在 UI 中逐条解决。branch 支持 list、create、switch;切换分支会改变实例上的记录,等于该实例的工作副本,会影响其他用户,仅应在开发实例操作。stash 支持 create、apply,用于切换分支时工作副本脏的情况。diff 可传 record_sys_id 看单条记录,不传则看整个工作副本。
与更新集的关系:同一应用的产物二选一,不要同时用。源码控制以提交为单位、历史在仓库、用 git merge 合并、可检出旧提交回滚;更新集以 sys_update_xml 行为单位、历史在实例、检索时后写覆盖、可回退集合。全局范围只能走更新集。
周边 DevOps 工具 snow_track_deployment、snow_create_devops_pipeline、snow_create_devops_change、snow_get_devops_insights、snow_velocity_tracking 基于 sn_devops_* 表,只记录和报告部署,不执行部署,与是否关联仓库无关。
限制:工具描述称其路径对已发布 Source Control REST 文档是尽力而为,需在真实实例验证;status、branch list、stash list 在 REST 404 时会回退直接读取 sys_repo_status、sys_repo_branch、sys_repo_stash。建议先在未用过的实例上运行 status;若走回退路径,读操作可用,写操作需谨慎,先做一次简单提交并检查仓库再依赖 push。