用途:在编写查询、脚本或集成前,系统性地了解 ServiceNow 的表、字段、类型与引用关系,避免凭猜测使用不熟悉的表。
主要能力:按分类列出可用表(core_itsm、cmdb、service_catalog、security、system、custom);获取表完整字段定义(字段名、标签、类型、长度、是否必填、引用目标、默认值、是否选项);深层发现父表/子表继承、引用、Glide List、Document ID 关系;解释字段含义;查询选项值(sys_choice);并可按模板整理成表结构文档。
使用方式:文档给出两类途径。MCP 工具包括 SN-List-Available-Tables、SN-Get-Table-Schema、SN-Discover-Table-Schema、SN-Explain-Field、SN-Query-Table,带对应参数如 table_name、include_relationships、depth。REST API 通过 GET /api/now/table/sys_db_object、sys_dictionary、sys_choice、sys_documentation、sys_glide_object 查询。示例:GET /api/now/table/sys_dictionary?sysparm_query=name=incident^internal_type!=collection&sysparm_fields=element,column_label,internal_type,max_length,mandatory,reference。
适用场景:开发、管理与集成人员在处理不熟悉的 ITSM、CMDB、服务目录、权限或自定义应用(x_ 前缀)表时使用。
限制与前提:需要 admin 或 personalize_dictionary 角色,并具备 sys_dictionary、sys_db_object、sys_documentation 读权限;缺少权限会返回 403,可改用表 API 配合 sysparm_display_value=all。字段可能继承自父表,仅在子表查询会遗漏;引用字段默认可能返回 sys_id,需加显示值参数;选项字段可能使用 choice set,sys_choice 可能为空。技能还提示表结构因实例定制而异,建议先在开发实例验证并缓存结果。