Skip to main content

配置成绩提取

成功激活成绩导出功能后,必须配置成绩提取设置。

配置成绩导出的成绩提取设置

  1. 登录到 Blackboard。

  2. 访问管理员面板。

  3. 云管理中选择平台扩展

  4. 成绩导出 v2 的上下文菜单中选择编辑设置

    成绩导出 v2 菜单展开以显示编辑设置,该设置以橙色突出显示。
  5. 确保已选择成绩导出可用性切换开关。将出现您无法选择的成绩旅程功能切换;文本包含有关付费参与提供的成绩旅程扩展的更多信息。如需了解有关 Grades Journey 附加功能的更多信息,请联系您的客户代表。

  6. 选择成绩数据提取设置选项卡,然后选择正常积分积分类型。

成绩提取设置分为六个可展开的部分。

常规设置

  1. 集成类型选择“正常集成”。

  2. CRON 计划确定提取已批准成绩文件的频率。打开 Enabled?如果您希望流程按指示的 CRON 计划运行,切换,然后输入 CRON 表达式以指定提取的频率。

  3. 在“小数位数”字段中,输入分数值位数后将显示的位数。该值被截断,而不是舍入,默认值为 5。

  4. 输入要为未成绩、未标记的项目或字段返回的空值,这些项目或字段没有值存储在“未标记评估的提取值”字段中(例如,“0”或“noValue”)。

  5. 在日期列格式字段中输入有效的日期格式掩码。此格式将用于数据提取中包含的任何日期值。使用 Java SimpleDateFormat

列过滤器

列过滤器用于确定向评分者显示哪些成绩列以供审批。一次只能激活一个过滤器选项。

  • 列过滤器 如果要在禁用预配时仅向成绩者显示特定列,请填写此框。在以逗号分隔的列名称列表中输入列。此设置的目的是允许数据提取仅包含需要报告的列。

  • 外部成绩列(原始成绩)或总成绩(Ultra)仅如果您只想向评分者显示外部成绩列(在原始课程中)或总成绩(在 Ultra 课程中),请选中此复选框。此设置优先于“列筛选器”设置和“已启用预配”设置。

  • 已启用预配 如果要仅显示作为从 学生信息系统 预配给评分者的可评分项目的一部分导入的 成绩 列,请选中此复选框。此设置优先于“列过滤器”设置。

  • 列元数据验证如果选择“已启用预配”,则会出现“列元数据验证”框。(可选)在成绩列元数据中输入一组键/值对及其预期出现次数,以确定是否可以提取课程。如果不满足这些参数,系统将返回错误,并且不会提取课程中的数据。

列映射

输入以管道符号分隔的名称/值对列表,以标识要包括在报表中的每条记录的成绩列数据字段。如果此框留空,则将在数据提取中传递默认字段列表。

映射示例:

external_course_key=Course.getBatchUid|External_person_key=User.getBatchUid|student_id=User.getStudentId|column=Item.getDisplayColumnName|grade=Grade.getSchemaValue

默认提取示例:

EXTERNAL_COURSE_KEY|STUDENT_ID|BATCH_UID|TITLE|MARK|GRADE|EXTENDED_DATA
GE_ORIG_DEM|54321|demo_student2|Final Grade|85|B|Y|
GE_ORIG_DEM|12345|demo_student1|Final Grade|95|A|Y|

提取课程角色设置

  1. 对于所需的审批角色,请指定用户在启动成绩审批流程时必须具备的课程角色(例如讲师)。

  2. 如有需要,还可以指定任何额外的机构角色以批准成绩(如成绩审核员)。

    拥有上述任一角色的用户都可以批准成绩。

结果传输设置(NORMAL积分法)

