使用 SFTP 将学生、职员和班级数据上传到 Apple 校园教务管理中

如果 Apple 校园教务管理目前不支持您的学生信息系统 (SIS),或者您没有学生信息系统,您可以使用 SFTP 将学生、职员和班级数据上传到 Apple 校园教务管理中。

当您在“设置助理”中设置 SFTP 时,Apple 校园教务管理会向您提供 CSV 模板文件以及专用 SFTP 服务器的访问信息。您可以从 SIS 中导出数据,也可以在 Numbers 表格等电子表格应用程序中创建文件。

SFTP 上传功能需要 macOS 上装有一个第三方应用程序。如果还没有安装 SFTP 客户端,您可以在 Mac App Store 中找到这类客户端。

请使用下列按钮,就如何设置 SFTP 文件获取协助。如果您未使用过 SFTP 来将数据上传到 Apple 校园教务管理中,则应从“设置第一个 SFTP”部分开始。

设置第一个 SFTP 上传

  1. 以管理员、站点经理或人员经理的身份登录 Apple 校园教务管理。
  2. 首次登录时,会显示“设置助理”。如果没有显示“设置助理”,请点按右上角您的姓名。选取“设置助理”。
  3. 点按“查找学生、职员和班级”。
  4. 点按“设置 SFTP”。
  5. Apple 校园教务管理会生成一个 URL、用户名和密码,供您在上传文件时使用。请使用这些信息配置 SFTP 客户端。
  6. 点按“下载模板”。
  7. 阅读“填写数据文件”部分中的模板使用说明。
  8. 填写完数据文件后,创建一个包含全部六个文件的 zip 归档。您可以在“访达”中选择相关的文件,然后前往“文件”菜单并选取“压缩 6 项”。您可以为 zip 归档指定任意名称。
  9. 将 zip 文件上传到 Apple 校园教务管理中。使用 SFTP 客户端连接至“设置助理”中显示的 URL。如果系统要求输入登录信息,请使用您在点按“设置 SFTP”时收到的用户名和密码。将 zip 文件拷贝到 Dropbox 目录中。
  10. 在“设置助理”中点按“继续”。如果上传时出错,您可以查看日志,其中指明了包含错误的文件和行。更正数据文件中的任何错误,然后重复第 8 步和第 9 步。无需从 SFTP 服务器中移除之前的文件。
  11. SFTP 导入完成后,点按“查看 SFTP 数据”。如果发现任何错误,请点按“取消”。更正数据文件中的任何错误,然后重复上传过程。如果数据准确且完整,请点按“继续”。
  12. 在“创建帐户和班级”下方,为学生、教师和职员选取管理式 Apple ID 格式。点按“预览帐户和班级”。如果 ID 的格式正确无误,请点按“创建帐户和班级”。
  13. 帐户创建完成后,向相关用户分发登录信息,并向职员分配角色。

填写数据文件

下载的模板包含六个逗号分隔值 (CSV) 文件,分别为 Classes、Courses、Locations、Rosters、Students 和 Staff。如果 Apple 校园教务管理中没有提供这些模板,或者您丢失了原始模板副本,您可以重新下载它们

您可以使用 SIS 以模板和本文所述的格式导出数据,也可以在 Numbers 表格等电子表格程序中编辑模板。

请使用本文中的表格,以确保输入的信息正确无误,然后存储每个文件,而不要更改文件名。

设置值的格式

如果要编辑模板,请用您自己的数据替换示例数据。请勿更改每个文件中标题单元格的内容。不要在任何文件中添加列,但下文所述除外。

在每个模板中,每一行必须代表一个唯一的值。例如,在 students.csv 内,每一行中的学生必须是唯一的。这名学生的某些值可以为空。姓名中的字面值(如换行字符或引号字符)必须使用反斜杠 (\) 进行转义,例如 (\”)。输入的任何标识符必须采用字母数字字符,且可以包含“-”。

如果值包含空格 ( ) 或逗号 (,),请使用直引号将它括起来。如果值不包含任何上述特殊字符,则不要使用引号。如果在需要使用引号的情况下没有使用引号,或者使用了弯引号,那么在上传过程中会出现错误。

无论您以哪种方式创建文件,文件中的值都必须使用逗号 (,) 或分号 (;) 隔开。逗号或分号与下一个值之间不能包含空格或制表符。每个文件必须采用 UTF-8 进行编码,并使用 Unix 换行符 (\n)。 

