OneRoster标准导入的要求

地区可以上传与OneRoster 1.1标准相对应的班级名册数据，方法是按照本帮助主题所述，准备.csv格式的文件。

本主题还包括步骤防止在导入后对花名册进行不必要的更改而且在您初次导入后的任何时间更新您的花名册．

我在哪里可以找到我的学生证?

重要要求和规格

文件名

• orgs.csv
• users.csv
• courses.csv
• classes.csv
• enrollments.csv
• academicSessions.csv
• demographics.csv
• manifest.csv

头和字段的内容

• 文件格式必须为OneRoster标准的逗号分隔值格式(CSV)。
• 每个字段将用逗号分隔，每行之间有换行符。
• 双引号必须用于包含逗号的字段。例如，如果你列出了多个学科领域，你可以这样写:“音乐，戏剧，诗歌”
• 所有8个文件都是必需的，即使是空文件。不包含数据的文件必须包含头字段。
• 标题行是必需的。
• 报头字段的名称必须与每个字段报头相同在下面的表格中．
• 所有文件名和头字段都区分大小写。
• 有些字段是必需的(详见下表)．
• 没有数据的可选字段必须在CSV中为空。

如何导入OneRoster模板

1. 在文艺复兴首页右上角选择您的姓名。在下拉列表中选择管理应用和用户．



2. 在“新学年奇才”下，选择上传你的花名册．



3. 在“导入注册数据”页面，选择OneRoster对于导入类型。



4. 要在Renaissance中创建任何现有名册数据的快照，并创建包含所需的学校名称和id(以及其他内容)的模板，首先，选择要从中导出数据的学年。请确保选择您也计划导入数据的学年成；不要使用上一学年的导出文件。



然后,选择生成花名册导出．处理完成后，您将看到一条红色的失败消息或一条绿色的完整消息。如果导出成功，您将看到完整的和下载链接将出现。



导出花名册会生成OneRoster 1.1文件。

5. 在步骤2中，选择下载[日期导出被创建]CSV文件．下载一个OneRosterExport.zip文件。保存.zip文件并解压缩文件，以便您可以编辑它们。



6. 打开刚刚从文艺复兴下载的所有模板。

如何更新microsoftexcel®中的文件?

如果您计划使用Excel更新文件，请注意遵循这些步骤，以避免引入格式问题，从而导致数据导入不正确。对更新的每个文件重复这些步骤。

1. 将文件的扩展名从.csv重命名为. txt．
2. 打开Excel。
3. 在Excel中，浏览您重命名的文件并打开它。导入文本向导将出现。
4. 在“选择文件类型…”中,选择分隔．然后检查我的数据有标题盒子。选择下一个．
5. 在Import向导的第2步中，检查逗号框作为分隔符，并删除任何其他选定的分隔符。选择下一个．
6. 在导入向导的第三步:
1. 在“数据预览”下，单击第一列的标题以选中它，然后按住转变关键的;向右滚动并单击文件中最后一列的标题以选择所有列。
2. 在列数据格式下，选择文本将所有列标题的格式从“常规”更改为“文本”。
3. 选择完成．
7. 您的文件将打开，您可以更新它。进行任何更改并保存文件。
8. 当您完成了这些工作并且准备导入文件时，将文件扩展名从.txt更改为. csv．
9. 继续下面的步骤。
7. 在您的外部名册工具(如OneRoster或其他一些SIS系统)中，创建导出文件并打开文件进行编辑。
8. OneRoster 1.1标准文件可以导入。

如果您正在使用上述步骤中导出的文件，则在从外部列名工具导出的文件中，复制与Renaissance列匹配的所有列。注意:如果文件中的列与Renaissance下载的文件不匹配，则导入将失败。

我需要哪些列，哪些字段是必需的?

这些表，每个文件一个，列出了必要的列标题，并指出文艺复兴需要有数据的字段(阴影行)，那些不需要有数据的字段(白色行)，以及帮助您在每个字段中输入正确信息的重要注释。特定于Renaissance的列标题是每个表末尾较暗的阴影行。

Orgs.csv

