Uperp 测试页面使用说明

概述

这个功能为 ERPNext 应用添加了一个测试页面，展示如何：

创建自定义页面
添加后端 API 接口
实现前后端数据交互
将页面添加到系统菜单

文件结构

后端文件

uperp/uperp/api.py - 后端 API 接口
uperp/templates/pages/test.py - 页面上下文处理
uperp/config/desktop.py - 桌面菜单配置
uperp/config/uperp.py - 模块菜单配置
uperp/hooks.py - 应用钩子配置

前端文件

uperp/templates/pages/test.html - 页面HTML模板
uperp/public/js/test-page.js - 页面JavaScript逻辑
uperp/public/css/test-page.css - 页面样式

功能特性

后端 API

get_test_data() - 获取测试数据列表
get_dashboard_stats() - 获取仪表板统计数据
test_api_connection() - 测试 API 连接
has_app_permission() - 权限检查

前端功能

响应式数据统计卡片
可交互的数据表格
数据刷新和导出功能
API 连接测试
美观的用户界面

访问方式

1. 通过URL直接访问

http://your-erpnext-site/test

2. 通过系统菜单访问

登录 ERPNext 系统
在应用列表中找到 "Uperp" 应用
点击进入查看测试页面

3. 通过模块菜单访问

进入 ERPNext 桌面
找到 "Uperp" 模块
在模块菜单中点击 "测试页面"

安装和配置

1. 安装应用

cd /path/to/your/bench
bench get-app /path/to/uperp
bench install-app uperp

2. 重启服务

bench restart

3. 清除缓存

bench clear-cache
bench clear-website-cache

开发说明

修改数据源

在 uperp/uperp/api.py 中的 get_test_data() 函数可以修改数据源：

# 从数据库获取真实数据
test_data = frappe.get_all("YourDocType",
                          fields=["name", "description", "status"],
                          limit=10)

添加新的API接口

在 api.py 文件中添加新的函数并使用 @frappe.whitelist() 装饰器：

@frappe.whitelist()
def your_new_api():
    # 你的逻辑
    return {"success": True, "data": "your_data"}

修改页面样式

编辑 uperp/public/css/test-page.css 文件来调整页面样式。

添加新功能

在 uperp/public/js/test-page.js 中添加新的JavaScript函数。

故障排除

1. 页面无法访问

检查应用是否正确安装
确认 bench 服务正在运行
清除缓存后重试

2. API调用失败

检查API函数是否添加了 @frappe.whitelist() 装饰器
确认函数路径正确
查看浏览器开发者工具的网络请求

3. 样式问题

确认CSS文件路径正确
检查hooks.py中的样式文件配置
清除浏览器缓存

4. JavaScript错误

打开浏览器开发者工具查看控制台错误
确认JS文件路径正确
检查frappe对象是否可用

扩展建议

添加数据编辑功能
实现数据筛选和搜索
添加图表展示
实现实时数据更新
添加数据导入功能

TEST_PAGE_README.md 3.0 KB 永久链接 文件历史 原始文件