umbraco-validation-checks

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Umbraco Extension Validation Checks

Umbraco扩展验证检查清单

Reference skill containing validation checks for manual browser testing of Umbraco backoffice extensions. Load this skill before beginning validation testing.

本参考指南包含用于手动浏览器测试Umbraco后台扩展的验证检查项。请在开始验证测试前先了解这份指南。

Check Categories

检查类别

Category	File	Checks
Configuration	`configuration-checks.md`	VC-1 to VC-2
Navigation	`navigation-checks.md`	VN-1 to VN-3
API Debugging	`api-debugging-checks.md`	VA-1 to VA-3
Form Controls	`form-control-checks.md`	VF-1 to VF-2
Workspace	`workspace-checks.md`	VW-1 to VW-3

类别	文件	检查项
配置	`configuration-checks.md`	VC-1 至 VC-2
导航	`navigation-checks.md`	VN-1 至 VN-3
API调试	`api-debugging-checks.md`	VA-1 至 VA-3
表单控件	`form-control-checks.md`	VF-1 至 VF-2
工作区	`workspace-checks.md`	VW-1 至 VW-3

Quick Reference

快速参考

ID	Check	Common Symptom
Configuration
VC-1	Section Permissions	New section not visible
VC-2	User Group Access	Extension appears for some users only
Navigation
VN-1	Tree Complexity	Tree not rendering or items missing
VN-2	Hidden Tree Actions	Cannot find expected button/action
VN-3	Menu Item Visibility	Menu items not appearing
API Debugging
VA-1	400 Error Investigation	API calls failing silently
VA-2	Request Payload Validation	Wrong data structure being sent
VA-3	CORS and Auth Issues	Requests blocked or unauthorized
Form Controls
VF-1	Select/Combobox Behavior	Select not populating and causing 400 errors
VF-2	Input Binding Issues	Values not updating or saving
Workspace
VW-1	Missing Save Button	Editable workspace has no Save button
VW-2	Data Not Loading	Workspace opens but shows empty values
VW-3	Submit Not Working	Save clicked but nothing happens

ID	检查项	常见症状
配置
VC-1	章节权限	新章节不可见
VC-2	用户组访问权限	扩展仅对部分用户可见
导航
VN-1	树结构复杂度	树结构未渲染或项目缺失
VN-2	隐藏的树操作按钮	无法找到预期的按钮/操作
VN-3	菜单项可见性	菜单项未显示
API调试
VA-1	400错误排查	API调用静默失败
VA-2	请求负载验证	发送了错误的数据结构
VA-3	CORS与权限问题	请求被拦截或未授权
表单控件
VF-1	选择器/组合框行为	选择器未填充数据并导致400错误
VF-2	输入绑定问题	值未更新或保存
工作区
VW-1	缺少保存按钮	可编辑工作区无保存按钮
VW-2	数据未加载	工作区打开但显示空值
VW-3	提交功能失效	点击保存但无任何反应

Usage

使用方法

Always load this skill before starting manual browser validation.

Read all check files when validating a new extension, or focus on specific categories based on the symptoms you observe.

Symptom	Load Files
"Can't see my extension"	configuration-checks, navigation-checks
"API not working"	api-debugging-checks
"Form doesn't work"	form-control-checks
"Tree issues"	navigation-checks
"Workspace issues"	workspace-checks
"No Save button"	workspace-checks

开始手动浏览器验证前，请务必先了解这份指南。

验证新扩展时请阅读所有检查项文件，或根据观察到的症状重点查看特定类别。

症状	查看文件
"无法看到我的扩展"	configuration-checks, navigation-checks
"API无法正常工作"	api-debugging-checks
"表单无法正常工作"	form-control-checks
"树结构问题"	navigation-checks
"工作区问题"	workspace-checks
"无保存按钮"	workspace-checks

Validation Workflow

验证工作流

Before testing: Ensure the extension is built and the browser cache is cleared
Check DevTools Console: Open Chrome DevTools (F12) before interacting
Check Network tab: Filter by
```
Fetch/XHR
```
to see API calls
Read relevant check files based on what you observe

测试前：确保扩展已构建完成，且浏览器缓存已清除
检查DevTools控制台：在进行操作前打开Chrome DevTools（F12）
检查网络标签页：通过
```
Fetch/XHR
```
筛选查看API调用
根据观察结果阅读相关检查项文件

Capturing New Issues

记录新问题

When you encounter a validation issue not covered by existing checks:

Log it immediately in
```
discovered-issues.md
```
Include: symptom, root cause, solution, suggested category
Issues will be reviewed and promoted to proper checks

This compounds knowledge over time - every validation session improves future sessions.

当遇到现有检查项未覆盖的验证问题时：

立即记录到
```
discovered-issues.md
```
中
包含内容：症状、根本原因、解决方案、建议归类的类别
问题将被审核并添加到正式检查项中

这会逐步积累知识——每次验证会话都会优化未来的测试工作。

Pattern Area	Skill
Tree implementation	`umbraco-tree`
Section setup	`umbraco-sections`
API client setup	`umbraco-openapi-client`
Workspace structure	`umbraco-workspace`

模式领域	指南
树结构实现	`umbraco-tree`
章节设置	`umbraco-sections`
API客户端设置	`umbraco-openapi-client`
工作区结构	`umbraco-workspace`