接收平面文件规范
创建作业
作业可以通过带有成绩导出功能的平面文件创建。下面提供了平面文件的示例，以及规格和描述。
注意
头部行必须包含以下列出的所有字段;但记录中只需指定所需字段。
平面文件示例
courseId|name|instructions|anonymous|group|contentAreaName|available|colour|attempts|tracked|startDate|endDate|dueDate|points|gradeSchema|optionalData
GJTEST1|Assignment 2|assignment instructions|false|false|Assignments|true||1|false|2023-10-17|2023-10-31|2023-10-31|100.0|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
文件规范
文件名应以.asg结尾;例如，term2023_01.ASG。
场头 | 描述 | 必需 | 类型与最大尺寸 |
|---|---|---|---|
courseId | 该作业应创建或更新的课程批处理 UID。 | 是 | 字符串（256字符） |
name | 任务名称。 | 是 | 字符串（333字符） |
说明 | 作业说明。 | 否 | 弦（2000字符） |
匿名 | 表示该作业是否为匿名。 Y/N | 否 | 布尔值（默认 N） |
群 | 表示该作业是否属于小组作业 Y/N | 否 | 布尔值（默认 N） |
内容区域名称 | 作业将创建的课程菜单内容区名称。 对于Ultra课程，这个标题可以用来配置一个子文件夹并将内容放入子文件夹。该值的格式为“parent@>@child”，其中“parent”是顶层（父）文件夹的名称，“child”是子文件夹的名称。如果子文件夹已经存在，作业会被添加到现有子文件夹中。如果子文件夹不存在，则会在父文件夹中创建。 | 否 | 字符串（255字符） 默认“作业” |
可用 | 作业的可用性。 Y/N | 否 | 布尔值（默认 N） |
颜色 | 分配项颜色的颜色名称或十六进制字符串值。 | 否 | 字符串（10个字符） |
尝试 | 该作业获批的尝试次数。无限用-1。 | 否 | 整数（默认 -1） |
跟踪 | 启用作业项目的追踪功能。 | 否 | 布尔值（默认 N） |
startDate | 作业日期显示。 | 否 | 日期格式格式为“入站设置”界面。 默认未指定值。 |
结束日期 | 显示作业日期。 | 否 | 日期格式格式为“入站设置”界面。 默认未指定值。 |
dueDate | 作业到期日期。 | 否 | 日期格式格式为“入站设置”界面。 默认未指定值。 |
点 | 作业可获得积分。 | 否 | 浮点数（默认100.0） |
gradeSchema | 成绩图应用于作业，用于成绩中心显示。所提供的字符串必须与目标课程中的成绩模式名称相匹配，才能应用该设置。 | 否 | 字符串（333字符） 默认行为是分数。 |
optionalData | 键值对中每组对之间用冒号分隔，键值之间用等号分隔。例如： key1 = value1:key2 = value2 最常用于在提取时跟踪唯一值，以便将记录与源系统匹配。 | 否 | 字符串（每个键/值对2000字符） |
创建成绩中心列（计算）
成绩中心可以通过带有成绩导出功能的平面文件创建计算加权列。栏和权重需要在成绩中心手动添加到已创建的加权栏中。
注意
头部行必须包含以下列出的所有字段;但记录中只需指定所需字段。
平面文件示例
courseId|name|description|duedate|points|gradeSchema|optionalData
GJTEST1|GC Calculated Grade||2023-10-30|10.0|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
文件规范
文件名应以 .col 结尾;例如，学期2023_01.col.
场头 | 描述 | 必需 | 类型与最大尺寸 |
|---|---|---|---|
courseId | 要创建或更新此成绩列的课程的批处理 UID。 | 是 | 字符串（256字符） |
name | 成绩栏的名称。 该字段用于匹配。 | 是 | 字符串（333字符） |
描述 | 成绩栏描述。 | 否 | 弦（2000字符） |
dueDate | 成绩栏的到期日期。 | 否 | 日期格式格式为“入站设置”界面。 默认未指定值。 |
点 | 成绩列的满分。 | 否 | 浮点数（默认100.0） |
gradeSchema | 成绩模式应用到成绩栏以供展示。所提供的字符串必须与目标课程中的成绩模式名称相匹配，才能应用该设置。 | 否 | 字符串（333字符） 默认行为是分数。 |
optionalData | 键值对中每组对之间用冒号分隔，键值之间用等号分隔。例如： key1 = value1:key2 = value2 最常用于在提取时跟踪唯一值，以便将记录与源系统匹配。 | 否 | 字符串（每个键/值对2000字符） |
创建成绩中心列（未计算）
该界面的目的是创建或更新成绩簿栏。
注意
头部行必须包含以下列出的所有字段;但记录中只需指定所需字段。
平面文件示例
courseId|name|description|duedate|points|gradeSchema|optionalData
GJTEST1|GC Final Grade||2023-12-30|100|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
文件规范
文件名应以.colnc结尾;例如，term2023_01.colnc。
场头 | 描述 | 必需 | 类型与最大尺寸 |
|---|---|---|---|
courseId | 要创建或更新此成绩列的课程的批处理 UID | 是 | 字符串（256字符） |
name | 成绩栏的名称。 该字段用于匹配。 | 是 | 字符串（333字符） |
描述 | 成绩栏描述。 | 否 | 弦（2000字符） |
dueDate | 成绩栏的到期日期。 | 否 | 日期格式格式为“入站设置”界面。 默认未指定值。 |
点 | 成绩列的满分。 | 否 | 浮点数（默认100.0） |
gradeSchema | 成绩模式应用到成绩栏以供展示。所提供的字符串必须与目标课程中的成绩模式名称相匹配，才能应用该设置。 | 否 | 字符串（333字符） 默认行为是分数。 |
optionalData | 键值对中每组对之间用冒号分隔，键值之间用等号分隔。例如： key1 = value1:key2 = value2 最常用于在提取时跟踪唯一值，以便将记录与源系统匹配。 | 否 | 字符串（每个键/值对2000字符） |
设置外部成绩栏（仅限原始课程）
该界面的目的是将一列设置为外部成绩列。要将某列标记为外部，必须配置或创建一个成绩列。
注意
头部行必须包含以下列出的所有字段;但记录中只需指定所需字段。
平面文件示例
courseId|name
GJTEST1|GC Final Grade
文件规范
文件名应以.colext结尾;例如，term2017_01.colext.
场头 | 描述 | 必需 | 类型与最大尺寸 |
|---|---|---|---|
courseId | 要创建或更新此成绩列的课程的批处理 UID。 | 是 | 字符串（256字符） |
name | 成绩栏的名称。 该字段用于匹配。 | 是。 | 字符串（333字符） |
创建成绩栏值（未计算）
该界面的目的是创建成绩簿栏的数值。
注意
头部行必须包含以下列出的所有字段;但记录中只需指定所需字段。
平面文件示例
courseId|userId|name|value
GJTEST1|User001|GC Final Grade|90
文件规范
文件名应以 .colncval 结尾;例如，term2023_01.colncval。
场头 | 描述 | 必需 | 类型与最大尺寸 |
|---|---|---|---|
courseId | 要创建或更新此成绩列的课程的批处理 UID。 | 是 | 字符串（256字符） |
用户ID | 该成绩值应被创建或更新的用户user_id | 是 | 字符串（333字符） |
name | 成绩栏的名称。 该字段用于匹配。 | 是 | 弦（2000字符） |
价值 | 需要赋予价值。 | 是 | 弦（2000字符） |
创建成绩结构
成绩模式可以通过Grades Journey服务的平面文件创建。其他创建作业或成绩列的文件可能依赖于该文件中的成绩模式定义，但数据处理器不会强制执行特定的运行序列。因此，你应确保在运行其他依赖数据文件前处理好成绩模式数据。
注意
头部行必须包含以下列出的所有字段;但记录中只需指定所需字段。
平面文件示例
title|symbols|optionalData
Schema1|A=90:B=80:C=70:D=60:F=0|
文件规范
文件名应以 .sch 结尾;例如，term2023_01.sch.
场头 | 描述 | 必需 | 类型与最大尺寸 |
|---|---|---|---|
称谓 | 评分方案标题 | 是 | 字符串（333字符） |
符号 | 列表中带有（可选）下界的符号，并以冒号分隔。 | 是 | 弦（2000字符） |
optionalData | 键值对中每组对之间用冒号分隔，键值之间用等号分隔。例如： key1 = value1:key2 = value2 最常用于在提取时跟踪唯一值，以便将记录与源系统匹配。 | 否 | 字符串（每个键/值对2000字符） |