Skip to main content

配置审批工作流程

如果启用了审批工作流程，会配置为按特定进度运行，并自动提取已批准的成绩。要访问审批工作流程的成绩提取设置：

  1. 访问管理员面板。

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

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

  4. 在APPROVAL_WORKFLOW行配置列中选择放大镜。

这样你就能进入成绩采件设置标签。该标签页有七个可展开的部分。

一般设定

  1. 选择集成类型。

    • NORMAL 集成：分隔文件格式

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

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

  2. CRON 计划决定了批准成绩文件被提取的频率。开启启用？切换：如果你想让进程按照指定的CRON计划运行，然后输入CRON表达式来指定提取频率。

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

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

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

    注意

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

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

术语过滤器

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

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

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

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

柱滤波器

列筛选用于确定哪些成绩列会显示给评分员以供审核。一次只能激活一个过滤器选项。

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

  • 仅外部成绩栏（原始）或总体成绩（超高）如果您只想向评分者显示外部成绩栏（原课程）或整体成绩栏（超高课程），请勾选此复选框。该设置优先于列过滤器设置和配置启用设置。

  • 启用配置如果你只想显示作为学生信息系统中可评分项目一部分的成绩列，请选择此复选框。该设置优先于列过滤器设置。

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

列映射

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

一个示例映射如下：

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。

摘录课程角色设置

  1. 打开启用提交者工作流程 切换，在提交成绩给审核员的工作流程中添加额外步骤（例如，助教提交成绩供教师批准）。

  2. 对于需要批准的角色，请指定用户启动成绩审批流程所需的课程角色（例如讲师）。如有需要，还需指定任何额外的机构职务以批准成绩（如成绩审核员）。拥有上述任一角色的用户都可以批准成绩。

  3. 对于提交所需角色，请指定用户启动提交成绩审批流程所需的课程角色（如助教）。如有需要，还需指定提交成绩所需的其他机构职务（如成绩提交员）。拥有上述任一角色的用户都可以提交成绩。

    注意

    该设置仅在启用提交者工作流程时显示。

  4. 拒绝访问的提示不应在此填写;自定义拒绝访问的消息现在已在配置角色界面输入。

结果传输设置

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

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

请填写以下字段：

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

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

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

成绩批准与转学设置

成绩批准与转移设置

  1. 启用成绩批准需求以实现列级或年级级别的成绩批准。如果未启用此功能，成绩只能在课程层面批准。

  2. 选择启用提取成绩按钮以使批准者显示“提取成绩”按钮。平地人员可以立即运行提取物。对于NORMAL集成，只有当传输类型设置为每个文件时，提取才会被生成并发送。

    注意

    “抽取成绩”按钮始终会显示给成绩审核管理员用户。

  3. 选择提交成绩按钮已启用？要让提交成绩按钮出现在提交者中。

    注意

    如果未启用提交者工作流程，这个复选框将被隐藏。

    如果启用了提交者工作流程，成绩审核管理员用户将始终显示“提交成绩”按钮。

  4. 选择仅允许对已提交成绩进行批准以防止状态与提交不同的成绩被批准或不批准。

    注意

    如果未启用提交者工作流程，这个复选框将被隐藏。

  5. Select Only allow extract for approved grades? to prevent grades that are not in the Approved status from being extracted. If a grader tries to manually extract grades that are not in the Approved status, they will receive an error message.

  6. 选择启用教师反馈如果教师反馈栏应在成绩批准区域中对与计算和手动相关成绩的成绩开放。

  7. 选择允许课程搜索以选择成绩审核员？高级搜索链接是否应该在成绩批准区对教师可见，以便他们搜索被分配的其他课程。

  8. 选择启用“批准成绩”按钮？让批准成绩按钮出现在审核员面前。

    注意

    成绩批准管理员用户的“批准成绩”按钮始终会显示。

  9. 选择仅允许有理由提示的取消批准？以防止成绩在未输入理由的情况下，在成绩批准与转移工具中被未批准。

    注意

    如果未启用提交者工作流程，复选框将被隐藏。

  10. 选择限制儿童课程仅对提交者或批准者访问以限制提交者或批准者只能看到其分配到的儿童课程成绩学生。

  11. 选择限制作至年级层级以阻止课程和成绩栏层级的所有成绩批准作。提交者和审核员只能在成绩层级采取行动。

  12. 直接启动到成绩设置是审批工作流程即将推出的功能，不应选择。

  13. 选择包含未公布成绩以包含未在成绩摘录中发布的成绩。这不包括手动柱或成绩已被覆盖但尚未公布的柱。

  14. Select Validate Grades to prevent invalid grades from being submitted, approved, or extracted, based on the valid grades that are configured in the General Settings section. If a grader tries to submit, approve, or extract invalid grades, they will receive an error message.

