適用於 SDS 的 Clever 格式 CSV 檔案

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

使用適用於 SDS 的 Clever 格式 CSV 檔案時，必須適當地格式化檔案。 本節說明搭配 SDS 使用的格式化需求。 下方唯 一絕對必要的 欄位會以綠色醒目提示。 這也會系結至 CSV 檔案 範例頁面上的範例資訊。 您必須擁有下列五個 CSV 檔案，其名稱完全如以下所述。 不接受 admins.csv 在 SDS 中使用。

重要事項

我們接受的 CSV 檔案和導出的預設 CSV 檔案有一些差異。 若要上傳這些 CSV 檔案並成功同步處理，它們必須遵循此處所列的格式。 您可以在此頁面底部找到詳細資訊。 CSV 檔案必須是UTF-8格式。

students.csv

teachers.csv

schools.csv

sections.csv

enrollments.csv

每個 CSV 檔案都必須包含以下以綠色 醒目提示 的所有必要欄位。 每個 CSV 檔案也可能包含任何列出的選擇性欄位。 如果您的 CSV 檔案包含任何不支援的字元，則可以在同步處理期間選取 SDS 同步設定檔安裝精靈內的 [取代不支援的特殊字元] 選項，以內嵌方式取代它們。 不過，這不會移除「空格符」，這也無效。 下表依檔案列出檔案的必要和選擇性屬性：

注意事項

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

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

預設 Clever 格式 CSV 檔案與 SDS 所接受檔案之間的差異

SDS 所接受的 Clever CSV 檔案與 Clever 所導出的預設 CSV 檔案之間有一些不一致之處，可能會造成一些混淆。 最大的差異是 Student.csv 檔案中 [用戶名稱] 和 [密碼] 的數據行。

用戶名稱欄位主要是針對配置檔建立期間的比對準則而需要的。 這可以在如何使用 Clever 格式 CSV 檔案進行部署的步驟 5 上檢視。

建立配置檔的全新使用者時，會使用username資料行以及密碼數據行。

其他差異是選擇性的同步屬性。 SDS 只會將 上的擴充功能屬性同步處理至上面所列的相關群組和使用者。 如果其中任何一個檔案包含其他資訊，同步處理仍會處理，但其他資訊不會系結至使用者或群組。 這是預期的行為，而且所有 CSV 配置檔同步都是如此。

範例：如果 student.csv 檔案已如 Clever 檔中所述使用 [性別] 數據行上傳，SDS 仍會處理檔案並將其他屬性同步至目標學生，但不會針對性別同步屬性。