传入平面文件规格
创建作业
可以使用具有成绩导出功能的平面文件创建作业。下面提供了平面文件的示例，以及规范和说明。
注意
标题行必须包含下面列出的所有字段;但是，只需在记录中指定必填字段。
平面文件示例
courseId|name|instructions|anonymous|group|contentAreaName|available|colour|attempts|tracked|startDate|endDate|dueDate|points|gradeSchema|optionalData GETEST1|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。
字段标题 | 描述 | 必读 | 类型和最大尺寸 |
|---|---|---|---|
课程 ID | 应创建或更新此作业的课程的批处理 UID。 | 是 | 字符串（256 个字符） |
名称 | 作业的名称。 | 是 | 字符串（333 个字符） |
指示 | 作业说明。 | 否 | 字符串（2000 个字符） |
匿名 | 指示作业是否为匿名。 是/否 | 否 | 布尔值（默认 N） |
群 | 指示作业是否为组作业 是/否 | 否 | 布尔值（默认 N） |
内容区域名称 | 将在其中创建作业的课程菜单内容区域的名称。 | 否 | 字符串（255 个字符） 默认“作业” |
可用 | 作业的可用性。 是/否 | 否 | 布尔值（默认 N） |
颜色 | 赋值项颜色的颜色名称或十六进制字符串值。 | 否 | 字符串（10 个字符） |
尝试次数 | 授予作业的尝试次数。使用 -1 表示无限制。 | 否 | 整数（默认值 -1） |
跟踪 | 启用作业项的跟踪。 | 否 | 布尔值（默认 N） |
开始日期 | 显示作业的开始日期。 | 否 | 按照[传入设置]屏幕中指定的格式设置的日期。 未指定默认值。 |
结束日期 | 显示作业的截止日期。 | 否 | 按照[传入设置]屏幕中指定的格式设置的日期。 未指定默认值。 |
到期日期 | 作业的到期日期。 | 否 | 按照[传入设置]屏幕中指定的格式设置的日期。 未指定默认值。 |
分数 | 作业可能的分数。 | 否 | 浮点（默认 100.0） |
gradeSchema | 应用于成绩中心作业的成绩架构显示。提供的字符串必须与目标课程中成绩架构的名称匹配，才能应用设置。 | 否 | 字符串（333 个字符） 默认行为为分数。 |
可选数据 | 键/值对，每组对用冒号分隔，键/值用等号分隔。例如： key1 = value1:key2 = value2 最常用于在提取时跟踪唯一值，以便将记录与源系统进行匹配。 | 否 | 字符串（每个键/值对 2000 个字符） |
创建成绩中心列（计算）
可以使用具有成绩导出功能的平面文件创建成绩中心计算的加权列。需要在成绩中心内手动将列和权重添加到创建的计算加权列中。
注意
标题行必须包含下面列出的所有字段;但是，只需在记录中指定必填字段。
平面文件示例
courseId|name|description|duedate|points|gradeSchema|optionalData GETEST1|GC Calculated Grade||2023-10-30|10.0|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
文件规格
文件名应以 .col 结尾;例如，term2023_01.col。
字段标题 | 描述 | 必读 | 类型和最大尺寸 |
|---|---|---|---|
课程 ID | 应创建或更新此成绩列的课程的批处理 UID。 | 是 | 字符串（256 个字符） |
名称 | 成绩列的名称。 此字段用于匹配。 | 是 | 字符串（333 个字符） |
描述 | 等级列的描述。 | 否 | 字符串（2000 个字符） |
到期日期 | 成绩列的到期日期。 | 否 | 按照[传入设置]屏幕中指定的格式设置的日期。 未指定默认值。 |
分数 | 成绩列的可能分数。 | 否 | 浮点（默认 100.0） |
gradeSchema | 应用于要显示的成绩列的成绩架构。提供的字符串必须与目标课程中成绩架构的名称匹配，才能应用设置。 | 否 | 字符串（333 个字符） 默认行为为分数。 |
可选数据 | 键/值对，每组对用冒号分隔，键/值用等号分隔。例如： key1 = value1:key2 = value2 最常用于在提取时跟踪唯一值，以便将记录与源系统进行匹配。 | 否 | 字符串（每个键/值对 2000 个字符） |
创建成绩中心列（未计算）
此界面的目的是创建或更新成绩簿列。
注意
标题行必须包含下面列出的所有字段;但是，只需在记录中指定必填字段。
平面文件示例
courseId|name|description|duedate|points|gradeSchema|optionalData GETEST1|GC Final Grade||2023-12-30|100|Schema1|MOD_CODE=2023MOD1:SESSION=8W1
文件规格
文件名应以 .colnc 结尾;例如，term2023_01.colnc。
字段标题 | 描述 | 必读 | 类型和最大尺寸 |
|---|---|---|---|
课程 ID | 应创建或更新此成绩列的课程的批处理 UID | 是 | 字符串（256 个字符） |
名称 | 成绩列的名称。 此字段用于匹配。 | 是 | 字符串（333 个字符） |
描述 | 等级列的描述。 | 否 | 字符串（2000 个字符） |
到期日期 | 成绩列的到期日期。 | 否 | 按照[传入设置]屏幕中指定的格式设置的日期。 未指定默认值。 |
分数 | 成绩列的可能分数。 | 否 | 浮点（默认 100.0） |
gradeSchema | 应用于要显示的成绩列的成绩架构。提供的字符串必须与目标课程中成绩架构的名称匹配，才能应用设置。 | 否 | 字符串（333 个字符） 默认行为为分数。 |
可选数据 | 键/值对，每组对用冒号分隔，键/值用等号分隔。例如： key1 = value1:key2 = value2 最常用于在提取时跟踪唯一值，以便将记录与源系统进行匹配。 | 否 | 字符串（每个键/值对 2000 个字符） |
设置外部成绩列（仅限原始课程）
此界面的目的是将列设置为外部成绩列。要将列标记为外部列，必须预配或创建成绩列。
注意
标题行必须包含下面列出的所有字段;但是，只需在记录中指定必填字段。
平面文件示例
courseId|name GETEST1|GC Final Grade
文件规格
文件名应以 .colext 结尾;例如，term2017_01.colext。
字段标题 | 描述 | 必读 | 类型和最大尺寸 |
|---|---|---|---|
课程 ID | 应创建或更新此成绩列的课程的批处理 UID。 | 是 | 字符串（256 个字符） |
名称 | 成绩列的名称。 此字段用于匹配。 | 是。 | 字符串（333 个字符） |
创建成绩列值（未计算）
此接口的目的是创建成绩簿列的值。
注意
标题行必须包含下面列出的所有字段;但是，只需在记录中指定必填字段。
平面文件示例
courseId|userId|name|value GETEST1|User001|GC Final Grade|90
文件规格
文件名应以 .colncval 结尾;例如，term2023_01.colncval。
字段标题 | 描述 | 必读 | 类型和最大尺寸 |
|---|---|---|---|
课程 ID | 应创建或更新此成绩列的课程的批处理 UID。 | 是 | 字符串（256 个字符） |
用户 ID | 应为其创建或更新此成绩值的用户的user_id | 是 | 字符串（333 个字符） |
名称 | 成绩列的名称。 此字段用于匹配。 | 是 | 字符串（2000 个字符） |
价值 | 要分配的值。 | 是 | 字符串（2000 个字符） |
创建成绩架构
可以使用带有成绩旅程服务的平面文件创建成绩架构。创建作业或成绩列的其他文件可能取决于此文件中的成绩架构定义，但数据处理器不会强制执行特定的运行顺序。因此，应确保在运行其他依赖数据文件之前处理成绩架构数据。
注意
标题行必须包含下面列出的所有字段;但是，只需在记录中指定必填字段。
平面文件示例
title|symbols|optionalData Schema1|A=90:B=80:C=70:D=60:F=0|
文件规格
文件名应以 .sch 结尾;例如，term2023_01.sch。
字段标题 | 描述 | 必读 | 类型和最大尺寸 |
|---|---|---|---|
称谓 | 评分方案的标题 | 是 | 字符串（333 个字符） |
符号 | 列表中具有（可选）下限的符号，用冒号分隔。 | 是 | 字符串（2000 个字符） |
可选数据 | 键/值对，每组对用冒号分隔，键/值用等号分隔。例如： key1 = value1:key2 = value2 最常用于在提取时跟踪唯一值，以便将记录与源系统进行匹配。 | 否 | 字符串（每个键/值对 2000 个字符） |