在 Apple 校园教务管理中使用 OneRoster 注册模板
使用 OneRoster 注册模板导入班级名单。在组织内,每个位置的每个 sourcedID 模板中的每一行的每个 sourcedID 值都必须唯一。例如,如果 OneRoster 注册模板有 600 名学生,即有 600 行唯一 sourcedID 值、每个学生的 sourcedID 值以及学生的关联班级 sourcedID 值。
它还必须包含每门课程的班级 sourcedID 值,并且包含至少一个学生 sourcedID 值。按行添加其他学生。例如,10 名学生即需要 10 行,每名学生一行。
值 | 描述 | 示例 | 必填/唯一 | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
sourcedID | 在 SIS 或其他数据库中唯一能用来识别此注册的编号。 | BE8FF4CC-5BE2-47C6-9C42-6CDADB9072F8 | 是/是 | ||||||||
classSourcedID | 班级的 sourcedID。 | F9BF05A9-E40B-4CAD-9B4A-2E0C09EDCCC4 | 是/否 | ||||||||
userSourcedID | 班级就读学生或授课教师的 sourcedID。 | AE4A6BB3-8D97-446A-BAA9-EDEA567453D3 | 是/否 | ||||||||
role | 此人的职务。有两个选项:“学生”和“教师”。 | 学生 | 是/否 | ||||||||
schoolSourcedID | 此班级所属的学校或科系的 sourcedID。 | DF48675-8307-446A-BAA9-EDEA567493D3 | 否/否 | ||||||||
primary | 仅适用于职务为“教师”的用户。有两个选项:“true”和“false”。 在由开始日期和结束日期定义的时段内,只能指定一名用户为班级的主要教师。 | TRUE | 否/否 | ||||||||
beginDate | 注册的开始日期。该日期必须与为班级标识的相关学年(学期)保持一致。 | 2026-08-22 | 否/否 | ||||||||
endDate | 注册的结束日期(不含当日)。该日期必须与为班级标识的相关学年(学期)保持一致。 | 2027-05-30 | 否/否 | ||||||||
status | 注册记录的状态。有两个选项:“active”或“tobedeleted”。 | active | 否/否 | ||||||||
dateLastModified | 上次修改此注册信息的日期。日期必须使用 ISO 8601 格式(更常用的格式是 YYYY-MM-DD)表示。 | 2024-06-26 | 否/否 |