单校导入文件准备要求

在开始之前使用文艺复兴单学校文件导入,我们强烈建议您检查文件,以确保数据格式正确,并且在导入过程中没有可能导致问题的错误。本主题概述了要成为有效的Single-School导入文件,文件需要具备的特性。注意:只能导入.csv类型的文件。

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

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

导入文件中可以包含28种类型的数据。这28种类型的数据分为三类:学生数据、人事数据和班级数据。并不是所有类型的数据都需要出现在导入的记录中,但是对于每个类别,都需要某些信息;这些信息都在大胆的在下面的列表中。(有关人事、课程及课程资料,请注意,只有在记录中包含此类资料时,才需要加粗的资料。)

学生数据 人员数据 班级及课程资料
学生证
学籍ID
学生名
学生中间名
学生姓
学生成绩
学生性别
学生的生日
学生种族
学生的语言
学生的特点
学生用户名
学生密码
老师ID
教师状态ID
老师的名字
教师中间名
老师姓
老师的邮件
教师的性别
老师的位置
用户名
老师的密码
课程ID(请参阅下面提示中的注释)
课程名称
类别ID(参见下面提示中的注释)
类名或节号
类主题

指出关于COURSEID而且CLASSID

COURSEIDS在您的文件被导入,但会出现在Renaissance的课程信息中。courseid在导入过程中用于“幕后”匹配目的(也可用于与我们的成长联盟合作伙伴共享数据)。要在Renaissance的课程信息中显示课程id,您必须手动输入课程代码。

CLASSIDS在您的文件也导入,但会在文艺复兴时期随处可见与courseid一样,classid在导入过程中用于“幕后”匹配目的(也可以用于与我们的增长联盟合作伙伴共享数据)。重复使用以前学年的班级编号。

COURSEID和CLASSID通常应该留空。

分隔符

Excel文件中的数据被安排在网格中,每行有一条记录,每行分为几列。每个单元格都有一个单独的信息片段,所有这些片段一起组成一个记录。(导入只接受.csv,所以在导入之前要小心将文件保存为.csv。)

在逗号分隔值(.csv)文件中,数据有行,但没有列。为了将一行中的信息片段彼此分开,您需要一个分隔符每一段后,加一个制表符或逗号。分隔符的存在意味着“这是这段数据的结束;接下来是另一篇文章。”多个分隔符等价于空单元格;例如,如果您使用逗号作为分隔符,亚当斯…11/3/01就相当于有一个Excel文件,在姓氏和日期之间有两个空单元格。无论在文件中使用哪种分隔符,建议使用相同的分隔符整个文件。

数据文件中的第一行应该是标题行。该行中没有任何学生、人员或班级数据;相反,它有代码识别每列中的数据。

用于头文件中识别数据文件中的信息的代码:

学生资料守则 人事资料守则 类和课程数据代码
  • 学号:SID
  • 学籍:SSTATEID
  • 学生名:SFIRST
  • 学生中间名:SMIDDLE
  • 学生姓:SLAST
  • 学生成绩:SGRADE
  • 学生性别:SGENDER
  • 学生出生年月日:SBIRTHDAY
  • 学生种族:SRACE
  • 学生的语言:使用俚语
  • 学生特点:SCHARACTERISTICS
  • 用户名:SUSERNAME
  • 学生密码:SPASSWORD
  • 人员ID:TID
  • 人员状态ID:TSTATEID
  • 姓名:TFIRST
  • 人员中间名:TMIDDLE
  • 姓名:TLAST
  • 人员的电子邮件:TEMAIL
  • 人员的性别:TGENDER
  • 人员职位:TPOSITION
  • 用户名:TUSERNAME
  • 个人密码:TPASSWORD
  • 进程ID:COURSEID(见上文附注)
  • 课程名称:课程
  • 类ID:CLASSID(见上文附注)
  • 类名或节号:
  • 类问题:主题

如果您使用的是Excel,则每个标题项都应位于相应列顶部的自己的单元格中。(导入只接受.csv,所以在导入之前要小心将文件保存为.csv。)在.csv文件中,在头项之间添加所使用的分隔符。

如果要导入的记录没有特定类型的数据,则不需要为该类型的数据包含标题项/列。例如,如果您的记录只包含学生的姓、名、用户名和年级,则标头将只包括SFIRST、SLAST、SUSERNAME和SGRADE。

数据规范

