量表测评记录管理

量表测评记录列表: /questionnaireSubmissions GET

请求参数

参数名 示列值 类型 必须 说明
page 1 number 否 当前页数
pageSize 10 number 否 每页条数
memberId 1 number 否 用户id
organizationId 1 number 否 组织id
questionnaireId 1 number 否 量表id
validityStatus 1 number 否 效度状态(1=有效, 2=无效)
reviewStatus 1 number 否 审核状态(1=已审核,2=未审核)
evaluationType 1 number 否 测评渠道,0=无,1=团队,2=院内,3=线上
commentId 1 number 否 维度结果id
userName xxx string 用户姓名
mobile 15803420223 string 手机号
teamId "{1,2}" string 团队id
sort -createdAt string 否 排序。多个排序字段用,号隔开。sort=-a,b
expand 'member' string 否 获取指定子资源数据 'member,questionnaire,questionnaire.category,organization,questionnaire.questionnaireSets,answerSets.answers,answerSets.personalInfoAnswers,resultSets,resultSets.results,resultSets.resultSetSummary,resultSets.resultSetAssessments'
attributes "id,name" string 否 本资源的字段。不定义该字段时返回所有字段；空数组不返回字段

返回参数

参数名 示列值 说明
page 1 当前页数
pageSize 10 每页条数
limit 10 同 pageSize
offset 2 起始条数
total 3231 符合条件的总数量
items [{ "id": 4, "name": "test2"] 返回数据项
参数名 示列值 类型 说明
id 1 number id
memberEvaluationId 1 number 测评记录分发id
organizationId 1 number 来源组织id,0=云医后台
questionnaireId 1 numbe 量表id
memberId 1 number 患者用户id
startedAt 0 number 开始答题时间
endedAt 0 number 结束答题时间
status 1 number 状态, 1=已完成, 2=进行中
reportPdfUrl "" string 测评报告PDF地址
alarmLevel 1 number 预警等级,0=无,1=轻,2=中,3=重,4=结果无效
reviewStatus 1 number 审核状态, 0=无, 1=已审核, 2=未审核
validityStatus 1 number 效度状态, 0=无, 1=有效, 2=无效
evaluationType 1 number 测评渠道,0=无,1=团队,2=院内,3=线上
answerSets [{ "id": 1, "index": 1, "submissionId": 1, "questionnaireSetId": 1}] array 测评回答集
resultSets [{ "id": 1, "index": 1, "questionnaireSetId": 1}] array 测评结果集
questionnaire { "id": 1, "submissionId": 1, "questionnaireSets": [] } array 量表信息
参数名 示列值 类型 说明
id 1 number id
submissionId 1 number 测评记录id
questionnaireSetId 1 number 量表集id
index 1 number 回答集序号， 对应量表集序号
lastQno Q3 string 最后答题题目编号
status 1 number 状态, 1=已完成, 2=进行中
startedAt 0 number 开始答题时间
endedAt 0 number 结束答题时间
answers [{"id": 1, "qno": "Q1", "value": "A"}] array 回答列表
personalInfoAnswers [{"id": 1, "qno": "P1", "value": "A"}] array 人口学回答列表
参数名 示列值 类型 说明
id 1 number id
answerSetId 1 number 测评回答集id
questionnaireSetId 1 number 量表集id
questionnaireId 1 number 量表id
questionItemId 1 number 题目id
qno "Q1" string 题目编号
value "A" string 回答值
startedAt 1990000 number 开始做题时间戳,单位秒
endedAt 1990000 number 结束做题时间戳,单位秒
useTime 200 number 做题用时时间, 单位秒
createdAt 1650160322 number 创建时间
updatedAt 1650160322 number 更新时间
参数名 示列值 类型 说明
id 1 number id
answerSetId 1 number 测评回答集id
questionnaireSetId 1 number 量表集id
questionnaireId 1 number 量表id
questionItemId 1 number 题目id
qno "P1" string 题目编号
value "A" string 回答值
startedAt 1990000 number 开始做题时间戳,单位秒
endedAt 1990000 number 结束做题时间戳,单位秒
useTime 200 number 做题用时时间, 单位秒
createdAt 1650160322 number 创建时间
updatedAt 1650160322 number 更新时间
参数名 示列值 类型 说明
id 1 number id
submissionId 1 number 测评记录id
questionnaireSetId 1 number 量表集id
index 1 number 回答集序号， 对应量表集序号
validityCustomComment "" string 效度量表评语(只有mmpi有)
contentCustomComment "" string 内容量表评语(只有mmpi有)
results [{"id": 1, "commentId": 1, "score": 1200}] array 测评结果列表
resultSetAssessments [{"id": 1, "name": ""}] array " 测评记录维度条件列表
resultSetSummary {"id": 1, "comment": ""} object 测评总结结论信息
参数名 示列值 类型 说明
id 1 number id
resultSetId 1 number 测评结果集id
dimensionId 1 number 维度id
index 1 number 序号， 对应维度序号
score 108 number 维度成绩, 数据库保留整数，做了x100处理
rawScore 2200 number 原始分, 保留整数做了*100处理
commentId 1 number 维度结果id
comment {"id": 1, "result": "中毒倾向"} 维度结果信息
createdAt 1650160322 number 创建时间
updatedAt 1650160322 number 更新时间
参数名 示列值 类型 说明
id 1 number id
resultSetId 1 number 测评结果集id
assessmentId 1 number 维度条件id
assessment {"id": 1, "name": "M12/21"} 维度条件信息
createdAt 1650160322 number 创建时间
updatedAt 1650160322 number 更新时间
参数名 示列值 类型 说明
id 1 number id
resultSetId 1 number 测评结果集id
summaryId 1 number 总结结论id
totalScore 2200 number 总分, 保留整数做了*100处理
summary {"id": 1, "result": "中毒倾向"} 总结结论信息
createdAt 1650160322 number 创建时间
updatedAt 1650160322 number 更新时间

返回示列

HTTP/1.1 200 OK
{
    "items": [
      {
        "id": 1, // 记录id
        "organizationId": 4, // 组织id
        "memberId": 1, // 用户id
        "questionnaireId": 33, // 量表id
        "startedAt": 1604993655, // 测试开始时间
        "endedAt": 1604993655, // 测试结束时间
        "status": 1, // 状态, 1=已完成， 2=测试中
        "reportPdfUrl": "", // 测评报告pdf地址
        "alarmLevel": 1, // 预警等级,0=无,1=轻,2=中,3=重,4=结果无效
        "validityStatus": 1, // 效度状态, 0=无, 1=有效, 2=无效
        "reviewStatus": 1, // 审阅状态, 0=无, 1=已审阅, 2=未审阅
        "evaluationType": 1, // 测评渠道,0=无,1=团队,2=院内,3=线上
        "member": { // 用户信息
          "id": 1,
          "name": "demo", // 用户名
          "mobile": "13588888888" // 手机号
        },
        "questionnaire": { // 量表信息
          "id": 1,
          "title": "张三", 
          "category": {
            "id": 1,
            "name": "分类1"
          },
          "questionnaireSets": [ // 量表集信息

          ]
        },
        "organization": { // 组织信息
          "id": 1,
          "name": "组织1"
        },
        "answerSets": [
            {
                "id": "1",
                "submissionId": 2, // 测评记录id
                "questionnaireSetId": 28, // 量表集id
                "index": 0,
                "lastQno": "", // 最后答题编号
                "startedAt": 1604993655, // 测试开始时间
                "endedAt": 1604993655, // 测试结束时间
                "status": 1, // 状态, 1=已完成， 2=测试中
                "answers": [
                    {
                        "id": "1",
                        "createdAt": 1655794329,
                        "updatedAt": 0,
                        "answerSetId": 1,
                        "questionnaireId": 44,
                        "questionnaireSetId": 28,
                        "questionItemId": 1, // 题目id
                        "qno": "Q1", // 题目编号
                        "value": "A", // 回答值
                        "startedAt": 1655794329, // 做题开始时间
                        "endedAt": 1655794529, // 做题结束数据
                        "useTime": 200 // 用时时间
                    },
                ]
            }
        ],
        "resultSets": [ // 量表测评成绩
          {
            "id": 793,
            "submissionId": 585, // 提交记录id
            "questionnaireSetId": 33, // 量表集id
            "index": 1, // 序号， 对应量表集序号
            "results": [ // 测评维度结果成绩
              {
                "id": 2104,
                "resultSetId": 793, // 测评结果集id
                "dimensionId": 63, // 维度id
                "index": 1, // 序号， 对应维度序号
                "commentId": null, // 维度结果id
                "score": 108, // 维度成绩, 数据库x100， 保留整数
                "rawScore": 2200, // 原始分, 做了x100处理
                "comment": null, // 维度结果信息
                "dimension": null // 维度信息
              },
              {
                "id": 2106,
                "resultSetId": 793,
                "dimensionId": 65,
                "index": 3,
                "commentId": 105,
                "score": 28, // 维度成绩, 数据库x100， 保留整数
                "rawScore": 2200, // 原始分, 做了x100处理
                "comment": {
                  "id": 105,
                  "dimensionId": 65,
                  "index": 1,
                  "matcher": {
                    "type": "range",
                    "min": "-3",
                    "max": "3"
                  },
                  "result": "应对倾向",
                  "comment": "积极和消极是相对的，并不是积极的应对方式就一定有积极的后果，或者消极的应对方式就产生消极的后果，不同应对方式在不同的时间和情景，在不同的人身上，会有不同的结果。",
                  "createdAt": 1592201060,
                  "updatedAt": 1592201060
                },
                "dimesion": {
                  "id": "8",
                  "createdAt": 1656329110,
                  "updatedAt": 0,
                  "questionnaireSetId": 7,
                  "index": 1,
                  "wno": "W1",
                  "name": "维度1",
                  "minScore": 0,
                  "maxScore": 4,
                  "factor": "{\"type\": \"sum_score\"}",
                  "qnos": "[\"Q1\", \"Q2\", \"Q3\", \"Q4\", \"Q5\", \"Q6\", \"Q7\"]"
                }
              }
            ],
            "resultSetAssessments": [ // 测评记录维度条件列表
              {
                "id": 111,
                "resultSetId": 12, // 测评结果集id
                "assessmentId": 1,// 维度条件id
                "assessment": {
                  "id": 2104,
                  "name": "条件1", // 名称
                  "index": 1, // 序号， 对应维度序号
                  "comment": null, // 评语
                  "suggest": "xxx", // 建议
                },
              }
            ],
            "resultSetSummary": {
              "id": 111,
              "resultSetId": 12, // 测评结果集id
              "summaryId": 1,// 总结结论id
              "summary": { // 维度总结结论
                "id": 2104,
                "result": "总结1",
                "index": 1, // 序号， 对应维度序号
                "summaryId": 1, // 结果结论id
                "comment": "", // 评语
                "suggest": "xxx", // 建议
              },
            }
          }
        ],
        "createdAt": 1647846587,
        "updatedAt": 1647846587,
    }],
    "total": 4070,
    "offset": 1,
    "limit": 2,
    "page": 1,
    "pageSize": 2
  }

量表测评记录详情: /questionnaireSubmissions/:id GET

请求参数

参数名 示列值 类型 必须 说明
id 1 number 是 组织 id
expand 'source' string 否 获取指定子资源数据 'source,creator,category,organizations,questionnaireSets.questions,questionnaireSets.dimensions.comments,questionnaireSets.assessments'
attributes ["id", "name"] array 否 本资源的字段。不定义该字段时返回所有字段

返回结果: 量表记录信息

新建量表测评记录: /questionnaireSubmissions POST

请求参数

参数名 示列值 类型 必须 说明
teamEvaluationId 1 number 否 团队测评活动id,0=无
memberEvaluationId 1 number 否 测评记录分发id
organizationId 1 number 是 来源组织id,0=云医后台
questionnaireId 1 numbe 是 量表id
memberId 1 number 是 患者用户id
evaluationType 1 number 是 测评渠道,0=无,1=团队,2=院内,3=线上
startedAt 0 number 开始答题时间
endedAt 0 number 结束答题时间
status 1 number 状态, 1=已完成, 2=进行中
data {} object 是 提交数据

请求示列

HTTP/1.1 200 OK
{
  "teamEvaluationId": 0,
  "memberEvaluationId": 0,
  "organizationId": 1,
  "questionnaireId": 1,
  "memberId": 1,
  "evaluationType": 1, // 测评渠道,0=无,1=团队,2=院内,3=线上
  "startedAt": 1604993655, // 测试开始时间
  "endedAt": 1604993655, // 测试结束时间
  "status": 1, // 状态, 1=已完成， 2=测试中
  "data": { // 提交数据
    "answerSets": [
      {
        "questionnaireSetId": 28, // 量表集id
        "index": 0,
        "lastQno": "", // 最后答题编号
        "startedAt": 1604993655, // 测试开始时间
        "endedAt": 1604993655, // 测试结束时间
        "status": 1, // 状态, 1=已完成， 2=测试中
        "answers": [
          {
              "questionItemId": 1, // 题目id
              "index": 1, // 题目序号
              "qno": "Q1", // 题目编号
              "value": "A", // 回答值 多选: 'A,B', 地区: '北京市,北京市,东城区'
              "startedAt": 1655794329, // 做题开始时间
              "endedAt": 1655794529, // 做题结束数据
              "useTime": 200 // 用时时间
          },
        ]
      }
    ],
  },
}

返回结果: 量表记录信息

修改量表测评报告url: /questionnaireSubmissions/:id/reportUrl PUT

请求参数

参数名 示列值 类型 必须 说明
pdfUrl "xxx" string 是 pdf地址

请求示列

HTTP/1.1 200 OK
{
  "pdfUrl": "http://www.google.com",
}

返回结果: 量表记录信息

修改量表测评报告自定义审阅: /questionnaireSubmissions/:id/customReview PUT

请求参数

参数名 示列值 类型 必须 说明
resultSets [] array 是 测评结果集

请求示列

HTTP/1.1 200 OK
{
  "resultSets": [
    {
      "resultSetId": 1, // 测评结果集id
      "questionnaireSetId": 1, // 量表集id
      "validityCustomComment": "", // mmpi效度量表自定义评语
      "contentCustomComment": "", // mmpi内容量表自定义评语
      "results": [
        {
          "id": 1, // 测评结果id
          "customComment": "自定义评论",
          "customSuggest": "自定义建议",
        }
      ],
      "resultSetSummary": {
        "id": 1, // 总结结论id,
        "customComment": "自定义评论",
        "customSuggest": "自定义建议",
      },
      "resultSetAssessments": [
        {
          "id": 1, // 测评维度条件id
          "customComment": "自定义评论",
          "customSuggest": "自定义建议",
        }
      ],
    },
  ]
}

返回结果: 量表记录信息