OpenSIS自定义开发：新增CA/Exam Marks输入功能失效求助

1. 检查函数返回的HTML结构正确性 #

确保_makeCAMarks()和_makeExamMarks()函数返回标准可输入表单控件的HTML，重点确认name属性（后端接收数据的核心标识）、控件类型与字段的匹配性，以及数据回显逻辑：

示例正确返回结构：

function _makeCAMarks($student_id, $grade_id) {
    // 从数据库获取已有分数（若存在）
    $ca_mark = DBGet(DBQuery("SELECT CA_MARKS FROM student_report_card_grades WHERE STUDENT_ID='$student_id' AND ID='$grade_id'"));
    $value = isset($ca_mark[1]['CA_MARKS']) ? $ca_mark[1]['CA_MARKS'] : '';
    // 返回带name属性的数字输入控件
    return "<input type='number' name='CA_MARKS' value='$value' class='form-control' min='0' max='100'>";
}

检查点：

• 未遗漏name属性，且属性值与数据库字段名完全一致（大小写敏感）
• 控件类型选择合理（分数用number类型更适配）
• 正确回显已有数据，避免刷新后丢失输入内容

2. 确认函数在模板中的调用逻辑 #

OpenSIS依赖模板文件渲染页面，需确保自定义函数被正确输出到表单范围内：

检查模板中的调用代码：

// 必须用echo输出函数返回的HTML，而非仅调用函数
echo _makeCAMarks($student_id, $grade_id);

检查点：

• 调用位置在<form>标签内部（不在表单内的控件无法提交）
• 未被权限判断、显示逻辑等条件语句意外屏蔽
• 函数参数传递正确（如student_id、grade_id未传空值）

3. 验证后端接收与存储逻辑 #

即使控件显示，也要确保提交时后端能正确处理数据：

检查表单处理文件（如modules/ReportCard/DoReportCard.php）：

// 安全获取POST参数，同时做SQL注入防护
$ca_marks = DBEscapeString(isset($_POST['CA_MARKS']) ? $_POST['CA_MARKS'] : '');
$exam_marks = DBEscapeString(isset($_POST['Exam_MARKS']) ? $_POST['Exam_MARKS'] : '');

// 确保更新/插入SQL包含新增字段
DBQuery("UPDATE student_report_card_grades SET CA_MARKS='$ca_marks', Exam_MARKS='$exam_marks' WHERE STUDENT_ID='$student_id' AND ID='$grade_id'");

检查点：

• 已正确获取$_POST中对应字段的值
• SQL语句包含新增字段，且字段名与数据库完全匹配
• 对输入值做了SQL注入防护（用DBEscapeString()）

4. 排查前端渲染与样式问题 #

部分情况控件已生成，但被CSS或JS隐藏：

• 打开浏览器开发者工具（F12），在Elements面板搜索CA_MARKS，确认DOM元素存在
• 检查控件的display、visibility等CSS属性，是否被设置为隐藏
• 排查页面JS代码，是否有动态移除或隐藏控件的逻辑

5. 核对数据库字段配置 #

确认student_report_card_grades表的新增字段：

• 字段名与表单、函数中的name属性完全一致（大小写敏感）
• 字段类型适配分数存储（如INT、DECIMAL(5,2)，避免用TEXT等类型）
• 字段允许为空（若设置为NOT NULL，需确保表单有默认值，否则存储失败）

内容的提问来源于stack exchange，提问作者Kei Emile Daisy