person_number 或 sis_username 等栏位在其他情况下属于选填栏位,但如果它们是管理式 Apple ID 格式的一部分,则会变为必填栏位。如果将这些栏位留空,那么上传会失败,同时出现错误 MANAGED_ID_GENERATION_FAILED。

Locations 文件

location_id 由数字和/或字母组成的唯一标识符,不包含空格。 必填
location_name 位置的名称。  必填

您必须在 Locations 文件中定义至少一个位置。您无法使用 SFTP 来在主要“总部”位置中创建学生或职员帐户。

Students 文件

如果使用 SFTP 上传新的人员,并且分配的 person_id 已存在于 Apple 校园教务管理中,那么新的人员会覆盖 Apple 校园教务管理中的现有用户。覆盖后,您只能通过 SFTP 对这名用户进行更新。 

 

person_id

具体学生的唯一标识符。这个 person_id 应当与您 SIS(如果有)中的唯一标识符保持一致。这个 person_id 是这名学生在 Apple 校园教务管理中的唯一标识符。这个值用于在 Rosters 文件中指代对应学生和在 Classes 文件中指代对应教师。 

必填
person_number 可用来标识学校中某名学生的另一个值。这个值可以是学生证号。  选填
first_name 学生的名字。 必填
middle_name 学生的中间名。 选填
last_name 学生的姓氏。 必填
grade_level 学生所在的年级。 选填
email_address* 学生的电子邮件地址。 选填
sis_username 学生在 SIS 中的用户名。  选填
password_policy password_policy 栏位用于指定每名学生的密码策略。password_policy 栏位必须包含数字 4、数字 6、数字 8,或者留空。如果选择 8,则会采用标准的密码策略(8 个以上的字母数字字符)。这个值会覆盖位置的密码策略以及之前为这名学生设置的任何密码策略。如果将 password_policy 留空,则新的学生将适用位置的默认密码策略,而现有学生则不会发生任何更改。 选填
location_id 学生的 location_id。这个条目必须与 Locations 文件中的 location_id 相对应。如果这个条目与 Locations 文件中的条目不匹配,那么在上传过程中会出现问题。 必填

* 如果启用了联合验证,则必须填写电子邮件地址。如果电子邮件地址使用联合域名,那么用户帐户将会进行联合。

分配多个位置

您可以向一名学生分配多个位置,方法是在 Students 文件中添加更多位置列。最多可以另外添加 998 个位置列,这些列按照 location_id_2、location_id_3 的格式命名,到 location_id_999 结束。对于每名学生,您可以选择在上述每个列中输入另一个 location_id。这个条目必须与 Locations 文件中的 location_id 相对应。如果这个条目与 Locations 文件中的条目不匹配,那么在上传过程中会出现问题。

Staff 文件

如果使用 SFTP 上传新的人员,并且分配的 person_id 已存在于 Apple 校园教务管理中,那么新的人员会覆盖 Apple 校园教务管理中的现有用户。覆盖后,您只能通过 SFTP 对这名用户进行更新。所有职员都会收到标准的密码策略(8 个以上的字母数字字符)。

person_id

具体职员的唯一标识符。这个 person_id 应当与您 SIS(如果有)中的唯一标识符保持一致。这个 person_id 是这名职员在 Apple 校园教务管理中的唯一标识符。这个值用于在 Classes 文件中指代对应教师。 

必填
person_number 可用来标识学校中某名职员的另一个值。这个可以是职员工牌号。  选填
first_name 职员的名字。 必填
middle_name 职员的中间名。 选填
last_name 职员的姓氏。 必填
email_address* 这名职员的电子邮件地址。  选填
sis_username 职员在 SIS 中的用户名。 选填
location_id 职员的 location_id。这个条目应当与 Locations 文件中的 location_id 相对应。如果这个条目与 Locations 文件中的条目不匹配,那么在上传过程中会出现问题。 必填

* 如果启用了联合验证,则必须填写电子邮件地址。如果电子邮件地址使用联合域名,那么用户帐户将会进行联合。

分配多个位置

您可以向一名职员分配多个位置,方法是在 Staff 文件中添加更多位置列。最多可以另外添加 998 个位置列,这些列按照 location_id_2、location_id_3 的格式命名,到 location_id_999 结束。对于每名职员,您可以选择在上述每个列中输入另一个 location_id。这个条目必须与 Locations 文件中的 location_id 相对应。如果这个条目与 Locations 文件中的条目不匹配,那么在上传过程中会出现问题。

