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

列过滤器

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

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

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

  • 启用配置如果您只想显示从学生信息系统 (SIS) 导入并提供给评分员的评分项中的成绩列，请选中此复选框。此设置优先于“列过滤器”设置。

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

列映射

请输入以竖线符号分隔的名称/值对列表，以标识报告中每条记录要包含的等级列数据字段。如果此框留空，则会在提取数据时传递默认字段列表。

一个示例映射如下：

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. 输入要用于提取文件的字段分隔符。默认值为 pipe ( | )。

  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. 选择只允许提取物作为批准成绩的吗？是为了防止未被批准状态的成绩被提取。如果评分员尝试手动提取未处于批准状态的成绩，会收到错误提示。

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

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

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

    注意

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

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

    注意

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

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

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

  12. 选择直接启动到年级可将成绩审批和转移工具直接启动到年级，绕过课程和列级别的审批屏幕。

  13. 选择直接启动到列级即可直接启动成绩批准与转移工具，绕过课程级审批界面。

    注意

    如果你同时选择直接发布到年级和直接发布到列级选项，成绩批准和转移工具就会启动到列级。

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

  15. 选择验证成绩以防止无效成绩被提交、批准或提取，基于在“常规设置”部分配置的有效成绩。如果评分员尝试提交、批准或提取无效成绩，会收到错误信息。

成绩显示值配置

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

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

  • 模式值：返回成绩列主显示

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

  • 辅助模式值：返回成绩列的辅助显示（仅适用于原始课程）

  • 评分值：返回分数值

年级中心只读（原版）

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

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

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

  • 成绩列截止日期之后：选定的成绩列截止日期过后，锁定成绩中心

    注意

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

  • 禁用：不锁成绩中心。

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

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

  • 锁定成绩列名称：输入成绩列的名称，该成绩列的截止日期将用于确定何时锁定成绩中心

  • 锁定课程的时间：（可选）输入锁定作业的运行时间。如果未输入时间，则作业将在午夜运行。

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

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

  • 锁定批准异常（小时）：（可选）输入一个值，表示具有审批人权限的角色在锁定事件发生后仍能访问成绩中心的时长（以小时为单位）。

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

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

    注意

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

成绩中心（只读，Ultra）

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

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

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

  • 成绩列截止日期之后：选定的成绩列截止日期过后，锁定成绩中心

    注意

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

    注意

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

  • 禁用：不锁成绩中心。

开启增强只读功能开关，设置 Ultra 课程的锁定成绩列名和锁定课程时间。

  • 锁定成绩列名称：输入成绩列的名称，该成绩列的截止日期将用于确定何时锁定成绩中心

  • 锁定课程的时间：（可选）输入锁定作业的运行时间。如果未输入时间，则作业将在午夜运行。

注意

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

选择一个或多个版位

指定用于在 Original 和 Ultra 课程中运行 成绩审批与传输 工具的 LTI 放置位置。教师工具 和 管理员工具 是必需的放置项。选择 在新窗口中启动 可使 LTI 在单独的窗口中打开。

选择提交保存所有选项。