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 檔案必須適當地格式化。 上傳所有五個檔案，其名稱完全如詳細。 檔案和數據行標頭會區分大小寫。 CSV 檔案必須是UTF-8格式。 若要檢閱和下載 SDS V2.1 CSV 檔案的範例集，請參閱 SDS GitHub 存放庫。
每個 CSV 檔案都必須包含以綠色 醒目提示 的所有必要欄位。 未反白顯示的欄位是選擇性的。 雖然某些屬性的內容可能是選擇性的，但數據行標頭是必要的。 在 [類型] 資料列中標示已定義列舉值的屬性有一組特定的值。 每個屬性支援的列舉值集位於下一節。
*僅篩選 'school'
如果建立使用者：
用戶名稱欄位需要網域才能被 SDS 接受。 例如，cbean@domain.com。
在 relationships.csv 中具有守護者角色的使用者需要FamilyName、givenName和電子郵件。 身為員工但也是聯繫人的使用者，建議他們列出兩筆用戶記錄，以及與其私人電子郵件地址相關聯的聯繫人用戶記錄。
預期電話和簡訊在 E.164 中。 如果電話或簡訊未與 E.164 對齊，SDS 布建就不會發生錯誤。 驗證會去除 () -、 spaces、 periods (.) ，並在所提供值的前端保留 + 。
*如果在記錄上找到多個值，則只會將一個值與 SDS 布建同步。
支援的列舉值
在 SDS V2.1 格式中，有定義為列舉值的屬性，這表示您只能在 CSV 檔案中提供一組選取的值。 除了指定的值之外，任何項目都會在同步處理期間導致錯誤。 區段會定義 SDS V2.1 格式中支援的列舉值。
users.csv 包含 「role」 屬性，並支援列舉值。
| 用戶組織角色 | ||
|---|---|---|
| 學生 | TeacherAssistant | 主要 |
| 普羅克特 | 員工 | SpecialServices |
| 老師 | 教授 | 指導 |
| ItAdmin | 研究工具 | 助理 |
| OfficeStaff | 講師 | 椅子 |
| 護士 | 聯盟 | 兼職 |
| 致使者 | 校友 | Substitute |
| 教練 | 導師 | Paraprofessional |
| PhysicalTherapist | 教師 | 系統管理員 |
| SpeechTherapist | VisionTherapist | 其他 |
orgs.csv 包含 「type」 屬性，並支援列舉值。
| 組織類型 | ||
|---|---|---|
| 學校 | HierarchyOfEducation | LocalAuthority |
| 部門 | 大學 | 區域 |
| 區 | 大學 | 劃分 |
| 本機 | 校園 | 省 |
| 狀態 | AdultEducation | ResearchCenter |
| 本國的 | 市 | 程式 |
| DepartmentOfEducation | AcademicTrust |
demographics.csv 包含「出生狀態」屬性，並支援列舉值。
| 狀態 | ||
|---|---|---|
| Ak | 洛杉磯 | OR |
| 鋁 | 馬 | Pa |
| Ar | Md | 公關 |
| AS | 我 | PW |
| Az | MH | 日 |
| CA | 米 | Sc |
| CO | 錳 | Sd |
| Ct | 莫 | Tn |
| 直流 | Mp | Tx |
| DE | 女士 | Ut |
| 佛羅里達州 | MT | Va |
| 調頻 | 數控 | 六 |
| Ga | ND | Vt |
| 古 | NE | WA |
| 你好 | Nh | 無線 |
| Ia | 新澤西州 | WV |
| 識別碼 | 納米 | 王寅 |
| I l | 內華達州 | 機 管 局 |
| IN | 紐約 | Ae |
| Ks | 哦 | 美聯社 |
| 肯塔基州 | 確定 |
academicSessions.csv 包含學術會話 「type」 屬性，並支援列舉值。
| 學術會話類型 | ||
|---|---|---|
| SchoolYear | 學期 | 術語 |
demographics.csv 包含 「性」屬性，並支援列舉值。
| 性 | ||
|---|---|---|
| 男性 | 女性 | NotSelected |
academicSessions.csv 包含「學年」屬性，並支援列舉值。
| 學年 | ||
|---|---|---|
| 2021 | 2025 | 2029 |
| 2022 | 2026 | 2030 |
| 2023 | 2027 | 2031 |
| 2024 | 2028 |
relationships.csv 包含「關聯性角色」屬性，並支援列舉值。
| 關聯性角色 | ||
|---|---|---|
| Parent | 監護人 | 助手 |
| 相對 | Child | 系統管理員 |
| 醫生 | 其他 |
enrollments.csv 包含 「role」 屬性，並支援列舉值。
| 註冊角色 | ||
|---|---|---|
| 學生 | VisionTherapist | Substitute |
| 助手 | Paraprofessional | 主要 |
| 普羅克特 | TeacherAssistant | SpecialServices |
| 老師 | 教授 | 導師 |
| 系統管理員 | 講師 | 指導 |
| 致使者 | 聯盟 | 助理 |
| PhysicalTherapist | 兼職 | 員工 |
| SpeechTherapist | 教練 |
Courses.csv 包含學術會話「主體」屬性，並支援列舉值。
| 課程主題 | 描述 |
|---|---|
| 01 | 英文和文體 |
| 02 | 數學 |
| 03 | 生命和物理科學 |
| 04 | 社會科學和歷程記錄 |
| 05 | 視覺效果和執行藝術 |
| 07 | 教職員教育與拓撲 |
| 08 | 實體、健康情況和安全教育 |
| 09 | 軍事科學 |
| 10 | 資訊技術 |
| 11 | 通訊和音訊/視覺技術 |
| 12 | 商務與行銷 |
| 13 | 製造 |
| 14 | 醫療保健科學 |
| 15 | 公用、保護及政府服務 |
| 16 | 經濟經濟與經濟 |
| 17 | 架構和建構 |
| 18 | 農業、食物和自然資源 |
| 19 | 人類服務 |
| 20 | 運輸、配送和物流 |
| 21 | 工程和技術 |
| 22 | 雜項 |
| 23 | 非主旨特定 |
| 24 | 世界語言 |
userFlags.csv 包含 「flag」 屬性，並支援列舉值。
| 用戶旗標 | 描述 |
|---|---|
| FreeLunch | 免費午餐 |
| ReducedLunch | 減少午餐 |
| 無家可歸 | 無家可歸 |
| GiftedOrTalented | 送出的或有才的 |
| 504 | 第 504 節位置 |
| ELL | 英文學習模組 |
| LEP | 有限的英文熟練度 |
| IEP | 特殊教育服務/獨立教育方案合格 |
demographics.csv 包含 「種族」屬性，並支援列舉值。
| 種族 | 描述 |
|---|---|
| 擴充函式OrLatinoEthnicity | 種族或種族 |
demographics.csv 包含 「race」 屬性，並支援列舉值。
| 比賽 | 描述 |
|---|---|
| AmericanIndianOrAlaskaNative | 美屬印度文或美洲原生 |
| NativeHawaiianOrOtherPacificIsnon | 原生臺灣或其他太平洋島人 |
| BlackOrAfricanAmerican | 黑色或非洲式 |
| DemographicRaceTwoOrMoreRaces | 指定多個種族 |
| 亞洲 | 亞洲 |
| 白色 | 白色 |
roles.csv 包含 「grade」 屬性，並支援列舉值。
Courses.csv 包含學術會話「等級」屬性，並支援列舉值。
| 年級 | 描述 |
|---|---|
| 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 | 第二位資深 |
| 本科 | 本科 |
| 畢業 | 畢業 |
| 研究生 | 以研究為重點的大學 |
| 校友 | 校友 |
| AdultEducation | 成人教育 |