Courses 文件

course_id 课程的唯一标识符。这个条目必须与 Classes 文件中使用的 course_id 保持一致。  必填
course_number 课程的编号。这个编号可以是 SIS 或课程指南中的课程编号。 选填
course_name 课程的名称。 选填
location_id 课程的 location_id。这个条目应当与 Locations 文件中的 location_id 相对应。如果这个条目与 Locations 文件中的条目不匹配,那么在上传过程中会出现问题。
必填

Classes 文件

class_id 班级的唯一标识符。   必填
class_number 用来在机构中标识这个班级的编号或代码。与 class_id 不同,class_number 不能在 CSV 名单中用来指代这个班级。  选填
course_id 这个班级所属课程的 course_id。这个条目必须与 Courses 文件中的 course_id 保持一致。 必填
instructor_id 教师的 person_id。这个条目必须与 Staff 文件中的 person_id 保持一致。 选填
instructor_id_2 教师的 person_id。这个条目必须与 Staff 文件中的 person_id 保持一致。 选填
instructor_id_3 教师的 person_id。这个条目必须与 Staff 文件中的 person_id 保持一致。 选填
location_id 班级的 location_id。这个条目应当与 Locations 文件中的 location_id 相对应。如果这个条目与 Locations 文件中的条目不匹配,那么在上传过程中会出现问题。 必填

分配多名教师

您可以向一个班级分配三名以上教师,方法是在 Classes 文件中添加更多位置列。最多可以另外添加 12 个教师列,这些列按照 instructor_id_4、instructor_id_5 的格式命名,到 instructor_id_15 结束。对于每个班级,您可以选择输入教师的另一个 person_id。这个条目必须与 Staff 文件中的 person_id 保持一致。

Rosters 文件

roster_id 用来在 SIS 或其他课程数据库(如果有)中标识名单的唯一标识符。  必填
class_id 班级的唯一字母数字标识符。这个条目必须与 Class 文件中的 class_id 保持一致。
必填
student_id 某名学生的 person_id。  必填

Rosters 文件用来将学生添加至他们所在的班级。这个文件中的每个行必须拥有唯一的 roster_id,并且只能包含一个 class_id 和一个 person_id。

更新文件

当您想要添加或编辑学生、职员和班级时,请编辑您的数据文件并上传新的副本。每次上传文件时,您都必须上传全部六个文件,并且每个文件必须包含每个类别的完整列表,而不仅仅是包含您要添加的项目。您可以通过选取“设置”>“数据来源”来查看 SFTP 帐户信息。

如果您在 Apple 校园教务管理中意外断开了 SFTP 连接,那么您的各个帐户会变为手动状态,并且这些帐户会被停用。通过恢复 SFTP 连接,然后进行新的上传以重新激活相关帐户,您可以解决这个问题,而无需创建重复记录。

首次上传完成后,您之后上传时,系统会自动创建新的帐户和班级。如果出现任何错误,Apple 校园教务管理将向您发送一封电子邮件。

如果之前的上传有条目缺失

如果之前的上传有条目缺失,那么对应条目的来源会在 Apple 校园教务管理中更改为“手动”。移除时产生的额外影响可能不尽相同。如果从上传内容中移除了学生或职员,那么他们的帐户会在 30 天后停用并自动删除,除非对应帐户购买了批量购买内容。

如果课程或班级被移除

如果从上传内容中移除了课程或班级,那么学生会从对应班级中移除,并且来源状态会更改为“手动”。如果课程曾在 iTunes U 或“课业”中使用,那么名单会被移除,且必须创建新的课程才能重新注册。如果班级曾在“课业”中使用,那么进度数据会自动删除,且教师或学生不再能够查看这个数据。

来源处于手动状态的课程和班级会继续与 MDM 解决方案同步,但是可能不再出现在“课堂”应用 中。如果您希望从同步中移除处于手动状态的班级,可以在 Apple 校园教务管理中删除这些班级

有关非 Apple 制造的产品或非 Apple 控制或测试的独立网站的信息仅供参考,不代表 Apple 的任何建议或保证。Apple 对于第三方网站或产品的选择、性能或使用不承担任何责任。Apple 对于第三方网站的准确性和可靠性不作任何担保。互联网的使用具有一定风险。请联系供应商以了解其他信息。其他公司和产品名称可能是其各自所有公司的商标。

发布日期: