SDS V1 CSV 檔案格式

重要事項

學校數據同步處理 (SDS) 傳統轉換客戶:並非所有欄位都支援將數據帶入以 v1 格式為基礎的新 SDS 體驗。 您可以在 [必要] 資料行下的 SDS v1 CSV 檔案格式中找到它們,因為不支援數據。

重要事項

此外,通過的 成績 值和 課程主題 值必須與其對應的 值清單 (列舉) 代碼保持一致。 如有需要,請使用 「管理值清單 」來展開 「成績 值」和 「課程主旨」 ,以支援預設不支援的程式碼值。

您可以使用 CSV (SDS V1 格式的逗號分隔值) 檔案,將學校資訊系統 (SIS) 與 Office 365 同步處理。 使用 SDS V1 CSV 檔案格式來內嵌數據類別,可讓您點亮核心 SDS 功能以進行布建。 它也可協助您增強 Microsoft 365 產品和功能的體驗。

如果您使用 SDS V1 格式,則檔案必須適當格式化。 上傳文件,其名稱與本文中詳細的名稱完全相同。 欄標頭區分大小寫。 CSV 檔案必須採用 UTF-8 格式且符合 RFC 標準。 此外,我們不接受傳入資料中的換行符。 若要檢閱和下載 SDS V1 CSV 檔案的範例集, 請參閱 SDS GitHub 存放庫。

重要事項

在建立傳入流程期間進行初始上傳之後,無論您在選用檔案中所做的資料變更為何,您都需要一律提供相同的檔案集以供後續上傳。 如果不這樣做,系統會判斷記錄不再處於作用中狀態,並將其標示為作用中。

必要:必須先選取下列三個檔案,才能繼續進行。 如果您只管理使用者而不管理類別,則只需要提供這些檔案。

  • school.csv

  • student.csv

  • teacher.csv

選用/必要:如果您只管理使用者,則不需要。 如果您也管理班級和班級註冊,則必須提供下列三個檔案,以及先前提到的三個檔案。 如果不是,請勿選取任何具有這些名稱的檔案。

  • section.csv

  • studentenrollment.csv

  • teacherroster.csv

選擇性:下列檔案不需要繼續進行,但可以增強體驗。 如果選取下列其中一個檔案,則也必須選取另一個檔案才能繼續。

  • user.csv

  • guardianrelationship.csv (需要使用者和學生記錄來建立聯絡人關聯.)

每個 CSV 檔案都必須包含「必要」下註明為「是」欄位的資料,註明為「否」的欄位為「選用」資料。 標示為「必要」的欄位標頭必須存在於提供的檔案中,否則將不會接受這些欄位標頭。 如果未傳遞對應的選擇性資料,則不需要在檔案中存在標示為「選擇性」的欄位標頭。

具有「資料類型」欄中標記的已定義列舉值的欄位具有它們支援的特定值集。 列舉欄位支援的預設值集 請參閱預設值清單。

school.csv

欄位 必要? 範例 資料類型
SIS 識別碼 是 456789 唯一 ID
名稱 是 Contoso 高中 字串
學校 NCES_ID 否 456789 字串
學校號碼 不支援的資料
低年級 不支援的資料
高年級 不支援的資料
縣/市 ID 不支援的資料
校長 SIS ID 不支援的資料
校長姓名 不支援的資料
校長次要電子郵件 不支援的資料
地址 不支援的資料
鄉/鎮/市/區 不支援的資料
狀態 不支援的資料
郵遞區號 不支援的資料
國家/地區 不支援的資料
Phone 不支援的資料
區域 不支援的資料
  • 列出的所有組織都將設置為組織類型“學校”。

student.csv

欄位 必要? 範例 資料類型
SIS 識別碼 是 123456 唯一 ID
學校 SIS ID 是 456789 唯一 ID
使用者名稱 是 jsmith@contoso.edu 字串
名字 是 (僅在建立使用者) 時 John 字串
姓氏 是 (僅在建立使用者) 時 Smith 字串
中間名 否 威廉 字串
次要電子郵件 否 jsmith@contoso.edu 電子郵件
學生號碼 否 123456 字串
年級 否 8 Enum
出生日期 否 2009-12-19 Date
狀態 不支援的資料
密碼 不支援的資料
畢業年份 不支援的資料
縣/市 ID 不支援的資料
  • 需要使用「學校 SIS ID」欄位對關聯學校的引用,並產生對 school.csv 檔案的依賴關係。
  • 列出的所有使用者都會設定為「學生」角色類型。
  • 預期日期值會以ISO8601格式提供。
  • 年級列舉的傳入值上缺少前導零“0”,例如“1”)將匹配定義的列舉 (值列表) “01”,並將存儲為“01”。

