重要事項
學校數據同步處理 (SDS) 傳統轉換客戶：並非所有欄位都支援將數據帶入以 v1 格式為基礎的新 SDS 體驗。 您可以在 [必要] 資料行下的 SDS v1 CSV 檔案格式中找到它們，因為不支援數據。
重要事項
此外，通過的 成績 值和 課程主題 值必須與其對應的 值清單 (列舉) 代碼保持一致。 如有需要，請使用 「管理值清單 」來展開 「成績 值」和 「課程主旨」 ，以支援預設不支援的程式碼值。
您可以使用 CSV (SDS V1 格式的逗號分隔值) 檔案，將學校資訊系統 (SIS) 與 Office 365 同步處理。 使用 SDS V1 CSV 檔案格式來內嵌數據類別，可讓您點亮核心 SDS 功能以進行布建。 它也可協助您增強 Microsoft 365 產品和功能的體驗。
如果您使用 SDS V1 格式，則檔案必須適當格式化。 上傳文件，其名稱與本文中詳細的名稱完全相同。 欄標頭區分大小寫。 CSV 檔案必須採用 UTF-8 格式且符合 RFC 標準。 此外，我們不接受傳入資料中的換行符。 若要檢閱和下載 SDS V1 CSV 檔案的範例集， 請參閱 SDS GitHub 存放庫。
重要事項
在建立傳入流程期間進行初始上傳之後，無論您在選用檔案中所做的資料變更為何，您都需要一律提供相同的檔案集以供後續上傳。 如果不這樣做，系統會判斷記錄不再處於作用中狀態，並將其標示為作用中。
必要：必須先選取下列三個檔案，才能繼續進行。 如果您只管理使用者而不管理類別，則只需要提供這些檔案。
school.csv
student.csv
teacher.csv
選用/必要：如果您只管理使用者，則不需要。 如果您也管理班級和班級註冊，則必須提供下列三個檔案，以及先前提到的三個檔案。 如果不是，請勿選取任何具有這些名稱的檔案。
section.csv
studentenrollment.csv
teacherroster.csv
選擇性：下列檔案不需要繼續進行，但可以增強體驗。 如果選取下列其中一個檔案，則也必須選取另一個檔案才能繼續。
user.csv
guardianrelationship.csv (需要使用者和學生記錄來建立聯絡人關聯.)
每個 CSV 檔案都必須包含「必要」下註明為「是」欄位的資料，註明為「否」的欄位為「選用」資料。 標示為「必要」的欄位標頭必須存在於提供的檔案中，否則將不會接受這些欄位標頭。 如果未傳遞對應的選擇性資料，則不需要在檔案中存在標示為「選擇性」的欄位標頭。
具有「資料類型」欄中標記的已定義列舉值的欄位具有它們支援的特定值集。 列舉欄位支援的預設值集 請參閱預設值清單。
school.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| SIS 識別碼 | 是 | 456789 | 唯一 ID |
| 名稱 | 是 | Contoso 高中 | 字串 |
| 學校 NCES_ID | 否 | 456789 | 字串 |
| 學校號碼 | 不支援的資料 | ||
| 低年級 | 不支援的資料 | ||
| 高年級 | 不支援的資料 | ||
| 縣/市 ID | 不支援的資料 | ||
| 校長 SIS ID | 不支援的資料 | ||
| 校長姓名 | 不支援的資料 | ||
| 校長次要電子郵件 | 不支援的資料 | ||
| 地址 | 不支援的資料 | ||
| 鄉/鎮/市/區 | 不支援的資料 | ||
| 狀態 | 不支援的資料 | ||
| 郵遞區號 | 不支援的資料 | ||
| 國家/地區 | 不支援的資料 | ||
| Phone | 不支援的資料 | ||
| 區域 | 不支援的資料 |
- 列出的所有組織都將設置為組織類型“學校”。
student.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| SIS 識別碼 | 是 | 123456 | 唯一 ID |
| 學校 SIS ID | 是 | 456789 | 唯一 ID |
| 使用者名稱 | 是 | jsmith@contoso.edu | 字串 |
| 名字 | 是 (僅在建立使用者) 時 | John | 字串 |
| 姓氏 | 是 (僅在建立使用者) 時 | Smith | 字串 |
| 中間名 | 否 | 威廉 | 字串 |
| 次要電子郵件 | 否 | jsmith@contoso.edu | 電子郵件 |
| 學生號碼 | 否 | 123456 | 字串 |
| 年級 | 否 | 8 | Enum |
| 出生日期 | 否 | 2009-12-19 | Date |
| 狀態 | 不支援的資料 | ||
| 密碼 | 不支援的資料 | ||
| 畢業年份 | 不支援的資料 | ||
| 縣/市 ID | 不支援的資料 |
- 需要使用「學校 SIS ID」欄位對關聯學校的引用，並產生對 school.csv 檔案的依賴關係。
- 列出的所有使用者都會設定為「學生」角色類型。
- 預期日期值會以ISO8601格式提供。
- 年級列舉的傳入值上缺少前導零“0”，例如“1”）將匹配定義的列舉 (值列表) “01”，並將存儲為“01”。
teacher.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| SIS 識別碼 | 是 | 654321 | 唯一 ID |
| 學校 SIS ID | 是 | 456789 | 唯一 ID |
| 使用者名稱 | 是 | jcook@contoso.edu | 字串 |
| 名字 | 是 (僅在建立使用者) 時 | 簡 | 字串 |
| 姓氏 | 是 (僅在建立使用者) 時 | 煮 | 字串 |
| 中間名 | 否 | 梅雷迪思 | 字串 |
| 教師號碼 | 否 | 654321 | 字串 |
| 年級 | 否 | 8 | Enum |
| 次要電子郵件 | 否 | jcook@contoso.edu | 電子郵件 |
| 狀態 | 不支援的資料 | ||
| 密碼 | 不支援的資料 | ||
| 標題 | 不支援的資料 | ||
| 縣/市 ID | 不支援的資料 | ||
| 資格 | 不支援的資料 |
- 需要使用「學校 SIS ID」欄位對關聯學校的引用，從而產生對 school.csv 檔案的依賴關係。
- 列出的所有使用者都會設定為「教師」角色類型。
- 年級 ENUM 的傳入值缺少前導零“0”。 例如，'1' 將符合定義的 [值清單 (列舉) '01'，並儲存為 '01'。
section.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| SIS 識別碼 | 是 | 334455 | 唯一 ID |
| 學校 SIS ID | 是 | 456789 | 唯一 ID |
| 區段名稱 | 是 | 第一期 - 世界歷史 | 字串 |
| 區段號碼 | 否 | 334466 | 字串 |
| 課程 SIS ID | 否 | 123456789 | 唯一 ID |
| 課程名稱 | 否 | 世界歷史 10 | 字串 |
| 課程號碼 | 否 | 123456789 | 字串 |
| 課程說明 | 否 | 世界歷史 | 字串 |
| 課程主題 | 否 | 54999 | Enum |
| 條款 SIS ID | 不支援的資料 | ||
| 條款名稱 | 不支援的資料 | ||
| 條款開始日期 | 不支援的資料 | ||
| 條款結束日期 | 不支援的資料 | ||
| 狀態 | 不支援的資料 | ||
| 期間 | 不支援的資料 |
- 需要使用「學校 SIS ID」欄位對關聯學校的引用，從而產生對 school.csv 檔案的依賴關係。
- 如果需要字詞資訊，建議您移至 SDS v2.1 CSV 格式 ，並提供 academicSessions.csv 檔案。
studentenrollment.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| 區段 SIS ID | 是 | 334455 | 唯一 ID |
| SIS 識別碼 | 是 | 123456 | 唯一 ID |
- 這需要使用「區段 SIS ID」欄位對相關聯區段進行參考，並產生對 section.csv 檔案的相依性。
- 這需要使用「SIS ID」欄位對關聯使用者進行參考，並產生對 student.csv 檔案的依賴關係。
teacherroster.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| 區段 SIS ID | 是 | 334455 | 唯一 ID |
| SIS 識別碼 | 是 | 654321 | 唯一 ID |
- 這需要使用「區段 SIS ID」欄位對相關聯區段進行參考，並產生對 section.csv 檔案的相依性。
- 這需要使用「SIS ID」欄位對關聯使用者進行參考，並產生對 teacher.csv 檔案的依賴關係。
user.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| 電子郵件 | 是 | jsmith@outlook.com | 電子郵件 |
| 名字 | 是 | John | 字串 |
| 姓氏 | 是 | Smith | 字串 |
| Phone | 否 | +1234567890 | Phone |
| SIS 識別碼 | 否 | P_123456 | 唯一 ID |
- 如果您也同步處理 (監護人) 的聯絡人關係，則必須在 user.csv 中包含他們的記錄。
- 預計電話欄位將根據E.164標準進行格式化，其中使用加號字元並由電話號碼接尾，或者加號字元後跟國家/地區代碼、區號、電話字首和線路號碼。
guardianrelationship.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| SIS 識別碼 | 是 | 123456 | 唯一 ID |
| 電子郵件 | 是 | jsmith@outlook.com | 電子郵件 |
| 角色 | 否 | Parent | Enum |
- 如果您也同步處理 (監護人) 的聯絡人關係，則必須在 user.csv 中包含他們的記錄。
- 這需要使用「Email」欄位參考關聯使用者，並產生對 user.csv 檔案的依賴關係。
- 這需要使用「SIS ID」欄位對關聯使用者進行參考，並產生對 student.csv 檔案的依賴關係。
- 如果未提供角色值，則關聯性值預設為 'userContact'。