xinli/z_Project change/进度汇总/15-新量表导入完整操作指南.md
2025-11-12 15:25:47 +08:00

14 KiB
Raw Blame History

新量表导入完整操作指南

📋 概述

本文档详细说明如何将一个新的心理量表完整导入到系统中,包括所有必要的配置步骤。

🎯 导入流程概览

1. 创建量表基本信息
   ↓
2. 添加题目(题目管理)
   ↓
3. 为每个题目添加选项(选项管理)
   ↓
4. 添加因子(因子管理)
   ↓
5. 配置因子计分规则(计分规则管理)
   ↓
6. 配置结果解释(解释配置)
   ↓
7. 配置预警规则(可选,预警规则配置)
   ↓
8. 启用量表并测试

📝 详细操作步骤

步骤1创建量表基本信息

路径心理测评管理量表管理

操作步骤

  1. 点击 "新增" 按钮
  2. 填写量表基本信息:
    • 量表编码:唯一标识,如 SCL_90EPQ_001(必填)
    • 量表名称:如 症状自评量表SCL-90(必填)
    • 量表类型:选择类型(情绪、人格、行为等)
    • 量表简介:简短介绍
    • 量表描述:详细描述
    • 题目数量:预计题目数(如 90
    • 预计完成时间:分钟数(如 30
    • 适用人群:如 一般人群青少年
    • 作者:量表作者
    • 来源:量表来源
    • 状态:选择 正常(启用)或 停用
  3. 点击 "确定" 保存

注意事项

  • 量表编码必须唯一
  • 状态选择 正常 后,量表才会在测评选择页面显示
  • 题目数量可以后续修改

步骤2添加题目题目管理

路径心理测评管理量表管理 → 点击量表行的 "题目管理" 按钮

操作步骤

  1. 在量表列表中找到刚创建的量表
  2. 点击该行的 "题目管理" 按钮
  3. 进入题目管理页面后,点击 "新增" 按钮
  4. 填写题目信息:
    • 题目序号:如 123...(必填,用于排序)
    • 题目内容:题目的完整文字内容(必填)
    • 题目类型:选择 单选题多选题
    • 是否必答:选择
    • 排序:数字越小越靠前(可选)
  5. 点击 "确定" 保存
  6. 重复步骤3-5添加所有题目

批量添加技巧

  • 可以一次性添加多个题目,然后逐个配置选项
  • 建议先添加所有题目,再统一配置选项

注意事项

  • 题目序号建议连续从1开始
  • 题目内容支持富文本(如果需要)
  • 题目类型决定了后续选项的配置方式

步骤3为每个题目添加选项选项管理

路径:在题目管理页面,点击题目行的 "选项管理" 按钮

操作步骤

  1. 在题目列表中,找到要配置选项的题目
  2. 点击该行的 "选项管理" 按钮
  3. 在弹出的对话框中,点击 "新增" 按钮
  4. 填写选项信息:
    • 选项编码:如 ABCD1234(必填)
    • 选项内容:选项的文字内容(必填)
    • 选项分数:该选项对应的分数(必填,如 0123
    • 排序:数字越小越靠前(可选)
  5. 点击 "确定" 保存
  6. 重复步骤3-5为该题目添加所有选项
  7. 点击对话框的 "关闭" 按钮
  8. 重复步骤1-7为所有题目配置选项

选项配置示例

单选题示例(如焦虑自评量表):

  • 选项A没有或很少时间分数1
  • 选项B小部分时间分数2
  • 选项C相当多时间分数3
  • 选项D绝大部分或全部时间分数4

多选题示例(如症状自评量表):

  • 选项A没有分数0
  • 选项B很轻分数1
  • 选项C中等分数2
  • 选项D偏重分数3
  • 选项E严重分数4

注意事项

  • 选项编码在同一题目内必须唯一
  • 选项分数用于后续计分,必须准确
  • 单选题通常每个选项对应一个分数
  • 多选题可能需要累加分数或取最高分

步骤4添加因子因子管理

路径心理测评管理量表管理 → 点击量表行的 "因子管理" 按钮

操作步骤

  1. 在量表列表中找到量表
  2. 点击该行的 "因子管理" 按钮
  3. 进入因子管理页面后,点击 "新增" 按钮
  4. 填写因子信息:
    • 因子编码:如 F1F2F3躯体化强迫等(必填)
    • 因子名称:如 躯体化因子强迫症状因子(必填)
    • 因子描述:因子的详细说明(可选)
    • 排序:数字越小越靠前(可选)
  5. 点击 "确定" 保存
  6. 重复步骤3-5添加所有因子

因子配置示例如SCL-90量表

  • 因子1躯体化
  • 因子2强迫症状
  • 因子3人际关系敏感
  • 因子4抑郁
  • 因子5焦虑
  • 因子6敌对
  • 因子7恐怖
  • 因子8偏执
  • 因子9精神病性

注意事项

  • 因子编码在同一量表内必须唯一
  • 因子用于后续的计分规则配置和结果解释
  • 如果量表没有因子(只有总分),可以跳过此步骤

步骤5配置因子计分规则计分规则管理

路径:在因子管理页面,点击因子行的 "计分规则" 按钮

操作步骤

  1. 在因子列表中,找到要配置计分规则的因子
  2. 点击该行的 "计分规则" 按钮
  3. 在弹出的对话框中,点击 "新增规则" 按钮
  4. 在表格中配置规则:
    • 题目:从下拉框中选择题目(显示题目序号和内容)
    • 选项:从下拉框中选择选项(多选,可选,留空表示所有选项)
    • 权重该规则在计分中的权重0-10默认1.00
    • 计算方式:选择 求和平均最大最小
  5. 重复步骤3-4为该因子添加所有计分规则
  6. 点击 "保存" 按钮保存所有规则
  7. 重复步骤1-6为所有因子配置计分规则

计分规则配置示例

示例1简单求和如SCL-90的躯体化因子

  • 规则1题目1 → 所有选项 → 权重1.00 → 计算方式:求和
  • 规则2题目4 → 所有选项 → 权重1.00 → 计算方式:求和
  • 规则3题目12 → 所有选项 → 权重1.00 → 计算方式:求和
  • ...(包含所有属于该因子的题目)

示例2加权求和(如某些量表的因子):

  • 规则1题目1 → 选项A,B → 权重2.00 → 计算方式:求和
  • 规则2题目2 → 所有选项 → 权重1.00 → 计算方式:求和

注意事项

  • 计分规则决定了因子分数的计算方式
  • 如果某个题目属于多个因子,需要为每个因子都配置规则
  • 计算方式:
    • 求和:所有选中选项的分数之和 × 权重
    • 平均:所有选中选项的分数平均值 × 权重
    • 最大:所有选中选项的分数最大值 × 权重
    • 最小:所有选中选项的分数最小值 × 权重

步骤6配置结果解释解释配置

路径心理测评管理解释配置

操作步骤

  1. 进入解释配置页面
  2. 点击 "新增" 按钮
  3. 填写解释信息:
    • 量表:从下拉框中选择量表(可选,留空表示通用解释)
    • 因子:从下拉框中选择因子(可选,留空表示总体解释;需先选择量表)
    • 分数下限:该解释适用的最低分数(必填)
    • 分数上限:该解释适用的最高分数(必填)
    • 等级:如 (可选)
    • 等级名称:如 轻度中度重度(可选)
    • 解释标题:解释的标题(必填)
    • 解释内容:详细的解释说明(可选)
    • 建议指导:针对该分数段的建议或指导(可选)
    • 排序:数字越小越靠前(可选)
  4. 点击 "确定" 保存
  5. 重复步骤2-4为所有分数段配置解释

结果解释配置示例如SCL-90的躯体化因子

  • 解释1量表=SCL-90因子=躯体化,分数范围=0-10等级=低,解释标题="正常范围"
  • 解释2量表=SCL-90因子=躯体化,分数范围=11-20等级=中,解释标题="轻度症状"
  • 解释3量表=SCL-90因子=躯体化,分数范围=21-30等级=高,解释标题="中度症状"
  • 解释4量表=SCL-90因子=躯体化,分数范围=31-40等级=高,解释标题="重度症状"

注意事项

  • 分数范围不能重叠(系统会根据分数自动匹配解释)
  • 可以为量表总体配置解释(因子留空)
  • 可以为特定因子配置解释(选择因子)
  • 可以为通用情况配置解释(量表和因子都留空)

步骤7配置预警规则可选

路径心理测评管理预警规则配置

操作步骤

  1. 进入预警规则配置页面
  2. 点击 "新增" 按钮
  3. 填写预警规则信息:
    • 量表:从下拉框中选择量表(必填)
    • 因子:从下拉框中选择因子(可选,留空表示针对总分)
    • 规则名称:如 重度抑郁预警(必填)
    • 预警等级:选择 紧急(必填)
    • 分数下限:触发预警的最低分数(可选)
    • 分数上限:触发预警的最高分数(可选)
    • 百分位下限:触发预警的最低百分位(可选)
    • 百分位上限:触发预警的最高百分位(可选)
    • 自动解除:是否自动解除预警(可选)
    • 解除条件:自动解除的条件(可选)
    • 状态:选择 正常(启用)或 停用
  4. 点击 "确定" 保存
  5. 重复步骤2-4配置所有预警规则

预警规则配置示例

  • 规则1量表=SCL-90因子=抑郁,预警等级=高,分数范围=30-40状态=正常
  • 规则2量表=SCL-90因子=焦虑,预警等级=紧急,分数范围=35-40状态=正常

注意事项

  • 预警规则用于在测评结果异常时自动向管理员发出警告
  • 可以针对特定因子配置,也可以针对总分配置
  • 预警等级决定了警告的严重程度
  • 只有状态为 正常 的规则才会生效

步骤8启用量表并测试

操作步骤

  1. 返回 量表管理 页面
  2. 确认量表状态为 正常(如果为 停用,点击修改改为 正常
  3. 确认所有配置已完成:
    • 量表基本信息已填写
    • 题目已添加至少1题
    • 每个题目都有选项至少1个选项
    • 因子已添加(如果有因子)
    • 因子计分规则已配置(如果有因子)
    • 结果解释已配置至少1条
  4. 测试量表:
    • 进入 测评管理开始测评
    • 选择刚创建的量表
    • 填写被测评人信息
    • 开始答题,完成所有题目
    • 提交测评
    • 查看生成的报告,验证:
      • 分数计算是否正确
      • 因子分数是否正确(如果有因子)
      • 结果解释是否正确显示
      • 预警是否正常触发(如果配置了预警规则)

📊 配置检查清单

在完成量表导入后,使用以下清单检查配置是否完整:

基本信息

  • 量表编码已填写且唯一
  • 量表名称已填写
  • 量表状态为 正常
  • 题目数量与实际题目数一致

题目配置

  • 至少添加了1个题目
  • 所有题目都有题目序号
  • 所有题目都有题目内容
  • 题目类型已选择(单选/多选)

选项配置

  • 每个题目至少添加了1个选项
  • 所有选项都有选项编码
  • 所有选项都有选项内容
  • 所有选项都有选项分数

因子配置(如果有因子)

  • 至少添加了1个因子
  • 所有因子都有因子编码
  • 所有因子都有因子名称

计分规则配置(如果有因子)

  • 每个因子至少配置了1条计分规则
  • 计分规则中的题目都已选择
  • 计分规则中的权重已设置
  • 计分规则中的计算方式已选择

结果解释配置

  • 至少配置了1条结果解释
  • 结果解释的分数范围已设置
  • 结果解释的解释标题已填写
  • 结果解释的解释内容已填写(建议)

预警规则配置(可选)

  • 预警规则已配置(如果需要)
  • 预警规则的量表已选择
  • 预警规则的预警等级已选择
  • 预警规则的状态为 正常

🔍 常见问题

Q1量表创建后在测评选择页面看不到

A:检查以下几点:

  • 量表状态是否为 正常
  • 量表是否有至少1个题目
  • 刷新浏览器页面

Q2题目添加后选项管理按钮点击没反应

A:检查以下几点:

  • 题目是否已保存
  • 浏览器控制台是否有错误
  • 尝试刷新页面

Q3因子计分规则配置后分数计算不正确

A:检查以下几点:

  • 选项分数是否正确
  • 计分规则中的题目是否选择正确
  • 计分规则中的计算方式是否合适
  • 权重设置是否正确

Q4结果解释不显示

A:检查以下几点:

  • 是否配置了结果解释
  • 结果解释的分数范围是否覆盖了实际分数
  • 结果解释的量表和因子是否匹配

Q5预警规则不触发

A:检查以下几点:

  • 预警规则的状态是否为 正常
  • 预警规则的分数范围是否设置正确
  • 测评结果是否满足预警条件

📚 相关文档


完成标志

当以下所有条件满足时,量表导入完成:

  1. 量表在测评选择页面可以正常选择
  2. 可以正常开始测评并答题
  3. 提交测评后可以正常生成报告
  4. 报告中的分数计算正确
  5. 报告中的结果解释正确显示
  6. 预警规则正常触发(如果配置了)

最后更新2025-11-06