这28种数据类型中的每一种都有自己的格式规则、允许的最大字符数、使用的缩写等等。选择下面的一个类别以查看该数据的需求。注意:为了避免重复的学生记录,一个好主意是让学生记录包括生日或身份证。

学生资料规格

代码(数据) Max。长度 格式 如有学生资料,必须填报? 笔记
SID (ID) 20. 字符或数字 不,但是推荐 如果文件中没有,则使用用户名。
SSTATEID(学生状态ID) 50 字符或数字 没有,但强烈推荐 如果您与您的州共享数据,可能需要。
SFIRST(名字) 35 字符 是的 没有一个
SMIDDLE(中间名) 35 字符 没有 没有一个
姓(姓) 35 字符 是的 没有一个
SGRADE(年级) 5 字符或数字 否(见附注) 导入时不要求分数,但Star测试和添加/编辑学生信息时需要分数。分数还可以帮助您充分利用Schoolzilla Starter报告功能。接受等级代码:
  • 情(预备)
  • K(幼儿园)
  • 1(一年级)
  • 2(二年级)
  • 3(三年级)
  • 4(四年级)
  • 5(五年级)
  • 6(六年级)
  • 7(七年级)
  • 8(八年级)
  • 9(九年级)
  • 10(10年级)
  • 11(11年级)
  • 12(12年级)
  • 12+(大于12)
  • 其他(其他)
SGENDER(性别) 1 字符 否(见附注) 添加性别可以帮助您充分利用Schoolzilla Starter的报告功能。
接受的性别代码:
  • (男)
  • F(女)
  • U(未分配-如果没有指定代码则默认)
SBIRTHDAY(出生日期) 10 mm / dd / yyyy 没有 没有一个
SRACE(种族) 1 字符 否(见附注) 添加种族可以帮助您充分利用Schoolzilla Starter的报告功能。
接受种族代码:
  • 我(美国印第安人或阿拉斯加原住民)
  • (亚洲)
  • B(黑)
  • H(西班牙)
  • (混合)
  • P(夏威夷或太平洋岛民)
  • C(白色)
如果没有输入代码,则为种族选择“None Specified”。
使用俚语(语言) 3. 字符 没有 接受语言代码:
  • ARA(阿拉伯语)
  • CAN(中文:广东话)
  • 国防部(中文:普通话)
  • CHI(中文:未指明)
  • ENG(英语)
  • FRE(法国)
  • 蒙古包(德国)
  • GUJ(古吉拉特语)
  • CRP(海地克里奥尔语)
  • 邮政编码(苗族)
  • 日本(日本)
  • 凸轮(红色)
  • 侯尔(韩国)
  • 老挝(老挝)
  • 可能(Maylay)
  • 导航(纳瓦霍语)
  • 另外一些(其他)
  • 波尔(波兰)
  • (葡萄牙)
  • 俄文(俄罗斯)
  • 鳞状细胞癌(塞尔维亚-克罗地亚语)
  • SOM(索马里)
  • 温泉(西班牙语)
  • TAG(他加禄语或菲律宾语)
  • 黑绿豆(乌尔都语)
  • VIE(越南)
  • 空白(无指定)
SCHARACTERISTICS(特点) 755 破折号(-)分隔的字符串 否(见附注) 添加下面列表中带星号(*)的特征使您能够充分利用Schoolzilla Starter的报告功能。
接受的特征代码:
  • ADA(美国残疾人)*
  • 高危学生(AR)
  • BIL(双语教育)
  • DL(诵读困难的)*
  • 英语作为第二语言
  • 免费午餐*
  • GT(天赋/有才华)
  • LD(学习障碍)*
  • 英语水平有限*
  • 毫克(移民)*
  • NA(非居外地人士)
  • PD(身体残疾)*
  • RL(低价午餐计划)*
  • 特殊教育*
  • T1(标题1)