成绩显示值配置

将成绩值设置为在审批工作流程中显示：

  • 成绩字母：如果模式值是一个字母，则返回字母成绩;否则，它将返回空字符串

  • Schema Value：返回成绩栏 主显示

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

  • 次要模式值：返回成绩栏 次要显示（仅适用于原始课程）

  • 评分值：返回评分值

年级中心只读（原版）

以下选项仅适用于原始课程体验。Ultra课程体验的选项详见下一节。

你可以锁定课程成绩中心，并将试图访问成绩的用户引导到只读页面。对于批准锁定，请选择以下三种选项之一：

  • 批准后立即：在批准人批准该课程成绩后立即锁定成绩中心

  • 成绩栏到期日期后：在已选定成绩栏到期日期后锁定成绩中心

    注意

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

  • 残疾人：不要锁成绩中心。

开启增强只读功能并切换以设置原创课程的额外只读功能。

  • 页面标题：为只读页面输入页面标题

  • 锁定成绩栏名称：输入成绩栏名称，用于确定成绩中心何时锁定到期日期

  • 锁定航线时间：可选地输入锁定作业运行的时间。如果未输入时间，任务将在午夜进行。

  • 保持解锁的手动解锁课程时间（小时数）：可选地输入手动解锁课程保持解锁时间（以小时计）后自动再次锁定

  • 自动锁定成绩中心（小时）的时间：可选地输入成绩中心在成绩审批事件发生后必须锁定多长时间（以小时计）

  • 锁定批准异常（小时数）：可选地输入一个拥有审批权限的角色在锁定事件后仍可访问成绩中心的时间（以小时计）

  • 锁定未批准例外（小时数）：可选地输入一个拥有提交权限的角色在锁定后仍能访问成绩中心的时间（以小时计），即使存在未批准的成绩

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

    注意

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

成绩 Center 只读（Ultra）

以下选项仅适用于Ultra课程体验。原始课程体验的选项已在上一节介绍。

你可以锁定课程成绩中心，并将试图访问成绩的用户引导到只读页面。对于锁定批准，你有以下选项：

  • 批准立即：此选项不适用于超只读视图

  • 成绩栏到期日期后：在已选定成绩栏到期日期后锁定成绩中心

    注意

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

    注意

    您可以在锁定任务完成后，根据需要临时解锁课程。

  • 残疾人：不要锁成绩中心。

开启增强只读功能切换以设置超高课程的锁定成绩列名和锁定课程时间。

  • 锁定成绩栏名称：输入成绩栏名称，用于确定成绩中心何时锁定到期日期

  • 锁定航线时间：可选地输入锁定作业运行的时间。如果未输入时间，任务将在午夜进行。

注意

其他增强版只读功能都不适用于Ultra课程。

选择一个或多个位置

指定将用于运行原创和超课程成绩批准和转学工具的LTI实习。教师工具和管理员工具是必修的配置。选择在新窗口启动以让LTI在独立窗口中打开。

选择提交以保存所有选项。