列标题	要求	笔记
sourcedId	是的	组织的唯一ID。SourcedId在其他文件中使用，并且必须在所有组织中惟一(例如，您所在地区的学校)。
状态	没有	请将此字段留空。
dateLastModified	没有	请将此字段留空。
的名字	是的	组织名称。
类型	是的	“学校”|“本地”|“州”|“国家”
标识符	没有	NCES ID(国家教育统计中心)为学校/地区。
metadata.classification	没有	“charter”|“private”|“public”
metadata.gender	没有	“女”|“男”|“混合”
metadata.boarding	没有	如果学校是寄宿学校，这是正确的。
parentSourcedId	没有	父组织的SourcedId。
metadata.stateId	没有	字符串

Users.csv

列标题	要求	笔记
sourcedId	是的	用户的唯一ID。SourcedId用于其他文件，并且在所有用户中必须是唯一的。
状态	没有	请将此字段留空。
dateLastModified	没有	请将此字段留空。
enabledUser	是的	布尔值:{"true" | "false"} “false”表示用户是活动记录，但是根据本地管理规则限制系统访问。
orgSourcedIds	是的	该用户所属组织的sourcedid。如果需要多个id，则使用双引号并以逗号分隔。请注意，在大多数情况下，预期用户将属于一个学校。
角色	是的	“老师”，“学生”，“家长”，“监护人”，“亲戚”，“助手”，“管理员”
用户名	是的	用户名 注意:如果不包含用户名，将生成一个用户名。对于人员，生成的用户名包括用户的首字母和完整的姓氏。对于学生，生成的用户名包括学生姓名的首字母和学生姓氏的前四个字符。如果生成的用户名已经被工作人员或学生使用，则会向用户名中添加一个数字。
用户id	没有	该用户的外部机器可读ID(例如LDAP ID, LTI ID)。ID必须带有格式为{type:ID}的类型。如果需要设置多个用户id，请使用双引号，并用逗号分隔。例子: LDAP: {Id} LDAP:“{Id}, {LTI: Id},{美联储:Id}”
givenName	是的	用户名。
familyName	是的	用户的姓。
标识符	没有	具有人类可读含义的用户标识符。
成绩	没有	具有“学生”角色的用户注册的年级。允许的词汇表来自CEDS (Version 5)的“入门年级水平”元素https://ceds.ed.gov/CEDSElementDetails.aspx?TermId=7100． 注意:由于学生在参加Star测试之前必须有一个年级水平设置，因此建议包括年级水平。这是设定学生成绩的领域。
密码	没有	用户的密码。这可能是加密的字符串，也可能不是。如果它是加密的，处理它的系统必须知道加密方法。 注意:如果没有提供密码，则会生成一个密码。对于人员，生成的密码与用户名相同。对于学生，生成的密码为美国广播公司．
电子邮件	没有	用户的电子邮件地址。
短信	没有	用户的短信地址。
电话	没有	用户的电话号码。
agentSourceIds	没有	与该用户有关系的用户的sourcedid。如果需要多个id，则使用双引号并以逗号分隔。 注意:在大多数情况下，这将用于表示父母关系。

Courses.csv

列标题	要求	笔记
sourcedId	是的	课程的唯一ID。SourcedId用于其他文件，并且在所有课程中必须是唯一的。
状态	没有	请将此字段留空。
dateLastModified	没有	请将此字段留空。
schoolYearSourceId	没有	开设课程的学年。这是一个学术会议的来源(见下文)。
标题	是的	课程名称。
courseCode	没有	人类可读的课程代码。
成绩	没有	所修课程的年级。如果一个类的文件中有多个等级，则只使用第一等级。允许使用的词汇表来自CEDS(第5版)的“入门年级水平”元素: https://ceds.ed.gov/CEDSElementDetails.aspx?TermId=7100
orgSourcedId	没有	本课程所属组织的SourcedId。这可能是一个地区级别的组织ID。
主题	没有	主题名称(s)。如果需要多个主题，请使用双引号，并以逗号分隔(根据RFC 4180): 例子: “化学、物理” 物理 “音乐、戏剧、诗歌”
subjectCodes	没有	机器可读形式的主题代码。如果存在"subjects"属性，则subjects和subjectCodes列表必须具有相同的长度并具有顺序意义。

