用途:该技能用于配置 ServiceNow 表单与列表的布局与外观,即表单上有哪些字段、字段顺序与所属分节,以及列表显示哪些列。它不涉及表单行为(字段变化时发生什么),那属于 ui-actions-policies。
视图优先:几乎每张相关表都有 view 字段,需先确定视图。空字符串 "" 是默认视图(所有人可见),"mobile"、"ess" 或自定义名称是同一表上的独立布局,编辑一个不影响其它。常见错误是把改动落在无人查看的视图上,或意外破坏全公司的表单。
字段须先存在:sys_ui_element 与 sys_ui_list_element 仅以字符串保存字段名,平台与工具均不校验列是否存在于 sys_dictionary。放置不存在的字段会生成静默不渲染的布局行。放置前可先调用 snow_discover_table_fields 检查。列表上的点走列(如 caller_id.department)路径必须可解析,否则列为空。
表单结构:sys_ui_form 是 (table, view) 的表单布局容器,下含 sys_ui_section(分节,含标题与位置),再下含 sys_ui_element(分节内单个字段与位置)。应从容器向外构建:snow_create_form_layout、snow_create_form_section、snow_add_form_field。布局的 type 可为 standard、related_list 或 split;position 是排序提示而非索引,建议留间隔(100、200、300)。一个字段在一个视图中只能出现在一个分节,加入第二个分节不会移动它,而是产生重复行和不可预测的渲染。
列表:"list" 指两种不同对象。列表布局由 sys_ui_list 加 sys_ui_list_element 组成,决定表显示哪些列;相关列表由 sys_ui_related_list 组成,决定表单下方出现哪些子表。列可用 snow_add_list_column 单列加入默认布局,或用 snow_create_list_layout 一次性创建整个布局。snow_create_list_view 作用不同:它创建具名视图(sys_ui_list),含逗号连接的字段列表和可选默认筛选,供用户切换到预设列集,不改动默认视图。相关列表通过子表上指向父表的字段寻址,即 relationship_field;省略时 ServiceNow 会寻找常规引用。相关列表按(父表, 视图)划分,加入默认视图不会出现在移动端。
保存筛选器:snow_create_saved_filter 的 filter 是编码查询(与 snow_query_table 语法相同)。user 留空为全局筛选,设置则为个人筛选;roles 限制下拉可见性,属可见性而非安全,返回行仍受 ACL 限制。
导航:两个导航工具都写入 sys_app_module。snow_create_menu 并不创建应用菜单——应用菜单是 sys_app_application 记录——它创建的是模块,与 snow_create_menu_item 相同。要把项目挂在已有菜单下,用 snow_create_menu_item 并以应用菜单的 sys_id 作 parent。要真正创建新应用菜单,两个工具都不行,需用 snow_record_manage 直接创建 sys_app_application 记录并将其 sys_id 作为 parent。snow_create_menu 会产生无父模块,无害但不是菜单。link_type 可为 list、new、detail 或 home;列表模块遵循表的默认视图,除非其自身筛选另有说明。
配置与更新集:sys_ui_form、sys_ui_section、sys_ui_element、sys_ui_list、sys_ui_list_element、sys_ui_related_list、sys_filter 和 sys_app_module 都会被捕获进更新集。更改布局前应启动更新集(参见 update-set-workflow),否则更改在下一个实例上不可复现。相关主题还包括 ui-actions-policies 与 blast-radius。