OneRoster 是由IMS Global开发的数据标准，旨在减轻学校在更新教师和课程信息方面的管理负担。
使用 OneRoster， Atlas可以添加新用户，并相应地更新他们对单元和课程的访问权限。整个过程可以自动化，从而节省管理员在课程存档后进行年度更新（用户和课程）的时间。
Atlas支持团队需要为您的Atlas站点启用“OneRoster 同步”功能。请通过提交请求联系我们以启动此流程。我们将与您协调初始设置，并在首次上传前审核您的 CSV 文件。
兼容性
- 第三方服务商，例如Clever和ClassLink。 将您的SIS数据转换为OneRoster文件。
- Blackbaud、Realtime、RenWeb/FACTS、SIMS、Rediker、SchoolTool 等SIS 提供商支持 OneRoster CSV 文件导出。
- PowerSchool用户报告称，他们通过使用社区库PowerSource Exchange - OneRoster 1.1 PowerQueries成功导出 OneRoster 文件。
- 您的数据团队可以使用自定义导出功能，从 SIS 手动创建 OneRoster 文件。
请向您的SIS供应商咨询如何导出OneRoster CSV文件。
最受欢迎的选项
| 聪明的 | 类链接 |
|
|
OneRoster 启用准备工作
在“管理用户”中
启用 OneRoster 后， Atlas中的现有用户将自动同步。因此，为减少创建重复用户的几率，请务必确保Atlas中每个用户的主要电子邮件地址与users.csv 文件（您的 SIS 数据库）中提供的电子邮件地址一致。 点击此处了解更多关于在Atlas中管理用户的信息。
部分 OneRoster 导出文件仅包含在users.csv文件中授课的教职工。为确保Atlas中的辅助和行政人员信息更新，请在Atlas首次同步之前将他们添加到users.csv文件中，或手动将他们添加到Atlas 。
在管理课程中
将 SIS 中的名册数据成功转换为Atlas中的课程图最重要的工作是仔细审查courses.csv中的记录。
课程名称
courses.csv 文件中的每个唯一课程名称都将成为Atlas中的课程地图。对于将 OneRoster 同步功能添加到现有Atlas站点的学校，请仔细核对courses.csv中的课程名称与Atlas中的课程名称。在首次同步之前，两者应完全一致。可以在Atlas或学生信息系统 (SIS) 中进行更改，具体取决于哪种方式更合适。
可以将学生信息系统 (SIS) 中的多门课程与Atlas中的一门课程关联起来。在引入 OneRoster 同步功能时，请与Atlas支持团队协调处理此特殊情况。
Courses.csv文件中应指定每门课程的成绩和科目。部分学生信息系统 (SIS) 导出过程中不会包含成绩和/或科目信息。理想情况下，这些信息应在 OneRoster 导出之前在 SIS 中填写完毕。如果无法更新 SIS 或courses.csv文件，您可以在 OneRoster 导出后，手动在Atlas中为课程名称添加科目和成绩。此操作只需在首次同步后执行一次。 点击此处了解更多关于在Atlas中管理课程名称的信息。
从 OneRoster 导出文件中排除不会在Atlas中使用的“课程”。例如：
- 自习室
- 午餐
- 独立学习
- 浴室值班
在Atlas中管理 OneRoster 同步
请将 SFTP 上传安排在用户“非高峰时段”。请勿每天多次发送 OneRoster ZIP 文件。
大多数学生信息系统 (SIS) 在学年之间都有一个数据滚动更新日期，届时活跃的教师、学生和课程信息将被移至下一学年。务必将此 SIS 数据滚动更新日期与Atlas归档日期协调起来，后者也是每年一次。 点击此处了解更多关于Atlas归档的信息。
Atlas团队强烈建议采取以下两个步骤：
- 将Atlas归档与您的 SIS 更新日期协调起来。
- 在Atlas归档和 SIS 滚动之前暂停 OneRoster 与Atlas的同步，然后在两者成功完成后启用它。
请注意， Atlas需要三个组成部分才能使课程显示在“所有课程 > 所有课程”中：
- 课程标题（来自 courses.csv）。
- 至少有一个与课程名称关联的类（来自 classes.csv）。
- 用户被注册为该课程的教师（来自 enrollments.csv）。
设置 OneRoster 偏好设置
在管理控制面板 > OneRoster 首选项中
- （必填）第三部分是选择进行更改的管理员。
- 通过 OneRoster 同步所做的更改将归因于此系统管理员。
- 启用或禁用系统间的同步及其同步时间
- 选择要同步的内容：
- 仅限用户
- 用户 + 课程作业
- 选择 OneRoster 分配的用户权限：
- 教师编辑单元和课程（将被指派为课程开发人员）。
- 教师仅编辑课程（将被分配为教师）。
- 如果您的学校未使用Atlas Lessons，您将看不到此选项。
- 如果您的学校只对教师采用课程开发人员用户类型，您将看不到此选项。
- 点击“保存”以记录更改。
此外，此页面还允许手动上传users.csv 、 courses.csv或整个 OneRoster CSV 文件 ZIP 包。这有助于检查您的 CSV 文件将在Atlas中产生多少更改。
Atlas中的 OneRoster 图标
在“管理”>“管理用户”中
从 OneRoster 同步的用户旁边会显示一个1 R图标。将鼠标悬停在该图标上，即可查看该用户在 OneRoster 中的SourcedID 。
在“管理”>“管理课程”中
从 OneRoster 同步的课程旁边会显示一个1 R图标。将鼠标悬停在该图标上，即可查看该课程在 OneRoster 中的SourcedID 。
在“管理”>“管理课程”>“课程名称”中
从 OneRoster 同步的课程名称旁边会显示一个1 R图标。将鼠标悬停在该图标上，即可查看课程名称在 OneRoster 中的SourcedID 。
启用 OneRoster 后删除用户和课程
如果从 OneRoster CSV 文件中移除用户，且该用户之前已在Atlas中同步， Atlas将从当前年份停用该用户。该用户仍将被分配到往年的已存档地图。
如果从 OneRoster CSV 文件中移除课程，且该课程之前已同步到Atlas ， Atlas不会从本学年中删除该课程。但是，分配给该课程的教师和课程开发人员的信息将被移除。
常见问题解答
我们能否在Atlas中手动添加教师并保持同步？
当您手动将用户添加到Atlas时，如果Atlas中用户的主要电子邮件地址与 SIS 中的电子邮件地址匹配，则在下次 OneRoster 上传时将建立同步。
在同步之前，我是否需要将学生信息系统 (SIS) 中的新科目和成绩添加到Atlas中？
我们将协助您完成初始原型设置，确保Atlas的科目和成绩与您的 course.csv 文件匹配。但是，如果之后您的学生信息系统 (SIS) 中添加了新的科目或成绩，您需要在下次上传之前手动将其添加到Atlas中。
如果我们在SIS中重命名一门课程，它会在Atlas中更新，还是会创建一个新课程？
Atlas会从 OneRoster 获取课程的 SourceID，因此在 SIS 中重命名课程不会影响 SourceID。所以， Atlas中的课程名称也会在下次上传时更新。
如果我从SIS中删除一个用户，该用户会从Atlas中消失吗？
是的。但是，分配给该用户的课程将保持不变。
如果我从SIS系统中删除一门课程，它会从Atlas中消失吗？
不。但是， Atlas中该课程旁边的1 R图标将会消失。管理员需要在Atlas中手动删除该课程。
Atlas系统准备好归档时，我会收到电子邮件通知吗？
Atlas存档不会通过电子邮件提醒。但是，在存档日期前 30 天，所有用户登录网站时都会收到弹出通知。
在设置Atlas Archive 和 SIS 之间的同步计划时，最佳实践是什么？
Atlas团队强烈建议采取以下两个步骤：
- 将Atlas归档与您的 SIS 更新日期协调起来。
- 在Atlas归档和 SIS 滚动之前暂停 OneRoster 与Atlas的同步，然后在两者成功完成后启用它。
OneRoster 版本是什么？
我们遵守 OneRoster v 1.1 的规定。
我们需要从他们那里获取文件或API吗？
我们从符合规范的 CSV 文件导入数据，而不是通过 API 导入。请查看本手册页中的“SFTP 上传要求”部分。
SFTP 的布局是什么？
我们有SFTP服务器，文件准备就绪后，我们会提供凭据供您上传文件。
SFTP上传的手动步骤
Atlas要求将这些CSV文件分别打包到一个ZIP文件中。请在发送这些文件之前阅读下方的“激活OneRoster的准备工作”部分。
- 组织
- 用户
- 课程
- 课程
- 入学人数
以下是Atlas处理 OneRoster 文件时使用的必填列和可选列。
orgs.csv Required: sourcedId, name users.csv (*remove all student information) Required: sourcedId, givenName, familyName, email, role Optional: orgSourceIds, username, userIds courses.csv Required: sourcedId, title, courseCode, orgSourcedId Highly Recommended: grades, subjects Optional: subjectCodes classes.csv Required: sourcedId, courseSourcedId, schoolSourcedId, title Optional: grades, subjects enrollments.csv Required: sourcedId, classSourcedId, schoolSourcedId, userSourcedId, roleAtlas不需要任何学生信息。学生信息应从用户和注册 CSV 文件中移除。如果将学生信息发送到Atlas ，系统将忽略这些信息。