跳转到正文
Docs
下载 Markdown
文章目录

Developer 编写课程与批改

准备课程版本,提交审核,或处理学员的开放题答案。

下载 Markdown

这页帮 Developer 做两件事:编写一门能被活动Developer 组织的一组数据工作及其相关设置要求的课程,以及批改学员提交的开放题答案。前提是你已经是课程所属组织的成员。Owner、Admin、Member 都可以编写和批改,成员身份是唯一的要求。

在 Developer 左侧导航选择 Academy(学院)。打开的页面是 Academy Programs(学院培训项目),列出当前组织的全部课程。编写课程和批改答案都从这里开始,无需先建活动。

如果 Academy 处于锁定状态,或页面提示账号还没有加入组织,先创建或加入组织。如果页面显示 You don't have permission to view this(你没有查看此内容的权限),请该组织的 Owner 或 Admin 邀请你加入。

创建课程和第一个版本

选择 New Program(新建培训项目)。填写必填的 Title(标题),再用 Description(简介)说明谁需要学这门课、为什么要学。然后选择 Create Program(创建培训项目)。

课程编辑器随即打开,此时还没有版本。选择 Create Version 1(创建第 1 版),之后添加的学习单元都属于这个草稿版本。

以后要修改课程,从 Academy Programs 打开它。从未发布过的课程显示 Edit Course(编辑课程)。已发布的课程显示 Publish New Version(发布新版本)。它会打开一份从最新已发布版本复制出来的草稿,已发布的版本保持原样。

Create Program 报错时,先在列表里找这门课程,找不到再重新创建,以免建出两门。

添加学习单元

在编辑器里用 Add lesson(添加课时)加入学习单元,一个课时就是一个学习单元。每个学习单元都是必修步骤,学员完成版本里的全部学习单元,才算完成课程。

学习单元你要准备什么学员怎样完成
Reading(阅读)Lesson name(课时名称)和 Article(文章)。文章用 Markdown 编写,可用 Preview(预览)检查读完后选择 Mark as read(标记为已读)
Video(视频)Lesson name、Lesson description(课时简介)和 YouTube URL(YouTube 链接)看完后选择 Mark as watched(标记为已看)
Quiz(测验)Lesson name、至少一道题目,以及 Pass threshold (%)(及格线(%))得分达到及格线

Reading 可以附加一张图片或一份 PDF 来代替文章,Video 可以上传 MP4 或 WebM 文件来代替 YouTube 链接。附件或上传的文件会替换另一个来源,学员只看到这个文件。

编写 Quiz 题目

打开 Quiz 单元,选择 Add question(添加题目)。新题目已经填好占位内容:一段题干、一个正确选项和一个错误选项。把它们改成你自己的内容,修改会在你离开输入框时自动保存。

每道题都有 Question(题目)、Question type(题型)和 Points(分值),分值是 1 到 100 的整数。题型决定你还要准备什么,以及答案怎样判分。

题型你要准备什么怎样判分
Single choice(单选题)2 到 6 个 Choices(选项),其中恰好一个标为 Correct(正确)自动判分。学员选中该选项即为答对
Multiple choice(多选题)2 到 6 个 Choices,至少一个标为 Correct自动判分。学员选中全部正确选项、且没有多选,才算答对
Fill in the blank(填空题)1 到 6 个 Accepted answers(标准答案),彼此不重复自动判分。学员输入的内容必须与某个标准答案一致,忽略大小写和首尾空格
Open answer(开放式作答)无需其他内容,这种题没有标准答案人工批改。这次作答中的开放题全部批改完之前,学员的 Quiz 没有分数

题目违反所属题型的规则时,下方会出现警告,答案设置也暂不保存。例如选择题没有标出正确选项时,警告是 Mark the correct answer — as written, nobody can pass this question.(请标出正确答案——照现在这样,没有人能答对这道题)。

设定及格线

Quiz 的得分等于学员拿到的分值占全部分值的百分比,每道题要么拿到全部分值,要么得 0 分。Pass threshold (%)(及格线(%))是算作通过的最低得分,初始值为 70,可填 1 到 100 的整数。学员可以重做 Quiz,次数没有上限。

请把及格线保持在 70 或以上。课程结果要求每个 Quiz 至少得到 70%,与 Quiz 自己的及格线无关。及格线设得更低时,学员可能通过了 Quiz,却仍未完成课程。

示例:一门可以发布的小课程

下面是一个示意:一个 Reading 加一个 Quiz。它能通过提交前的检查。唯一的题目是自动判分的,学员提交后立即得到结果,无需等人批改。

学习单元字段示例内容
ReadingLesson name标注标准
ReadingArticleQuiz 要考的判断标准,附一个做好的例子
QuizLesson name资格测验
QuizQuestion小票总金额无法辨认时,应该打哪个标签?
QuizQuestion typeSingle choice
QuizPoints1
QuizChoicesA:无法辨认,标为 Correct。B:有效
QuizPass threshold (%)70