SUSERNAME(用户名) 50 字符或数字 不,但是推荐 如果不在文件中,则使用学生名字的首字母和姓氏的前四个字母自动生成用户名(例如,jsmit代表Jane Smith)。如果该用户名已经被使用,则会添加一个数字(例如jsmit2)。学生的用户名不能与密码完全相同,且每个用户的用户名不能相同。
SPASSWORD(密码) 20. 区分大小写的字符或数字 不,但是推荐 如果不在文件中,所有学生将被给予相同的默认密码:abc。要求:最少2个字符,包含大写字母、小写字母、数字和/或特殊字符(!#$%-_=+<>*)。学生的密码不能与用户名完全相同。

人员资料规范

代码(数据) Max。长度 格式 是否需要提供个人资料? 笔记
TID (ID) 20. 字符或数字 没有 如果不在文件中,则使用该用户的用户名作为ID。
TSTATE(人员状态ID) 50 字符或数字 没有,但强烈推荐 如果您与您的州共享数据,可能需要。
TFIRST(名字) 35 字符 是的 要求只有如果包括个人信息。
TMIDDLE(中间名) 35 字符 没有 没有一个
TLAST(姓氏) 35 字符 是的 要求只有如果包括个人信息。
TEMAIL(电邮地址) 255 字符或数字 是的 要求只有如果包括个人信息。电子邮件地址在您的网站上必须是唯一的-每个电子邮件地址只能与一个用户相关联。
TGENDER(性别) 1 字符 没有 接受的性别代码:
  • (男)
  • F(女)
  • U(未分配-如果没有指定代码则默认)
TPOSITION(位置) 1 字符 没有 接受职位代码:
  • T(老师)
  • P(校级管理员,如校长)
  • 秘书(学校职员)
TUSERNAME(用户名) 50 字符或数字 没有 如果不在文件中,则自动生成一个使用首字母和完整姓氏的用户名(例如,rjones表示Robert Jones)。如果该用户名已经被使用,则添加一个数字(例如rjones2)。人员用户名不能与密码完全相同,且每个用户的用户名不能相同。
TPASSWORD(密码) 20. 区分大小写的字符或数字 没有 默认情况下,员工密码至少需要一个数字。如果文件中没有密码,员工首次登录Renaissance软件时将使用自己的用户名作为密码。

类别数据规格

代码(数据) Max。长度 格式 如果有班级资料需要? 笔记
课程ID(课程ID) 265 字符或数字 没有 必须是唯一的所有学校在网站上。请参阅上面关于课程和班级编号的提示框。课程ID为空。
课程(课程名称) One hundred. 字符或数字 是的 要求只有如果包括课程信息。
CLASSID (Class ID) 265 字符或数字 没有 必须是唯一的所有学校在网站上。请参阅上面关于课程和班级编号的提示框。将类ID保留为空。不要重复使用以前学年的学号。
CLASS(类名或节号) 50 字符或数字 是的 要求只有如果包括课程信息。

注意:如果一个学生在多个班级,则为该学生输入多个行,在每一行中使用相同的学生信息但不同的班级名称。该学生将同时参加两门课程。
主题(主题) 11 字符 没有 课程接受科目编号:
  • 艺术(艺术)
  • ENG(英语)
  • 卫生(健康)
  • 文书主任/语言艺术(语文艺术)
  • 数学(数学)
  • 其他(其他)
  • 读数(阅读)
  • 科学(自然科学)
  • 高级教育主任(特殊教育)
  • SOC(社会研究)
  • 或者说是(写作)

额外准备说明

你的文件

  • 文件中的每一行数据都必须是一条记录。
  • 一组记录只能有一个标题行,并且标题行中的每个项必须是唯一的。如果您不小心包含了多个标题行,则将选择文件中的第一个作为标题行。如果不是正确的行,可以在导入过程中选择正确的行。
  • 如果文件有不能导入的数据列,因为它不是来自允许的28种类型之一,您可以从文件中删除该数据,或者为该数据使用一个“假”头项(例如XYZDoNotImport)并指示程序在导入过程中忽略该列。
  • 可以将不同类型的数据(学生、人员或班级)组合成一个记录。你不能对相同类型的数据这样做;例如,一个记录中可以有一个学生和一个班级,但不能有一个学生和另一个学生。(请注意,将班级数据添加到学生和/或人事数据将影响您在导入过程中可以选择的选项。)
  • 包含学生数据和班级数据的记录示例(头和一条记录):

    SLAST、SFIRST类
    罗伯茨、盖、英语、创意写作

    这可以理解为蒂莫西·罗伯茨的学生记录,他参加了英语课程的创意写作课程。

    包含人员和类数据(头和一条记录)的记录示例:

    TLAST、TFIRST TEMAIL,当然,类
    安德鲁斯,莎莉,sandrews@noemail.com,英语,创意写作

    这将被理解为莎莉·安德鲁斯的人事记录,她被分配为英语课程创意写作课的老师。

    学生数据、人事数据和班级数据(头和一条记录)的记录示例:

    SLAST、SFIRST TLAST、TFIRST TEMAIL,当然,类
    罗伯茨,蒂莫西,安德鲁斯,莎莉,sandrews@noemail.com,英语,创意写作

    这将被理解为蒂莫西·罗伯茨的学生记录,他注册了创意写作,这是一门英语课程,萨莉·安德鲁斯是指定的班主任。这是最好的文件类型,因为它允许您一次性导入学生和人员,将学生注册到类中,并将人员分配到类中。

    学生数据和人事数据的记录示例(标头和一条记录)

    SLAST、SFIRST TLAST、TFIRST TEMAIL
    罗伯茨,蒂莫西·安德鲁斯,莎莉,sandrews@noemail.com

    这将会输入蒂莫西·罗伯茨的学生记录和莎莉·安德鲁斯的人事记录。结果将与导入两个单独的记录相同,一个用于学生,一个用于人事成员,因为没有与任何一个记录相关联的类数据以任何方式连接这两个记录。

  • 每一行中必须有相同数量的项,且顺序与标题行相同。如果某条记录的某些信息不可用,请使用占位符(空表单元格、逗号或制表符,具体取决于您的文件)使每行中的项数相同。该软件确定是否应该导入一行数据的方法之一是计算每行中的项数,并查看大多数行有多少项。这被认为是项目的“标准”数量,在导入过程中,任何包含更多或更少项目的记录都将被忽略。

在文艺复兴时期

  • 导入过程中的第一步是选择要导入数据的学校和学年。

哪个学年?您可以导入到当前学年或未来学年。如果您选择未来学年,请注意导入文件中学生的成绩与他们在未来学年的成绩相匹配。

文件准备示例

.csv文件(在明文编辑器中),逗号分隔值

下面的示例文件需要进行一些更正。在本例中,每一行有两种类型的数据:一个学生和一个人事记录。由于没有包含班级数据,在此导入过程中,在Renaissance中将为每一行创建两个独立的、不相关的记录:一个学生记录和一个人事记录。

奈特,贝瑟尼,林恩,F, 2011年1月10日,NNM15K,亨德里克斯,雪莱,安妮,TZP27N
鲈鱼,总理,赫伯特,M, 08/13/2011 HOT80F,诺兰。朱莉,约翰娜,JCZ10O
夏普,艾瑞莎,克里斯蒂娜,01/31/2010 GWJ54C, F,正义,怀亚特,凯文,MEU82T
约翰,冬青,奥利维亚,F, 04/26/2012 MIR71A, Talley,杰森,亨伯特,LJS85M
器皿,凯莉,伊拉斯谟,M, 03/09/2012 ZKT47K,威利,Kylan,艾伦,
奥斯本,伊拉Dierdre F、06/10/2012 ZQV90O,沃伦,汉娜,亨廷顿,BLX83T

文件存在以下问题:

  • 文件没有标题行。
  • 在第一行(贝瑟尼·奈特),学生的出生日期格式不正确。
  • 在第二行(Chancellor Bass)中,用句号代替逗号分隔诺兰朱莉.这将防止程序将名称视为独立的,并且当每一行中的项目被计数以确定“标准”数量时,这两个名称将被计数为一个,抛出一行的项目计数(9而不是10)。
  • 在第三行(Aretha Sharp)中,性别位于不同的位置——在ID之后,而不是像其他行中那样在出生日期之前。
  • 在最后一行(Ila Osborn)中,第一个ID (ZQV90O)后面有一个额外的逗号。程序将把它计算为一个“空单元格”,这将使它在这一行中计算一个额外的字段(11个字段而不是10个)。由于程序将在大多数行中找到10个字段,因此它将忽略10个字段之后的任何字段。
  • 教师的电子邮件丢失-当导入教师时,需要他们的电子邮件地址。

注意行尾的额外分隔符。在上面的第五个记录(Kylie Ware)中,注意该行的末尾有一个逗号。在本例中,逗号是正确的,因为记录的最后一个ID(教师ID)没有值,因此逗号将被解释为“空单元格”,并在计算行中的项目时被包括在内。如果记录一个ID,并且逗号是意外包含的,这将意味着这一行有一个太多的字段。

以下是更正后的文件:

SLAST、SFIRST SMIDDLE、SGENDER SBIRTHDAY, SID, TLAST, TFIRST, TMiddle, TID TEMAIL
骑士,伯大尼,林恩,F, 01/10/2011 NNM15K,亨德里克斯,雪莱,安妮,TZP27N, ahend@noemail.com
鲈鱼,总理,赫伯特,M, 08/13/2011 HOT80F,诺兰,朱莉,约翰娜,JCZ10O, jnola@noemail.com
夏普,艾瑞莎,克里斯蒂娜,F, 01/31/2010 GWJ54C,正义,怀亚特,凯文,MEU82T, kjust@noemail.com
约翰,冬青,奥利维亚,F, 04/26/2012 MIR71A, Talley,杰森,亨伯特,LJS85M, htall@noemail.com
器皿,凯莉,伊拉斯谟,M, 03/09/2012 ZKT47K,威利,Kylan,艾伦,awile@noemail.com
奥斯本,伊拉Dierdre F、06/10/2012 ZQV90O,沃伦,汉娜,亨廷顿,BLX83T, hwarr@noemail.com

.csv文件在Microsoft®Excel®

下面的Excel示例文件也需要一些更正。在本例中,每行有三种类型的数据(学生、人员和课程/班级)。这意味着在导入过程中,将从每行创建三个单独的记录——学生记录、人事记录和课程/班级记录。此外,学生将被录取到班级,并将分配人员到班级。(导入只接受.csv,所以在导入之前要小心将文件保存为.csv。)

SFIRST SLAST SBIRTHDAY SGRADE SGENDER TFIRST TLAST TGENDER 课程
凯拉 Barrera) 03/04/2011 1日 F 约翰 坎图 阅读 青年读者I
柯尔特M。 波拉德 12/14/2010 2 英惠 斯蒂尔 F 数学 加起来!
伊冯 西姆斯 04/13/20011 1 朵拉 谢泼德 F 阅读 故事分享
Kiayada 本森 09/07/2011 1 F 约翰尼 坎图 阅读 青年读者I
马丁 曼恩 10/13/2012 K 朵拉 谢泼德 F 阅读 “故事时间”
紫树属 霍华德 05/09/2010 2 F 阿尔文·比斯利 数学 生产力
乍得 埃斯蒂斯 10/22/2010 2 布兰特 麦凯 数学
分而治之!

