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

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

设置第一个 SFTP 上传

填写数据文件

更新文件

当你在 SIS/SFTP 助理中设置 SFTP 时，Apple 校园教务管理会向你提供 CSV 模板文件，以及专用 SFTP 服务器的访问信息。你可以从受支持的 SIS 导出数据，也可以在 Numbers 表格等电子表格应用程序中创建相应的文件。从 SIS 导出数据之前，请联系你的 SIS，以确保使用适用于 Apple 校园教务管理的正确格式。

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

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

设置第一个 SFTP 上传

1. 以管理员、站点经理或人员经理的身份登录 Apple 校园教务管理。

2. 在边栏底部点按你的姓名，然后依次点按“偏好设置”、“帐户”、“目录同步”，再在 SIS/SFTP 部分中选择“启用”。你必须先验证域名

3. 点按“查找学生、教师和班级”。

   

4. 点按“设置 SFTP”。

   

5. Apple 校园教务管理会生成一个 URL、用户名和密码，供你在上传文件时使用。请使用这些信息来配置 SFTP 客户端。

   

6. 点按“下载模板”。

7. 阅读“填写数据文件”部分中的模板使用说明。

8. 填写完数据文件后，创建一个包含全部六个文件的 zip 归档。你可以在“访达”中选择相应文件，然后前往“文件”菜单并选取“压缩 6 个项目”。你可以为 zip 归档指定任意名称。

9. 将 zip 文件上传到 Apple 校园教务管理中。使用 SFTP 客户端连接到 SIS/SFTP 助理中显示的 URL。如果系统要求输入登录信息，请使用你在点按“设置 SFTP”时收到的用户名和密码。将 zip 文件拷贝到 Dropbox 目录中。

10. 在 SIS/SFTP 助理中点按“继续”。如果上传时出错，你可以查看日志，其中指明了包含错误的文件和行。更正数据文件中的任何错误，然后重复第 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 文件

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

Students 文件

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

分配多个位置

你可以向一名学生分配多个位置，方法是在 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 个以上的字母数字字符）。

分配多个位置

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

Courses 文件

Classes 文件

分配多名教师

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

Rosters 文件

更新文件

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

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

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

如果之前的上传有条目缺失，则相应账户会在 120 天后被停用并自动删除，除非这个账户购买了批量内容。

如果课程或班级被移除

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

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