Skip to main content

配置成绩簿摘录

成绩簿摘录是全自动提取,不需要成绩批准即可纳入提取。要访问成绩簿摘录的成绩簿摘录设置:

  1. 访问管理员面板。

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

  3. 成绩导出 v2菜单中选择编辑设置

  4. 在你想配置的成绩簿_EXTRACT行的配置列中选择放大镜。

这样你就能进入“成绩提取设置”标签页。该标签页有六个可展开的部分。

一般设定

  1. 选择集成类型

    • NORMAL 集成:分隔文件格式

    • REST 集成:成绩 Journey 专用的 JSON 格式

    • Legacy Banner 集成:Legacy Banner REST API 格式

  2. CRON 计划决定了批准成绩文件被提取的频率。输入有效的CRON表达式以指定提取物的频率。

  3. 小数位字段中,输入小数点后方的数字以显示分数。该数值是截断而非四舍五入,默认值为五。

  4. 输入未成绩、未标记题目或在未标记评估提取值字段中无值的空值(例如“0”或“noValue”)。

  5. 请指定一个逗号分隔的成绩列表,这些成绩将被视为有效成绩字段。这些应该是字母成绩,而不是数字。如果某个成绩值无效,则不包含在提取中,并会触发邮件通知。因无效而被排除在提取之外的记录会被添加到附加在邮件通知中的文件中。

    注意

    如果你把这个框留空,所有成绩都算有效。

  6. 日期格式列字段输入有效的日期格式掩码。该格式用于提取中包含的任何日期值。使用Java SimpleDateFormat

术语过滤器

  1. 打开启用切换,按项筛选提取内容。

  2. 选择添加删除以添加或删除行。

  3. 学期列中,选择你想过滤提取物的术语。仅包含与所选学期相关的课程。

  4. 在相应栏中输入生效日期和终止日期。如果当前日期介于生效日期与结束日期之间,数据将从与该学期相关的课程中提取。日期可以留空,摘录不会有日期限制。

航向过滤器

要纳入提取的课程必须满足所有配置的标准。

  1. 开启仅可用课程切换,只在成绩簿摘录中包含可用课程的数据。

  2. 请搜索成绩摘要中包含的课程。输入你的搜索参数,所有返回的课程都会被包含在内。您可以根据以下方式进行搜索:

    • 批处理 UID

    • 课程 ID

    • 课程名称

    • 数据源密钥

    • 术语

    • 课程创建日期

    • 课程日期范围

  3. 课程排除列表框中输入一个逗号分隔的课程编号列表,列出你不希望被包含在成绩簿中的课程编号。

柱滤波器

塔滤器用于确定哪些成绩柱被提取。

  • 列筛选如果你想在禁用配置时只提取特定列,请填写此框。输入列名列表中的逗号分隔。该设置的目的是允许提取只包含需要报告的列。

  • 仅外部成绩栏(原始)或总体成绩(超高)如果你只想提取外部成绩栏(原始课程中)或总体成绩(在超高级课程中),请选择此复选框。该设置优先于列过滤器设置和配置启用设置。如果你选择了这个,它就是唯一会被提取的成绩列。

  • 启用配置如果你只想提取从学生信息系统中配置的可评分项目中导入的成绩列,请选择此复选框。该设置优先于列过滤器设置。

  • 只包含自上次运行以来的行如果你只想包含自上次提取以来成绩值变化的成绩列记录,请选择此复选框。

  • 排除“所有”计算的列与前一列筛选器结合勾选此复选框,防止计算出的列在列值变化时被包含在成绩提取中。

  • 排除“全部”记录中成绩为空的记录勾选此复选框以防止成绩簿摘录中包含无成绩值的记录。

  • 列元数据验证如果选择“已启用预配”,会出现“列元数据验证”框。可选地,输入一组键值对及其在成绩列元数据中的预期出现次数,以判断课程是否可以被提取。如果这些参数未满足,系统将返回错误,课程数据将无法提取。

列映射

输入以管道符号分隔的名称/值对列表,以标识要包括在报表中的每条记录的成绩列数据字段。如果该字段为空,提取过程中会传递一个默认字段列表

一个示例映射如下:

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

附加列映射

如果你想将以下附加数据字段包含在萃取中,请开启启用切换开关:

  • 最后出勤日期 作业或评估尝试创建的最后日期。通过更新EXTRACTION KEY字段,可以修改该头值。默认值是 last_attendance_date

  • 教师反馈 教师或审核员对计算成绩栏提供的评论。通过更新EXTRACTION KEY字段,可以修改该头值。默认值是instructor_comment。由于教师反馈是在审批工作流程中提供的,此设置通常不适用于成绩簿摘录。

结果传输设置

NORMAL 积分选项

结果传输设置

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

  2. 选择转移方式。SFTP是最常见的传输方法其设置在这些步骤中描述。

  3. 选择转移类型

    • 每个文件每个课程都会生成一个单独的提取文件,并单独传输

    • 合并文件结果汇聚成一个文件,涵盖所有课程的批准行

  4. 如果在需要 Windows EOL 的 Windows 环境中处理,请启用使用 Windows EOL

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

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

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

  8. Password 字段输入SFTP密码。

  9. Path 字段输入提取文件的路径。

解压文件格式

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

  2. 场资格赛登场。如果提取的数据包含分隔符,则该字符应使用。默认是双引号(“)。

REST 集成选项

结果传输设置

  1. Post Webservice Endpoint字段中指定成绩的终点。

  2. 最大休止记录字段中输入单笔交易中包含的最大记录数。

其余(出站)安全选项

选择“是”以启用启用安全REST API。如果启用了,也设置安全机制。

OAuth 1.0
  • 共享秘密:输入OAuth共享秘密

  • API Key:输入 OAuth API 密钥

MAC安全

了解更多关于MAC安全的信息。

  • 共享秘密:进入共享秘密

  • API Key:输入 API 密钥

  • 时间戳参数:输入将表示查询字符串中时间戳值的参数

  • MAC参数:输入查询字符串中表示MAC值的参数

  • API 密钥参数:输入将表示查询字符串中 MAC 值的参数

OAuth 2.0

成绩导出会向已配置的 REST 令牌 URL 端点发送请求。授权将以请求头的形式发送。资助类型会client_credentials并发送在请求正文中:grant_type:“client_credentials”。

  • REST 密钥:输入用于访问 API 的密钥

  • REST Secret:输入将用于访问 API 的密钥

  • REST 令牌 URL:输入将用于请求访问令牌的 URL

选择提交以保存您的选择。