结果传输设置
  1. 文件名掩码字段中,设置文件提取名称的模式。将[传输类型]设置为[合并文件]时,文件名的开头将添加 “combined_ ”。

  2. 选择传输方式。SFTP 是最常见的,其设置在以下步骤中进行了描述。

  3. 选择传输类型

    • 每个文件导致每个课程单独传输一个提取文件

    • 合并文件结果将合并为一个文件,所有课程的所有已批准行

      注意

      手动提取将生成特定于课程的提取文件。

  4. 启用使用 Windows EOL(如果将在需要 Windows EOL 的 Windows 环境中处理则使用 Windows EOL。

  5. 服务器字段中输入 SFTP 服务器的 URL 或 IP。

  6. 端口字段中输入 SFTP 服务器端口(通常为 22)。

  7. 用户名字段中输入 SFTP 用户名。

  8. 密码字段中输入 SFTP 密码。

  9. 在“路径”字段中输入数据提取文件的路径。

提取文件格式
  1. 输入要用于提取文件的字段分隔符。默认值为管道 ( | )。

  2. 输入字段限定符。如果提取的数据包含分隔符,则要使用该字符。默认值为双引号 ( “ )。

成绩审批和转移设置

  1. 启用需要成绩批准以在列或成绩级别启用成绩批准。如果未启用此功能,则只能在课程级别批准成绩。

  2. 选择已启用提取成绩按钮以使提取按钮显示给审批者。评分者将能够立即运行提取。对于 NORMAL 集成,仅当传输类型设置为每个文件时,才会生成和发送数据提取。

    注意

    提取按钮将始终为成绩审批者管理员用户启用。

  3. 选择 批准成绩按钮已启用?使审批者显示批准成绩按钮。

    注意

    审核按钮将始终为成绩审批者管理员用户启用。

  4. 直接启动到成绩设置适用于审批工作流程的即将推出的功能,不应选择。

  5. 选择包括未过帐的成绩 以包括尚未在成绩提取中过帐的成绩。这不包括手动列或成绩已被覆盖但尚未发布的列。

成绩显示值配置

设置要在审批工作流程中显示的成绩值:

  • 成绩 Letter:如果模式是字母,则返回字母成绩;否则,返回一个空字符串

  • Schema Value:返回成绩列主显示

  • 百分比分数:返回计算出的百分比分数

  • 辅助架构值:返回成绩列辅助显示(仅适用于原始课程)

  • Score Value:返回分数值

成绩中心只读

只读视图仅适用于原始课程体验。

您可以锁定课程成绩中心,并将尝试访问成绩的用户重定向到只读页面。对于锁定审批,请选择以下三个选项之一:

  • 立即批准:审批者批准该课程的成绩后立即锁定成绩中心

  • 成绩列到期日期后:达到所选成绩列到期日期后锁定成绩中心

    注意

    如果选择此选项,则必须启用增强的只读功能,并在锁定成绩列名称框中输入成绩列的名称,其到期日期将用于确定成绩中心何时锁定。

  • 禁用:不锁定成绩中心

增强的只读功能

打开增强的只读功能切换开关,为原始课程设置其他只读功能。

  • 页面标题:(可选)输入只读页面的页面标题

  • 锁定成绩列名称:输入成绩列的名称,其到期日期将用于确定何时锁定成绩中心

  • 锁定课程的时间:(可选)输入锁定作业的运行时间。如果未输入时间,则作业将在午夜运行。

  • 保持解锁手动解锁课程的时间(小时):(可选)输入一个值,说明手动解锁的课程在再次自动锁定之前应保持解锁状态的时间(以小时为单位)

  • 自动锁定成绩中心的时间(小时):(可选)输入成绩中心在批准成绩事件发生后必须锁定成绩中心多长时间(以小时为单位)的值

  • 锁定审批异常(小时):(可选)输入具有审批者权限的角色在锁定事件后仍可以访问成绩中心的时长(以小时为单位)的值

  • 不受锁定影响的课程角色:选择不会重定向到成绩中心只读查看页面的课程角色,即使该页面被锁定,仍可访问完整的成绩转移和批准页面

    注意

    系统管理员是唯一能够始终访问完整成绩转移和批准页面的角色。

选择一个或多个版位

指定将用于从原始课程和 Ultra 课程运行成绩批准和转移工具的 LTI 安置。讲师工具和系统工具是必需的放置。选择在新窗口中启动以在单独的窗口中打开 LTI。

选择提交保存所有选择。