SDS 的 CSV V1 檔案格式

  • 發行項

您可以使用 CSV (逗號分隔值) SDS 格式的檔案，將您的學校資訊系統 (SIS) 與 Office 365 同步處理。 使用 SDS V1 CSV 檔案格式來擷取下列數據類別，可讓您亮起用於布建的核心 SDS 功能。 它也可讓您增強 Microsoft 365 (Microsoft 365) 下列產品和功能的體驗。

SDS CSV V1 的核心功能圖表。

使用適用於學校數據同步的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 檔案也可能包含任何列出的選擇性欄位。 如果您的 CSV 檔案包含任何不支援的字元，則可以在同步處理期間選取 SDS 同步設定檔安裝精靈內的 [取代不支援的特殊字元] 選項，以內嵌方式取代它們。 不過，這不會移除「空格符」，這也無效。 下表依檔案列出檔案的必要和選擇性屬性：

注意事項

Microsoft 建議針對 SDS CSV 檔案中的所有日期字段使用 ISO 8601 格式 ，格式為 YYYY-MM-DD 或 YYYYMMDD。 SDS 計劃在未來幾個月推出需要此格式的功能，請參閱下面所述的 [字詞開始] 和 [結束日期] 字段。

  • >Students.csv Birthdate
  • >Sections.csv 字詞開始日期
  • >Sections.csv 字詞 EndDate

針對所有日期欄位使用 ISO 8601 格式。

sds 計劃在未來幾個月推出功能。

使用正確的列舉。

![如果您未使用正確的列舉，您會收到個別的列舉]。] (影像/School-Data-Sync-format-CSV-files-for-SDS-5.png)

深入解析驗證程式。

請參閱 sds 以取得深入解析數據健康情況和監視。