SDS (经典) V2.1 CSV 文件格式
通过引入方法提供的核心 SDS 功能和 Microsoft 365 功能
可以使用 CSV (逗号分隔值) SDS V2.1 格式的文件,将学校信息系统 (SIS) 与Office 365同步。 使用 SDS V2.1 CSV 文件格式引入数据类别,可以照亮用于预配的核心 SDS 功能。 它还有助于增强列出的 Microsoft 365 产品和功能的体验。
注意
CSV V2 格式的当前客户可能会在 2022 年 5 月之前继续使用。 建议使用 CSV V2.1 格式及其附加功能。
SDS V2.1 文件的格式必须正确。 上传所有 5 个文件,完全按详细名称命名。 文件和列标题区分大小写。 CSV 文件必须采用 UTF-8 格式。 若要查看和下载 SDS V2.1 CSV 文件的示例集,请参阅 SDS GitHub 存储库。
每个 CSV 文件必须包含以绿色 突出显示 的所有必填字段。 未突出显示的字段是可选的。 虽然某些属性的内容可能是可选的,但需要列标题。 具有在“类型”列中标记的已定义枚举值的属性具有一组它们支持的特定值。 下一部分将介绍每个属性支持的枚举值集。
*仅筛选“学校”
如果创建用户:
用户名字段需要域才能被 SDS 接受。 例如,cbean@domain.com。
在 relationships.csv 中具有监护人角色的用户需要 FamilyName、givenName 和电子邮件。 建议列出两个用户记录,以及与其专用电子邮件地址关联的联系人用户记录,以及员工以及联系人的用户记录。
预期电话和短信位于 E.164 中。 如果 SDS 预配与 E.164 不一致,则手机或短信不会出错。 验证将去除 () -、空格、句点 (.) ,并保留 +(如果它位于提供的值的前面)。
*如果在记录上找到多个值,则仅将一个值与 SDS 预配同步。
支持的枚举值
在 SDS V2.1 格式中,有一些属性定义为枚举值,这意味着只能在 CSV 文件中提供一组选定的值。 除指定值以外的任何内容都将在同步处理过程中导致错误。 部分定义 SDS V2.1 格式支持的枚举值。
users.csv 包含“role”属性并支持枚举值。
用户组织角色 | ||
---|---|---|
学生 | TeacherAssistant | 校长 |
普罗克特 | 竖线 | SpecialServices |
老师 | 教授 | 指导 |
ItAdmin | 研究工具 | 助手 |
OfficeStaff | 讲师 | 椅子 |
护士 | 联盟 | 兼职 |
职业Therapist | 校友 | Substitute |
教练 | 指导教师 | paraprofessional |
PhysicalTherapist | 教师 | 管理员 |
SpeechTherapist | VisionTherapist | 其他 |
orgs.csv 包含“type”属性并支持枚举值。
组织类型 | ||
---|---|---|
学校 | MinistryOfEducation | LocalAuthority |
部门 | 大学 | 地区 |
区 | 大学 | 部门 |
本地 | 校园 | 省 |
状态 | 成人教育 | ResearchCenter |
国际 | 市 | 程序 |
DepartmentOfEducation | AcademicTrust |
demographics.csv 包含“出生状态”属性并支持枚举值。
状态 | ||
---|---|---|
Ak | 洛杉矶 | OR |
铝 | 马 | Pa |
Ar | Md | 公关 |
AS | 我 | PW |
Az | MH | 日 |
加利福尼亚州 | 米 | Sc |
CO | 锰 | Sd |
Ct | 莫 | Tn |
DC | Mp | Tx |
DE | 女士 | Ut |
佛罗里达州 | MT | Va |
调频 | 数控 | 六 |
GA | ND | Vt |
古 | NE | 华盛顿州 |
你好 | Nh | 无线 |
Ia | 新泽西州 | WV |
ID | 纳米 | 王寅 |
I l | 内华达州 | 机 管 局 |
IN | 纽约 | Ae |
Ks | 哦 | 美联社 |
肯塔基州 | 确定 |
academicSessions.csv 包含学术会议“type”属性并支持枚举值。
学术会议类型 | ||
---|---|---|
SchoolYear | 学期 | Term |
demographics.csv 包含“sex”属性并支持枚举值。
性 | ||
---|---|---|
男 | 女 | NotSelected |
academicSessions.csv 包含“学年”属性并支持枚举值。
学年 | ||
---|---|---|
2021 | 2025 | 2029 |
2022 | 2026 | 2030 |
2023 | 2027 | 2031 |
2024 | 2028 |
relationships.csv 包含“关系角色”属性并支持枚举值。
关系角色 | ||
---|---|---|
Parent | 监护人 | 助手 |
Relative | 子 | 管理员 |
医生 | 其他 |
enrollments.csv 包含“role”属性并支持枚举值。
注册角色 | ||
---|---|---|
学生 | VisionTherapist | Substitute |
助手 | paraprofessional | 校长 |
普罗克特 | TeacherAssistant | SpecialServices |
老师 | 教授 | 指导教师 |
管理员 | 讲师 | 指导 |
职业Therapist | 联盟 | 助理 |
PhysicalTherapist | 兼职 | 竖线 |
SpeechTherapist | 教练 |
Courses.csv 包含学术会议“subject”属性并支持枚举值。
课程主题 | 说明 |
---|---|
01 | 英语语言和文学 |
02 | 数学 |
03 | 生命和物理科学 |
04 | 社会科学和历史 |
05 | 视觉和表演艺术 |
07 | 宗教教育和神学 |
08 | 物理、健康和安全教育 |
09 | 军事科学 |
10 | 信息技术 |
11 | 通信和音频/视觉技术 |
12 | 业务和市场营销 |
13 | 制造 |
14 | 医疗保健科学 |
15 | 公共、保护和政府服务 |
16 | 酒店和旅游 |
17 | 体系结构和构造 |
18 | 农业、食品和自然资源 |
19 | Human Services |
20 | 运输、配送和物流 |
21 | 工程和技术 |
22 | 其他 |
23 | 非特定主题 |
24 | 世界语言 |
userFlags.csv 包含“flag”属性并支持枚举值。
用户标志 | 说明 |
---|---|
FreeLunch | 免费午餐 |
ReducedLunch | 减少午餐 |
无家可归 | 无家可归 |
GiftedOrTalented | 才华横溢或才华横溢 |
504 | 第 504 节 放置 |
ELL | 英语语言学习者 |
LEP | 英语熟练程度有限 |
IEP | 特殊教育服务/独立教育计划合格 |
demographics.csv 包含“ethnicity”属性并支持枚举值。
种族 | 说明 |
---|---|
西班牙裔OrLatinoEthnicity | 西班牙裔或拉丁裔 |
demographics.csv 包含“race”属性并支持枚举值。
比赛 | 说明 |
---|---|
AmericanIndianOrAlaskaNative | 美国印第安人或阿拉斯加原住民 |
NativeHawaiianOrOtherPacificIslander | 夏威夷本地人或其他太平洋岛人 |
BlackOrAfricanAmerican | 黑人或非裔美国人 |
DemographicRaceTwoOrMoreRaces | 指定多个种族 |
亚洲 | 亚洲 |
白色 | 白色 |
roles.csv 包含“grade”属性并支持枚举值。
Courses.csv 包含学术会话“grade”属性并支持枚举值。
年级 | 说明 |
---|---|
IT | 婴儿/幼儿 |
公关 | 学龄 前 |
Pk | Prekindergarten |
TK | 过渡幼儿园 |
公斤 | 幼儿园 |
01 | 一年级 |
02 | 二年级 |
03 | 三年级 |
04 | 四年级 |
05 | 五年级 |
06 | 六年级 |
07 | 七年级 |
08 | 八年级 |
09 | 九年级 |
10 | 十年级 |
11 | 十一年级 |
12 | 十二年级 |
13 | 13 年级 |
14 | 14 年级 |
Ps | 后 |
Ug | 未分级 |
其他 | 其他 |
PS1 | 大一新生 |
PS2 | 大二学生后 |
P s 3 | 大专 |
PS4 | 高级后 |
本科 | 本科 |
毕业 | 毕业 |
研究生 | 注重研究的毕业生 |
校友 | 校友 |
成人教育 | 成人教育 |