Classes.csv

列标题	要求	笔记
sourcedId	是的	类的唯一ID。SourcedId用于其他文件，并且在所有类中必须是唯一的。
状态	没有	请将此字段留空。
dateLastModified	没有	请将此字段留空。
标题	是的	该类的名称。
成绩	没有	所修课程的年级。如果一个类的文件中有多个等级，则只使用第一等级。允许使用的词汇表来自CEDS(第5版)的“入门年级水平”元素: https://ceds.ed.gov/CEDSElementDetails.aspx?TermId=7100
courseSourcedId	是的	该类是其实例的课程的SourcedId。
classCode	没有	用于帮助识别该类的人类可读的代码。
classType	是的	“班主任”、“计划”
位置	没有	类物理位置的人类可读描述。
schoolSourcedId	是的	SourcedId的组织，教这门课。
termSourcedIds	是的	课程授课的学术环节的来源。如果需要多个术语，请使用双引号和逗号分隔(根据RFC 4180)。 例子: “1、2” 1 " 1、4、8”
主题	没有	主题名称(s)。如果需要多个主题，请使用双引号，并以逗号分隔(根据RFC 4180): 例子: “化学、物理” 物理 “音乐、戏剧、诗歌”
subjectCodes	没有	机器可读形式的主题代码。如果需要多个主题代码，请使用双引号，并以逗号分隔(根据RFC 4180)。如果存在"subjects"属性，则两个列表必须具有相同的长度和顺序意义。词汇来源于SCED (School Codes for Exchange of Data):http://ceds.ed.gov/ScedCourseCodes.aspx (标签中的任何逗号都应该被删除)。
期	没有	上课的时间安排。如果需要多个句点，请使用双引号，并以逗号分隔(根据RFC 4180)。 例子:1，"1,3,5"

Enrollments.csv

列标题	要求	笔记
sourcedId	是的	本次注册的ID。
classSourcedId	是的	该类的ID。
schoolSourcedId	是的	学校ID。
userSourcedId	是的	用户ID(教师或学生)。
角色	是的	“学生”“|”“老师”“|”“家长”“|”“监护人”“|”亲戚“|”助手“|”管理员
状态	没有	请将此字段留空。
dateLastModified	没有	请将此字段留空。
主要的	没有	一个班级只有一个老师必须设置为真。
beginDate	没有	入学的开始日期。该日期必须与课程中确定的相关学术会议(学期)一致。
endDate	没有	登记的结束日期(不包括)。该日期必须与该课程的相关学术会议(学期)相一致。

AcademicSessions.csv

列标题	要求	笔记
sourcedId	是的	本次学术会议的来源。在其他文件中使用的AcademicSessions需要在所有AcademicSessions中是唯一的。
状态	没有	请将此字段留空。
dateLastModified	没有	请将此字段留空。
标题	是的	评等阶段的名称或名称。
类型	是的	"term" | "gradingPeriod" | "schoolYear" | "semester"
startDate可以	是的	学术会议开始日期。使用YYYY-MM-DD格式。
endDate	是的	学术会议结束日期。使用YYYY-MM-DD格式。
schoolyear	是的	学年:学术会议对学校的贡献的学年这一年应该是学年结束的一年(格式为YYYY)。
parentSourcedId	没有	在学年栏中，此字段必须为空。 在所有其他学术会议的行中，该字段必须包含学年的sourcedID。
metadata.orgSourcedId	没有	学校来源知道这个特殊的学术会议是在。

Demographics.csv

