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