采用 SITS 集成实施 Grades Journey

  1. 在系统管理员的 Blackboard Building 下方，选择 Building Block。
  2. 选择已安装的工具。
  3. 找到 Blackboard Grade Journey 服务并选择设置。
  4. 使用以下部分，配置每个设置组下方的属性。

作业和成绩列设置（传入数据）

配置以下属性：

  • 调度工作
    • 设置工作状态 - 选择已禁用
    • CRON 调度 - N/A
    • 配置内容区 - 选择将创建可评分项目的默认文件夹，除非在事务中将其覆盖。
    • 内容项目调配检查 - 此设置可用于定义配置的内容项目的匹配规则。选项包括：
      • 无限制：将馈送中的项目始终添加为新内容项目。
      • 仅一次：仅添加一次任何指定的项目（用于 LIS）。
      • 按名称更新匹配项：首次传递时添加项目，在随后的导入中根据内容项目标题匹配对其更新。
    • 可评分项目调配检查 - 此设置用于为配置的手动成绩列或由配置的内容项目创建的成绩列定义匹配规则。选项包括：
      • 按名称更新匹配项：首次传递时添加项目，在随后的导入中根据内容项目标题匹配对其更新。
      • 按元数据更新匹配项：首次传递时添加项目，在随后的导入中根据存储在名为“类型”（包含在项目输入数据记录的可选数据列表中）的元数据属性中的值匹配对其更新。
  • “结果传输设置”、“文件格式”和“成绩列设置”不适用于 REST。

完成后，选择提交。

成绩提取设置（传出数据）

配置以下属性：

  • 集成
    • 集成类型 - 选择“SITS 集成”。SITS 集成会生成三个输出文件、一个摘要、一个评估文件和一个重新评估文件。
    • CRON 调度 - 选择后台提取的频率。例如，如果将此值设为 0 0/60 * 1/1 * ? *，则每小时进行一次提取
    • 约整数 - 选择分数的最大小数位数。
    • 未标记测验的提取值 - 选择您希望返回未标记或未评分项目的空值。
    • 列筛选器 - 如果在调配功能禁用时，应该将批准和提取列列表限定在成绩列名称的指定逗号分隔列表中，请选择此选项。此设置的目的是允许提取仅包含需要报告的那些列。
    • 仅限外部成绩列 - 如果应该将批准和提取列列表限定在课程外部成绩列（即成绩中心内标记为“外部成绩”的列），请选择此选项。

      此设置优先于“列筛选器”设置。

    • 已启用调配 - 如果应该将批准和提取列列表限定在从 SIS 导入且经过配置的内容项目和可评分项目，请选择此设置。
    • 列映射 - 输入用竖线符号分隔的名称/值对列表，以识别报告中每条记录包含的成绩列数据字段。如果将其留空，则默认字段列表会包括在报告中：
      EXTERNAL_COURSE_KEY|STUDENT_ID|BATCH_UID|TITLE|MARK|GRADE|EXTENDED_DATA
  • 提取课程角色要求
    • 课程角色 - 指定用户能够审批成绩所需的课程角色（如教师）。
    • 机构角色 - 指定用户能够审批成绩所需的机构角色（如成绩审批者）。
    • 访问拒绝消息 - 为试图提取成绩但没有相应权限的用户输入消息。
  • 结果传输设置
    • PostWebservice 端点 - 指定成绩发布的端点。
    • TestingRestWebservice 端点 - 忽略此设置（一般）。
  • REST（传出）安全设置
    • 启用安全 REST API - 如果端点将实现安全性，请启用此设置。如果已启用，还需设置以下内容：
      • 共享密令 - 输入共享密令。
      • API 密钥 - 输入 API 密钥。
      • 时间戳范围 - 请勿设置。
      • 时间戳参数 - 输入时间戳的参数。
      • MAC 参数 - 输入 MAC 参数。
      • API 密钥参数 - 输入 API 密钥参数。
  • 成绩审批和传输设置
    • 需要成绩审批 - 如果您希望在列或成绩级别审批成绩，请启用此设置。
    • 显示历史页面？- 如果您不想执行成绩级别审批并希望在从课程中提取时显示历史页面，请启用此设置。
    • 启用执行提取按钮？- 启用此设置，可允许评分者立即运行提取。
    • 启用调度提取按钮？- 启用此设置，可允许评分者调度/审批提取。
    • 审批时锁定？- 启用此设置可将成绩中心切换到只读模式，这样在提取后无法修改成绩。

完成后，选择提交。

通知设置

如果需要，返回到“设置”菜单并编辑通知设置。

REST API 安全设置（传入数据安全）

配置以下属性：

  • REST 传出安全设置
    • 启用安全 REST API - 如果传入端点将实现安全性，请启用此设置。
    • IP 筛选器 - 启用任意传入 IP 的筛选器。如果已启用此设置，还需设置以下内容：
      • 共享密令 - 输入共享密令。
      • API 密钥 - 输入 API 密钥。
      • 时间戳范围 - 请勿设置。
      • 时间戳参数 - 输入时间戳的参数。
      • MAC 参数 - 输入 MAC 参数。
      • API 密钥参数 - 输入 API 密钥参数。

完成后，选择提交。

日志记录级别

配置以下属性：

  • 日志配置
    • 日志详细程度 - 配置此设置，以确定记录到 /logs/custom/bbc-GradeyJourney.log 文件中的日志级别。默认值是“信息”，但您可能需要添加“调试”以进行故障排除。生产配置应设置为“信息”，而非“调试”。

运行验证测试

  1. 导航到系统管理员 > 成绩提取设置（传出数据）。
  2. 将传输方法更新为本地，然后设置可以读取、更新和从运行 Blackboard Learn 的用户中删除的本地文件夹路径。根据您的需求选择 SITS 集成。选择提交。
  3. 在设置中，选择作业和成绩列设置（传入数据）。
  4. 将“通过 FTP 接收输入文件”更新为“已禁用”，然后设置可以读取、更新和从运行 Blackboard Learn 的用户中删除的本地文件夹路径。选择提交。
  5. 使用平面文件在课程中创建加权成绩列。创建注册的用户文件。
  6. 以教师身份登录到 Learn 并转到课程。
  7. 导航到“成绩中心”。新加权成绩列应该显示在此处。
  8. 创建一个作业并将其 100% 映射到加权列。
  9. 输入注册的成绩。
  10. 在管理菜单中，选择成绩审批和传输。
  11. 在课程、成绩列或成绩级别选择提取和调度按钮。
  12. 如果提取成功完成，则一个或多个文件会显示在提取文件夹中。
  13. 如果提取失败，请在 <bb home>/custom/log/bbgs-GradeJourney.log 中查看日志。