列标题	要求	笔记
userSourcedId	是的	统计数据所引用的用户的SourcedId。通常这是一个学生。
状态	没有	离开这块地。
dateLastModified	没有	离开这块地。
生日	是的	学生出生日期
性	是的	“女”|“男”
americanIndianOrAlaska 本地的	是的	布尔“是”或“否”
亚洲	是的	布尔“是”或“否”
blackOrAfricanAmerican	是的	布尔“是”或“否”
nativeHawaiianOrOther PacificIslander	是的	布尔“是”或“否”
白色	是的	布尔“是”或“否”
demographicRaceTwo OrMoreRaces	是的	布尔“是”或“否”
hispanicOrLatinoEthnicity	是的	布尔“是”或“否”
countryOfBirthCode	是的	词汇- - - - - -https://ceds.ed.gov/CEDS ElementDetails.aspx吗?TermxTopicId = 20002
stateOfBirthAbbreviation	是/否*	词汇- - - - - -https://ceds.ed.gov/CEDS ElementDetails.aspx吗?TermxTopicId = 20837 *注意:对于美国和美国领土，这个字段应该被认为是强制性的。在美国以外的国家，这个字段是可选的。
cityOfBirth	是的
publicSchoolResidenceStatus	是的	词汇- - - - - -https://ceds.ed.gov/CEDS ElementDetails.aspx吗?TermxTopicId = 20863

Manifest.csv

清单文件将由标题为“propertyName”和“value”的两列组成。每一行将包含一个属性/值对。所支持的属性/值对列表如下所示。

属性名称(每行一个)	要求	格式	值描述
manifest.version	是的	字符串	清单的版本。对于初始值，它必须是“1.0”。
oneroster.version	是的	字符串	该文件集支持的OneRoster版本。这一定是“1.1”。
file.academicSessions	是的	枚举	枚举: bulk -该CSV文件只包含批量数据 (不支持Delta。)
file.categories	是的	枚举	枚举: absent -不提供该CSV文件
file.classes	是的	枚举	枚举: bulk -该CSV文件只包含批量数据 (不支持Delta。)
file.classResources	是的	枚举	枚举: absent -不提供该CSV文件
file.courses	是的	枚举	枚举: bulk -该CSV文件只包含批量数据 (不支持Delta。)
file.courseResources	是的	枚举	枚举: absent -不提供该CSV文件
file.demographics	是的	枚举	枚举: bulk -该CSV文件只包含批量数据 (不支持Delta。)
file.enrollments	是的	枚举	枚举: bulk -该CSV文件只包含批量数据 (不支持Delta。)
file.lineItems	是的	枚举	枚举: absent -不提供该CSV文件
file.orgs	是的	枚举	枚举: bulk -该CSV文件只包含批量数据 (不支持Delta。)
file.resources	是的	枚举	枚举: absent -不提供该CSV文件
file.results	是的	枚举	枚举: absent -不提供该CSV文件
file.users	是的	枚举	枚举: bulk -该CSV文件只包含批量数据 (不支持Delta。)
source.systemName	没有	字符串	产生该文件集的系统的名称。
source.systemCode	没有	字符串	生成该文件集的系统的识别代码。

9. 保存所有文件。如果您喜欢将文件合并为.zip文件，则将该文件命名为Roster.zip。
10. 在文艺复兴时期导入名册数据页面对于OneRoster导入类型，你可以上传你的文件:
• 如果您有一个包含.csv文件的罗斯特.zip文件，请将其拖放到第一个上传字段中。



上传文件后，您将在字段中看到它。您可以选择删除如果你决定不使用这个文件。



• 如果您有.csv文件，将这8个文件拖到第二个上传字段(多个.csv文件)。



上传文件后，您将在字段中看到每个文件。您可以选择删除链接以获取您想要删除和替换的任何文件。



属性，而不是将文件拖到字段中从计算机上传链接到适当的字段，以查找和打开您的文件。

11. 选择进口．
12. 查看页面顶部的“最近导入状态”，以查看导入的进度。选择查看导入日志打开包含导入过程信息的日志文件。(见导入历史页面以获取更多信息。)

我如何防止我的花名册发生不必要的变化?

集数据编辑限制以防止任何人在文艺复兴内部修改名册信息。

我如何更新我的花名册?

要对OneRoster数据进行任何更改、添加、删除或更正，请在外部注册工具中进行这些更改，然后从头开始重复这些步骤，再次导入更新后的文件。