用途:本技能说明读取 ServiceNow Table API(/api/now/table/{table})记录时,不同工具会返回不同结构、不同内容策略,帮助在依据字段内容做判断前正确解读结果。
主要工具差异:snow_query_table 默认 sysparm_display_value 为 false,长字段默认截断(truncate_output 默认为 true):字段名含 template、script、description、comments、work_notes 等关键词的字符串在 200 字符处截断,其余字符串超过 400 字符也截断到 200,结果值带 [truncated, N chars total] 标记;truncated 字段只是回显参数,不代表确实发生截断。其 total 与 has_more 是猜测值,total 在整页返回时固定为 "100+ ",不要用于报告或分支判断,真实计数可用 snow_aggregate_metrics 或 snow_record_manage 的 query(读取 X-Total-Count)。snow_record_manage 默认 display_value 为 all,字段均为 {display_value, value} 对象,未指定 fields 时使用硬编码预设,且 sys_id 可能返回空串。snow_get_by_sysid 不截断、不注入 sys_id,404 返回 success: true 与 found: false。
使用方式:读取正文内容时关闭截断,如 snow_query_table({ table: "sys_script", query: "...", fields: [...], truncate_output: false });需要显示值与人可读时用 display_value: true,但该值不能回写或用于查询条件。snow_record_manage 的 fields 需用逗号分隔字符串并显式包含 sys_id。
限制:journal 字段(comments、work_notes)默认返回空字符串,需显示值加关闭截断,或改用 snow_get_journal_entries;该工具不排序、按 name=<table> 过滤,旧数据可能挂在 task 表下,其 sys_created_on 为本地时区。snow_pull_artifact 仅覆盖 sp_widget、sys_script_include、sys_ux_page、sys_hub_flow,且属 permission: "write",stdio 下会写文件到 output_dir。ACL 会静默过滤行。其余细节暂未提供。