SDS V2 CSV 檔案格式

透過擷取方法的核心 SDS 功能和 Microsoft 365 功能

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

注意事項

目前的 CSV V2 格式客戶可能會繼續使用，直到 2022 年 5 月為止。 我們建議使用 CSV V2.1 格式 搭配其額外功能。

使用 SDS V2 格式時，檔案必須適當地格式化。 本文說明與SDS搭配使用的格式化需求和支持的屬性。 您必須上傳這四個檔案，其名稱完全如以下所述。 檔案和數據行標頭會區分大小寫。 若要檢閱和下載 SDS V2 CSV 檔案的範例集，請參閱 SDS GitHub 存放庫。

每個 CSV 檔案都必須包含以下以綠色 醒目提示 的所有必要欄位。 未反白顯示的欄位是選擇性的。 雖然某些屬性的內容可能是選擇性的，但數據行標頭是必要的。 此外，在 [類型] 數據行中標示具有已定義列舉值的屬性，會有一組其支援的特定值。 請參閱下一節中每個列舉屬性的支援集合列舉值。

列舉 (列舉) 支援的列舉值

在新的 SDS V2 格式中，有數個定義為列舉值的屬性，這表示您只能在 CSV 檔案中提供一組選取的值。 除了指定的值之外，任何項目都會在同步處理期間導致錯誤。 下一節定義 SDS V2 格式中支援的列舉值。

users.csv包含 「role」 屬性，可支援下列列舉值。

users.csv包含 「grade」 屬性，並支援下列列舉值。

orgs.csv 包含 「type」 屬性，並支援下列列舉值。

enrollments.csv 包含 「role」 屬性，並支援下列列舉值。