用于将数据导入到 Apple 校园教务管理的模板信息
要将数据添加到 Apple 校园教务管理，你可以使用 Apple 格式或 OneRoster 格式的 .csv 模板文件。
Apple .csv 模板名称：学生、职员、课程、班级、名单、位置
OneRoster .csv 模板名称：用户、课程、班级、注册、组织
Apple 文件名 | OneRoster 文件名 | 内容 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
Apple：包含学生账户信息。 OneRoster：包含学生、教师和职员账户信息。 | |||||||||||
不适用 | 包含职员账户信息，例如教师。 | ||||||||||
包含课程信息。 | |||||||||||
包含班级和教师（职员）信息。 | |||||||||||
包含班级、学生和位置（名单）信息。 | |||||||||||
包含位置（学校或科系）信息。 | |||||||||||
模板和管理式 Apple 账户
如果某个可选字段（例如 person_number 或 sis_username）是管理式 Apple 账户格式的一部分，则该字段将变为必填项。如果将它留空，SFTP 上传会失败，并显示错误 MANAGED_ID_GENERATION_FAILED。
准备模板
准备模板时，必须遵循以下要求：
结构
.csv 文件的名称须与原始文件名完全一致。
请勿更改任何文件中的标题行名称。
请勿删任何除列，即使该列为空。
在每个模板中，每一行代表的值不能重复。例如，在 students.csv 文件中，每一行必须代表一个不重复的学生。
对于 students.csv 和 staff.csv 模板，所有位置的 person_id 不能出现重复的情况。
【重要事项】如果是使用 SFTP 上传新用户，并且你所分配的 person_id 已分配给其他用户，则新用户会覆盖 Apple 校园教务管理中的现有用户。覆盖完成后，你只能通过 SFTP 更新该用户。
某些值可以为空。例如，在 students.csv 文件中，中间名可以为空。
请将示例数据替换为你自己的数据。
正在格式化
字面值（例如名称中的换行符或引号）必须使用反斜线（\）进行转义，例如 \”。输入的所有标识符都必须为字母数字，可以包括连字符（-）。
如果你的值包含空格（ ）或逗号（,），请使用直引号（"）将该值引起来。如果你的值不含上述任何特殊字符，请勿使用引号。如果你在需要使用引号的地方没有使用引号，或使用了弯引号，那么上传过程将会出错。
无论你通过何种方式创建文件，文件中的值都必须以逗号（,）或分号（;）分隔。请勿在逗号或分号与下一个值之间使用空格或制表符。每个文件必须使用 UTF-8 编码。若要表示行结尾，请使用 UNIX 换行符编码 \n。
所有指向其他 .csv 文件的外部键引用必须在引用文件中定义。
正在上传
如果先前上传中的某个条目缺失，则除非出现以下情况，否则用户账户会被停用，并在 120 天后自动删除：
用户具有批量购买过 App 或图书的职务
在 120 天期限之前手动删除了用户
所有文件必须压缩为一个压缩 (.zip) 归档文件才能上传。
不能将文件置入文件夹后再放入压缩归档文件。
.csv 模板中的字符限制
.csv 模板中的某些字段对允许的字符数有限制。
属性名称 | 模板 | 字符限制 |
|---|---|---|
Apple：first_name OneRoster：givenName | Apple：学生、职员 OneRoster：用户 | 32 |
Apple：middle_name OneRoster：middleName | Apple：学生、职员 OneRoster：用户 | 32 |
Apple：last_name OneRoster：familyName | Apple：学生、职员 OneRoster：用户 | 64 |
Apple：grade_level OneRoster：grades | Apple：学生 OneRoster：用户 | 64 |
Apple：email_address OneRoster：email | Apple：学生 OneRoster：用户 | 256 |
Apple：person_number OneRoster：identifier | Apple：学生、职员 OneRoster：用户 | 64 |
Apple：person_id OneRoster：sourcedId | Apple：学生、职员、班级、名单 OneRoster：用户、班级、注册 | 256 |
Apple：sis_username OneRoster：username | Apple：学生、职员 OneRoster：用户 | 256 |
Apple：class_id OneRoster：sourcedID | Apple：班级、名单 OneRoster：班级、注册 | 256 |
Apple：class_number OneRoster：classCode | Apple：学生、班级 OneRoster：班级 | 64 |
Apple：course_id OneRoster：sourcedID | Apple：课程、班级 OneRoster：课程、班级 | 256 |
Apple：course_name OneRoster：title | Apple：课程 OneRoster：课程 | 128 |
Apple：course_number OneRoster：courseCode | Apple：课程 OneRoster：课程 | 64 |
Apple: location_name OneRoster: name | Apple：位置 OneRoster：组织 | 256 |
Apple：location_id OneRoster：sourcedID | Apple：学生、职员、课程、班级、位置 OneRoster：用户、课程、班级、组织 | 256 |