學校資料同步處理的 CSV 檔案

重要:  本文係由機器翻譯而成,請參閱免責聲明。本文的英文版本請見這裡,以供參考。

您可以使用 CSV (逗號分隔值) 檔案的學校資料同步處理 (SDS),與Office 365同步處理您的學校資訊系統 (SIS)。如果您使用此方法時,您必須六個不同的 CSV 檔案設定 SDS 內的同步處理設定檔。本主題說明的 CSV 檔案,其所需的格式設定。

學校資料同步處理所需的 CSV 檔案

在設定 SDS 使用 CSV 檔案時,系統管理員必須編譯六個個別的 CSV 檔案包含下列詳細所有必要的屬性。您可能也包含任何一個選擇性屬性六個 CSV 檔案中為井。 如需如何設定同步處理設定檔的 SDS 的 CSV 檔案,請參閱如何部署使用 CSV 檔案的學校資料同步處理的詳細步驟。針對一組範例 CSV 檔案包含範例資料,以適當的屬性值以及格式設定,請參閱SDS GitHub 存放庫

CSV 檔案的必要的屬性會根據選取 SDS 同步處理設定檔設定精靈期間的同步處理設定檔選項而有所不同。此外,如果您的 Office 365 租用戶中 uk (英國),還有一些唯一需求六個 CSV 檔案,其包含的必要的屬性。請參閱Uk (英國) CSV 檔案的區段此文件中的 [更多詳細資料 uk (英國) 需求,或查看位於SDS GitHub 存放庫uk (英國) 範例檔案。

附註: 請確定 CSV 檔案不包含無效字元。此外,CSV 檔案不得包含超過 50 萬個資料列。如果超過 50 萬個資料列,您必須將超出的資料列分為另外 6 組 CSV 檔案,然後建立額外的同步處理設定檔來上傳及同步處理這些檔案。

六個必要的 CSV 檔案為:

附註: 這些 CSV 檔案必須完全按照所示來命名,並全部包含在本機電腦上的同一個資料夾或目錄下。這個目錄不應有其他檔案存在。此外,下面為每一個 CSV 檔案顯示的每個屬性名稱,都會在各自的 CSV 檔案中設定為標頭。

所有 CSV 檔案必須包含在相同目錄下

School.csv

School.csv 檔案必須包含這些必要的屬性。這些是建立及同步處理內 SDS 學校所需的最低必要的屬性。如果您不包含這些屬性,可能無法上傳的檔案或學校不會建立或同步處理正常運作,,後續的錯誤會包含在同步處理設定檔錯誤報告。

  • SIS ID   -學校 SIS 識別碼。

  • 名稱   :學校的名稱。

School.csv 選用屬性

School.csv 檔案可能包含的任何這些選用的屬性。當設定您的同步處理設定檔您可以新增任何的選用的下列屬性,但在選取每個屬性必須然後包含對應的 CSV 檔案中為欄標題。這些屬性必須符合完全下方包含拼字檢查、 大寫和語法的詳細的名稱。雖然 SDS 不需要這些欄位,運用 SDS 同步處理資料的任何應用程式可能會使用這些屬性。請務必包含最佳的應用程式體驗所需的任何/所有屬性。要求應用程式廠商,如在其個別的應用程式中使用哪一項這些屬性的詳細資訊。您隨時編輯並新增選擇性屬性至同步處理的設定檔中 SDS,稍後,如有需要。

  • 學校編號

  • 學校 NCES_ID

  • 狀態識別碼

  • 低年級

  • 高年級

  • 主要 SIS 識別碼

  • 主要名稱

  • 主要次要電子郵件

  • 地址

  • 縣/市

  • 州/省

  • 國家/地區

  • 郵遞區號

  • 電話

  • 區域

中的螢幕擷取畫面下方 SDS 同步處理設定檔設定精靈,灰色的屬性所需而顯示其餘的屬性是選擇性。

Section.csv

Section.csv 檔案必須包含這些所需的屬性。這些是最小的必要的屬性,才能建立並同步處理 SDS 內的一個區段。如果您不包含這些屬性,可能無法上傳的檔案或無法建立或同步處理正常運作,[] 區段中,後續的錯誤會包括在同步處理設定檔錯誤報告。

  • SIS 識別碼   – SIS 識別碼的節。

  • 學校 SIS 識別碼   :學校的 SIS 識別碼。

  • 課堂名稱   :課堂的名稱。

Section.csv 選用屬性

Section.csv 檔案可能包含的任何這些選用的屬性。當設定您的同步處理設定檔您可以新增任何的選用的下列屬性,但在選取每個屬性必須然後包含對應的 CSV 檔案中為欄標題。這些屬性必須符合完全下方包含拼字檢查、 大寫和語法的詳細的名稱。雖然 SDS 不需要這些欄位,運用 SDS 同步處理資料的任何應用程式可能會使用這些屬性。請務必包含最佳的應用程式體驗所需的任何/所有屬性。要求應用程式廠商,如在其個別的應用程式中使用哪一項這些屬性的詳細資訊。您隨時編輯並新增選擇性屬性至同步處理的設定檔中 SDS,稍後,如有需要。

  • 科別編號

  • 學期 SIS 識別碼

  • 學期名稱

  • 學期開始日期

  • 學期結束日期

  • 課程 SIS 識別碼

  • 課程名稱

  • 課程編號

  • 課程描述

  • 課程主題

  • 時段

  • 狀態

中的螢幕擷取畫面下方 SDS 同步處理設定檔設定精靈,灰色的屬性所需而顯示其餘的屬性是選擇性。

Student.csv

Student.csv 檔案必須包含這些必要的屬性。這些是建立及同步處理內 SDS 學生所需的最低必要的屬性。如果您不包含這些屬性,可能無法上傳的檔案或無法建立或同步處理正常運作,學生,後續的錯誤會包括在同步處理設定檔錯誤報告。

  • SIS 識別碼   :學生的 SIS 識別碼。

  • 學校 SIS ID   -學校 SIS 識別碼

  • 使用者名稱– 學生的使用者名稱

如果您選取期間 SDS 同步處理設定檔設定精靈的 [建立和同步處理新的使用者] 選項時,下列 3 個屬性,也會需要。如果您選擇同步處理現有的使用者,這些 3 的屬性,就不需要和 SDS 無法覆寫這些 Azure 要已存在於使用者物件中的屬性。

  • 第一個名稱   – 學生的第一個名稱。

  • 姓氏   – 學生的姓氏。

  • 密碼   – 為學生的密碼。Azure AD使用者帳戶密碼原則必須遵守密碼。

Student.csv 選用屬性

Student.csv 檔案可能包含的任何這些選用的屬性。當設定您的同步處理設定檔您可以新增任何的選用的下列屬性,但在選取每個屬性必須然後包含對應的 CSV 檔案中為欄標題。這些屬性必須符合完全下方包含拼字檢查、 大寫和語法的詳細的名稱。雖然 SDS 不需要這些欄位,運用 SDS 同步處理資料的任何應用程式可能會使用這些屬性。請務必包含最佳的應用程式體驗所需的任何/所有屬性。要求應用程式廠商,如在其個別的應用程式中使用哪一項這些屬性的詳細資訊。您隨時編輯並新增選擇性屬性至同步處理的設定檔中 SDS,稍後,如有需要。

  • 狀態識別碼

  • 次要電子郵件

  • 學生編號

  • 成績

  • 狀態

  • 郵寄地址

  • 郵寄縣/市

  • 郵寄州/省

  • 郵寄郵遞區號

  • 郵寄緯度

  • 郵寄經度

  • 郵寄國家/地區

  • 居住地址

  • 居住縣/市

  • 居住州/省

  • 居住地郵遞區號

  • 居住地緯度

  • 居住地經度

  • 居住國家/地區

  • 性別

  • 出生日期

  • ELL 狀態

  • FederalRace

  • 畢業年份

中的螢幕擷取畫面下方 SDS 同步處理設定檔設定精靈,灰色的屬性所需而顯示其餘的屬性是選擇性。

Teacher.csv

Teacher.csv 檔案必須包含這些必要的屬性。這些是最小的必要的屬性,才能建立並同步處理內 SDS 教師。如果您不包含這些屬性,可能無法上傳的檔案或老師無法建立或同步處理正常運作,,後續的錯誤會包含在同步處理設定檔錯誤報告。

  • SIS 識別碼   :教師的 SIS 識別碼。

  • 學校 SIS 識別碼   :學校的 SIS 識別碼。

  • 使用者名稱– 老師的使用者名稱

如果您選取期間 SDS 同步處理設定檔設定精靈的 [建立和同步處理新的使用者] 選項時,下列 3 個屬性,也會必要。如果您選擇同步處理現有的使用者,這些 3 的屬性,就不需要,並 SDS 無法覆寫這些 Azure 要已存在於使用者物件中的屬性。

  • 第一個名稱   – 老師的名字。

  • 姓氏   – 最後之教師的名稱

  • 密碼   – 老師的密碼。Azure AD使用者帳戶密碼原則必須遵守密碼。

Teacher.csv 選用屬性

Teacher.csv 檔案可能包含的任何這些選用的屬性。當設定您的同步處理設定檔您可以新增任何的選用的下列屬性,但在選取每個屬性必須然後包含對應的 CSV 檔案中為欄標題。這些屬性必須符合完全下方包含拼字檢查、 大寫和語法的詳細的名稱。雖然 SDS 不需要這些欄位,運用 SDS 同步處理資料的任何應用程式可能會使用這些屬性。請務必包含最佳的應用程式體驗所需的任何/所有屬性。要求應用程式廠商,如在其個別的應用程式中使用哪一項這些屬性的詳細資訊。您隨時編輯並新增選擇性屬性至同步處理的設定檔中 SDS,稍後,如有需要。

  • 狀態識別碼

  • 教師編號

  • 狀態

  • 次要電子郵件

  • 職稱

  • 資格

在螢幕擷取畫面下方從 SDS 同步處理設定檔設定精靈,灰色的屬性所需,是選擇性的藍色所顯示的剩餘的屬性。

StudentEnrollment.csv

StudentEnrollment.csv 檔案必須包含這些所需的屬性。這些是最小的必要的屬性所需的學生新增至 SDS 中的區段。如果您不包含這些屬性,可能無法上傳的檔案或 Studentenrollment 對應不會建立或同步處理正常運作,,後續的錯誤會包含在同步處理設定檔錯誤報告。

  • 課堂 SIS 識別碼   :課堂的 SIS 識別碼。

  • SIS 識別碼   :學生的 SIS 識別碼。

TeacherRoster.csv

TeacherRoster.csv 檔案必須包含這些必要的屬性。這些是最小的必要的屬性所需的新增教師至 SDS 內的一個區段。如果您不包含這些屬性,可能無法上傳的檔案或 TeacherRoster 對應不會建立或同步處理正常運作,,後續的錯誤會包含在同步處理設定檔錯誤報告。

  • 課堂 SIS 識別碼   :課堂的 SIS 識別碼。

  • SIS 識別碼   :教師的 SIS 識別碼。

Uk (英國) CSV 檔案

如果啟用學校資料同步處理英國 Office 365 租用戶中使用 CSV 檔案,有幾項差異之間所需的屬性如上所述,而 uk (英國) 的必要的屬性 CSV 檔案。下方 uk (英國) 的所有必要屬性的詳細資料的摘要以 CSV 檔案。上述所有選擇性屬性維持不變下 uk (英國) 結構描述。

School.csv

  • DfE 數字– DfE 學校的數目

  • 名稱-學校的名稱

Section.csv

  • 識別碼– 識別碼的節

  • 學校 DfE 數字– DfE 學校的數目

  • 章節名稱– 區段的名稱

Student.csv

  • 識別碼– 學生的識別碼

  • 學校 DfE 數字– DfE 學校的數目

  • 使用者名稱– 學生的使用者名稱

Teacher.csv

  • 識別碼– 老師的識別碼

  • 學校 DfE 數字– DfE 學校的數目

  • 使用者名稱– 老師的使用者名稱

StudentEnrollment.csv

  • 區段識別碼– 識別碼的節

  • 識別碼– 老師 SIS 識別碼

TeacherRoster.csv

  • 區段識別碼– 識別碼的節

  • 識別碼– 老師的識別碼

相關主題

學校資料概觀同步處理和教室

如何使用 CSV 檔案中部署學校資料同步處理

附註: 機器翻譯免責聲明︰本文係以電腦系統翻譯而成,未經人為介入。Microsoft 提供此等機器翻譯旨在協助非英語系使用者輕鬆閱讀 Microsoft 產品、服務及技術相關內容。基於本文乃由機器翻譯而成,因此文中可能出現詞辭、語法、文法上之錯誤。

擴展您的技能
探索訓練
優先取得新功能
加入 Office 測試人員

這項資訊有幫助嗎?

感謝您的意見反應!

感謝您的意見反應! 我們將協助您與其中一位 Office 支援專員連絡以深入了解您的意見。

×