这个 Quiz 只有一道 1 分的题,学员的得分只会是 100% 或 0%。

保存、提交并跟进审核

Save as Draft(保存为草稿)保存你对学习单元的修改,页面显示 Saved as draft(已保存为草稿)。

全部学习单元都准备好后,选择 Submit for Review(提交审核)。弹窗会先检查这个版本。有学习单元没完成时,弹窗会列出它并附上 Fix →(去处理 →)。提交按钮保持禁用,补完后才能提交。

检查按学习单元的类型进行:

  • Reading 要有文章或附件
  • Video 要有链接或文件
  • Quiz 至少要有一道答案设置有效的题目

在弹窗里再次选择 Submit for Review 确认。页面显示 Submitted for review — an Academy admin will approve or reject this version.(已提交审核——学院管理员会通过或驳回这个版本)。这里的 Academy admin 指 Humanbased 平台的审核人员,与你组织里的 Admin 无关。

之后在课程页的 Status(状态)旁查看进展。

状态表示什么你现在做什么
Draft(草稿)版本可以编辑。学员学不到它,活动也无法要求它补完学习单元,再提交审核
In review(审核中)版本已提交并锁定,等待 Academy admin 处理等待结果。这期间学习单元和题目都无法修改
Changes requested(需要修改)审核人员把版本退回草稿,并在课程页留下 Reviewer feedback(审核意见)打开编辑器按意见修改,再次提交审核
Published(已发布)版本已通过。学员可以学习,活动可以要求它到活动的 Entry Gate 绑定它

把课程绑定到活动

课程发布后,还要由活动的 Entry Gate工作流中集中设置活动参与要求的步骤 提出要求,才会影响这个活动。打开活动,选择 Open builder(打开构建器),再选中 Entry Gate(准入门)节点。它的配置面板里有三个课程字段。

字段选什么
Required course(必修课程)要求的课程。列表里只有已发布的课程
Course version(课程版本)要求的已发布版本。选中课程时,默认选中它最新的已发布版本
What counts as done(怎样算完成)Has finished the course(已学完该课程),这也是默认值

学员完成了全部学习单元,就满足 Has finished the course,也就是 Reading 和 Video 都已标记完成,Quiz 都已通过。学员在同一门课程的旧版本上通过,同样满足,见版本规则。

在这里编写的课程,请让 Has mastered the course(已掌握该课程)保持未选中。这个选项要求 mastered 结果,而学完课程记录的是 passed 结果。编辑器里没有任何学习单元或 Quiz 设置能产生 mastered,选了它就没有学员能通过这道 Gate。

要求会固定在你选中的版本上。课程发布新版本后,这个面板会出现以新版本命名的按钮,例如 Require v2(要求 v2)。选择它,活动才会改到新版本。面板和画布的保存方法见配置工作流的 Entry Gate 一节。

批改开放题答案

含有 Open answer(开放式作答)题目的 Quiz 要靠人批改才能出分。在这次作答的开放题全部批改完之前,学员一直看到 Submitted — awaiting grading(已提交,等待评分)。

在 Academy Programs 页面选择 Review(审核)。这个队列处理的是学员的答案。课程编辑器里的 Submit for Review 提交的是课程版本,由 Academy admin 处理,两者互不相干。

队列列出当前组织所有课程里等待批改的开放题答案,最早提交的排在最前。这个组织的任何成员都可以批改。每份答案是一张卡片,批改需要的内容都在卡片上。

卡片位置显示什么
第一行课程名称和 Quiz 单元名称。选择它可以打开课程,重读这道题对应的教学内容
第二行题目、分值和学员的提交时间
灰底区域学员的答案。答案为空时显示 (no answer text)(没有作答内容)
按钮Mark correct(判为正确)和 Mark incorrect(判为错误)

读完题目和答案,在两个按钮里选一个。Mark correct 给这份答案该题的全部分值,Mark incorrect 给 0 分。

选择前请想好:队列只列出尚未批改的答案,已记录的批改无法在这个页面改回。

请求发送期间两个按钮都会变灰。记录成功后,卡片从队列里消失,这就是成功的标志。

学员这次作答的最后一道开放题批改完后,Quiz 得出分数和通过与否。学员的课程结果随之更新。

你看到什么表示什么你现在做什么
选择按钮后卡片消失批改已记录继续处理下一张卡片
出现错误提示,卡片还在请求报错,结果尚未确认刷新页面。卡片仍在队列里,说明还没有批改记录,重新选择。卡片已消失,说明批改已记录
Nothing to grade right now(当前没有需要评分的内容)当前组织没有等待批改的开放题答案。课程版本的审核进度要到课程页的 Status 查看等学员提交后再来。如果本应有答案,先确认当前组织是否选对
The review queue could not be loaded. Please try again.(审核队列没能加载出来,请重试)列表请求失败刷新页面
You don't have permission to view this你的账号还未加入当前组织请该组织的 Owner 或 Admin 邀请你加入