SDS 的 CSV V1 檔案格式
您可以使用 CSV (逗號分隔值) SDS 格式的檔案,將您的學校資訊系統 (SIS) 與 Office 365 同步處理。 使用 SDS V1 CSV 檔案格式來擷取下列數據類別,可讓您亮起用於布建的核心 SDS 功能。 它也可讓您增強 Microsoft 365 (Microsoft 365) 下列產品和功能的體驗。
使用適用於學校數據同步的SV檔案時,必須適當地格式化檔案。 本節說明搭配 SDS 使用的格式化需求。 CSV 檔案必須是UTF-8格式。 下方唯 一絕對必要的 欄位會以綠色醒目提示。 這也會系結至 CSV 檔案 範例頁面上的範例資訊。 您必須擁有下列 6 個 CSV 檔案,其名稱完全如以下所述。 若要檢閱並下載 SDS 格式的 CSV 檔案範例集,請參閱 SDS GitHub 存放庫。
student.csv
teacher.csv
school.csv
section.csv
studentenrollment.csv
teacherroster.csv
每個 CSV 檔案都必須包含以下以綠色 醒目提示 的所有必要欄位。 每個 CSV 檔案也可能包含任何列出的選擇性欄位。 如果您的 CSV 檔案包含任何不支援的字元,則可以在同步處理期間選取 SDS 同步設定檔安裝精靈內的 [取代不支援的特殊字元] 選項,以內嵌方式取代它們。 不過,這不會移除「空格符」,這也無效。 下表依檔案列出檔案的必要和選擇性屬性:
注意事項
Microsoft 建議針對 SDS CSV 檔案中的所有日期字段使用 ISO 8601 格式 ,格式為 YYYY-MM-DD 或 YYYYMMDD。 SDS 計劃在未來幾個月推出需要此格式的功能,請參閱下面所述的 [字詞開始] 和 [結束日期] 字段。
- >Students.csv Birthdate
- >Sections.csv 字詞開始日期
- >Sections.csv 字詞 EndDate
![如果您未使用正確的列舉,您會收到個別的列舉]。] (影像/School-Data-Sync-format-CSV-files-for-SDS-5.png)