文件存在以下问题:

  • 凯拉·巴雷拉的记录应该和其他记录一样是数字等级(1),而不是“第一”。
  • 在第三行(Colt)中,中间的首字母已包含在名字中;它应该被删除,使这张唱片像其他唱片一样。
  • 在第四行(Yvonne),学生的生日(SBIRTHDAY)在年份中多了一个“0”。
  • 如果Kiayada记录中的“Johnny Cantu”老师与Kyra记录中的“John Cantu”老师相同,那么两个记录中都应该使用“John”或“Johnny”。
  • 在第六行(Martin)中,类名周围有引号。所有单元格中的字符将包含在导入中,因此请确保没有无意的标点符号或空格。
  • 在第七行(Nyssa)中,教师的姓和名在合并的单元格中,而不是单独的单元格中。
  • 在最后一行(Chad)中,类名前面有一个返回。这五月在导入过程中产生问题。
  • 教师的电子邮件丢失-当导入教师时,需要他们的电子邮件地址。

以下是更正后的文件:

SFIRST SLAST SBIRTHDAY SGRADE SGENDER TFIRST TLAST TGENDER TEMAIL 课程
凯拉 Barrera) 03/04/2011 1 F 约翰 坎图 jcantu@noemail.com 阅读 青年读者I
柯尔特 波拉德 12/14/2010 2 英惠 斯蒂尔 F hsteele@noemail.com 数学 加起来!
伊冯 西姆斯 04/13/2011 1 朵拉 谢泼德 F dshepard@noemail.com 阅读 故事分享
Kiayada 本森 09/07/2011 1 F 约翰 坎图 jcantu@noemail.com 阅读 青年读者I
马丁 曼恩 10/13/2012 K 朵拉 谢泼德 F dshepard@noemail.com 阅读 故事时间
紫树属 霍华德 05/09/2010 2 F 阿尔文 比斯利 abeasley@noemail.com 数学 生产力
乍得 埃斯蒂斯 10/22/2010 2 布兰特 麦凯 bmckay@noemail.com 数学 分而治之!
Baidu