teacher.csv

欄位 必要? 範例 資料類型
SIS 識別碼 是 654321 唯一 ID
學校 SIS ID 是 456789 唯一 ID
使用者名稱 是 jcook@contoso.edu 字串
名字 是 (僅在建立使用者) 時 簡 字串
姓氏 是 (僅在建立使用者) 時 煮 字串
中間名 否 梅雷迪思 字串
教師號碼 否 654321 字串
年級 否 8 Enum
次要電子郵件 否 jcook@contoso.edu 電子郵件
狀態 不支援的資料
密碼 不支援的資料
標題 不支援的資料
縣/市 ID 不支援的資料
資格 不支援的資料
  • 需要使用「學校 SIS ID」欄位對關聯學校的引用,從而產生對 school.csv 檔案的依賴關係。
  • 列出的所有使用者都會設定為「教師」角色類型。
  • 年級 ENUM 的傳入值缺少前導零“0”。 例如,'1' 將符合定義的 [值清單 (列舉) '01',並儲存為 '01'。

section.csv

欄位 必要? 範例 資料類型
SIS 識別碼 是 334455 唯一 ID
學校 SIS ID 是 456789 唯一 ID
區段名稱 是 第一期 - 世界歷史 字串
區段號碼 否 334466 字串
課程 SIS ID 否 123456789 唯一 ID
課程名稱 否 世界歷史 10 字串
課程號碼 否 123456789 字串
課程說明 否 世界歷史 字串
課程主題 否 54999 Enum
條款 SIS ID 不支援的資料
條款名稱 不支援的資料
條款開始日期 不支援的資料
條款結束日期 不支援的資料
狀態 不支援的資料
期間 不支援的資料
  • 需要使用「學校 SIS ID」欄位對關聯學校的引用,從而產生對 school.csv 檔案的依賴關係。
  • 如果需要字詞資訊,建議您移至 SDS v2.1 CSV 格式 ,並提供 academicSessions.csv 檔案。

studentenrollment.csv

欄位 必要? 範例 資料類型
區段 SIS ID 是 334455 唯一 ID
SIS 識別碼 是 123456 唯一 ID
  • 這需要使用「區段 SIS ID」欄位對相關聯區段進行參考,並產生對 section.csv 檔案的相依性。
  • 這需要使用「SIS ID」欄位對關聯使用者進行參考,並產生對 student.csv 檔案的依賴關係。

teacherroster.csv

欄位 必要? 範例 資料類型
區段 SIS ID 是 334455 唯一 ID
SIS 識別碼 是 654321 唯一 ID
  • 這需要使用「區段 SIS ID」欄位對相關聯區段進行參考,並產生對 section.csv 檔案的相依性。
  • 這需要使用「SIS ID」欄位對關聯使用者進行參考,並產生對 teacher.csv 檔案的依賴關係。

user.csv

欄位 必要? 範例 資料類型
電子郵件 是 jsmith@outlook.com 電子郵件
名字 是 John 字串
姓氏 是 Smith 字串
Phone 否 +1234567890 Phone
SIS 識別碼 否 P_123456 唯一 ID
  • 如果您也同步處理 (監護人) 的聯絡人關係,則必須在 user.csv 中包含他們的記錄。
  • 預計電話欄位將根據E.164標準進行格式化,其中使用加號字元並由電話號碼接尾,或者加號字元後跟國家/地區代碼、區號、電話字首和線路號碼。

guardianrelationship.csv

欄位 必要? 範例 資料類型
SIS 識別碼 是 123456 唯一 ID
電子郵件 是 jsmith@outlook.com 電子郵件
角色 否 Parent Enum
  • 如果您也同步處理 (監護人) 的聯絡人關係,則必須在 user.csv 中包含他們的記錄。
  • 這需要使用「Email」欄位參考關聯使用者,並產生對 user.csv 檔案的依賴關係。
  • 這需要使用「SIS ID」欄位對關聯使用者進行參考,並產生對 student.csv 檔案的依賴關係。
  • 如果未提供角色值,則關聯性值預設為 'userContact'。