SDS V1 CSV 檔案格式
重要事項
SDS (傳統) TRANSITION CUSTOMERS：並非所有欄位都支援根據 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 (需要使用者和學生記錄才能建立聯繫人 association.)
每個 CSV 檔案都必須包含 'Required' 底下註明 'Yes' 的欄位數據，註明的欄位 「否」是「選擇性」數據。 標示為「必要」的字段標頭必須存在於提供的檔案中，否則將不會被接受。 如果未傳遞對應的選擇性數據，則標記為「選擇性」的欄位標頭不需要出現在檔案中。
在 [數據類型] 數據列中標示已定義列舉值的欄位，有一組其支援的特定值。 列舉欄位支援的預設值集 ，請參閱預設值清單。
school.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| SIS 識別碼 | 是 | 456789 | 唯一標識碼 |
| 名稱 | 是 | Contoso High School | 字串 |
| 學校 NCES_ID | 否 | 456789 | 字串 |
| 學校號碼 | 不支持數據 | ||
| 低年級 | 不支持數據 | ||
| 高年級 | 不支持數據 | ||
| 縣/市 ID | 不支持數據 | ||
| 校長 SIS ID | 不支持數據 | ||
| 校長姓名 | 不支持數據 | ||
| 校長次要電子郵件 | 不支持數據 | ||
| 地址 | 不支持數據 | ||
| 鄉/鎮/市/區 | 不支持數據 | ||
| 狀態 | 不支持數據 | ||
| 郵遞區號 | 不支持數據 | ||
| 國家/地區 | 不支持數據 | ||
| Phone | 不支持數據 | ||
| 區域 | 不支持數據 |
- 列出的所有組織都會設定為組織類型 『school』。
student.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| SIS 識別碼 | 是 | 123456 | 唯一標識碼 |
| 學校 SIS 識別碼 | 是 | 456789 | 唯一標識碼 |
| 使用者名稱 | 是 | jsmith@contoso.edu | 字串 |
| 名字 | 只有在建立使用者) 時，才 ( | John | 字串 |
| 姓氏 | 只有在建立使用者) 時，才 ( | Smith | 字串 |
| 中間名 | 否 | 威廉 | 字串 |
| 次要電子郵件 | 否 | jsmith@contoso.edu | 電子郵件 |
| 學生號碼 | 否 | 123456 | 字串 |
| 年級 | 否 | 8 | Enum |
| 出生日期 | 否 | 2009-12-19 | Date |
| 狀態 | 不支持數據 | ||
| 密碼 | 不支持數據 | ||
| 畢業年份 | 不支持數據 | ||
| 縣/市 ID | 不支持數據 |
- 需要使用 [學校 SIS 標識符] 字段參考相關聯的學校。 這會產生對 school.csv 檔案的相依性。
- 列出的所有用戶都會設定為角色類型 『student』。
- 預期會以ISO8601格式提供日期值。
- 等級列舉的傳入值遺漏前置零 『0』，例如 『1』，會符合定義的值清單 (列舉) 『01』，並且會儲存為 『01』。
teacher.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| SIS 識別碼 | 是 | 654321 | 唯一標識碼 |
| 學校 SIS 識別碼 | 是 | 456789 | 唯一標識碼 |
| 使用者名稱 | 是 | jcook@contoso.edu | 字串 |
| 名字 | 只有在建立使用者) 時，才 ( | 珍 | 字串 |
| 姓氏 | 只有在建立使用者) 時，才 ( | 煮 | 字串 |
| 中間名 | 否 | 梅瑞狄斯 | 字串 |
| 教師號碼 | 否 | 654321 | 字串 |
| 年級 | 否 | 8 | Enum |
| 次要電子郵件 | 否 | jcook@contoso.edu | 電子郵件 |
| 狀態 | 不支持數據 | ||
| 密碼 | 不支持數據 | ||
| 標題 | 不支持數據 | ||
| 縣/市 ID | 不支持數據 | ||
| 資格 | 不支持數據 |
- 需要使用 [學校 SIS 標識符] 字段參考相關聯的學校。 這會產生對 school.csv 檔案的相依性。
- 列出的所有用戶都會設定為角色類型 『teacher』。
- 等級列舉的傳入值遺漏前置零 『0』，例如 『1』，會符合定義的值清單 (列舉) 『01』，並且會儲存為 『01』。
section.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| SIS 識別碼 | 是 | 334455 | 唯一標識碼 |
| 學校 SIS 識別碼 | 是 | 456789 | 唯一標識碼 |
| 區段名稱 | 是 | 第 1 個期間 - 世界歷程記錄 | 字串 |
| 區段號碼 | 否 | 334466 | 字串 |
| 課程 SIS ID | 否 | 123456789 | 唯一標識碼 |
| 課程名稱 | 否 | 世界歷程記錄 10 | 字串 |
| 課程號碼 | 否 | 123456789 | 字串 |
| 課程說明 | 否 | 世界歷程記錄 | 字串 |
| 課程主題 | 否 | 54999 | Enum |
| 條款 SIS ID | 不支持數據 | ||
| 條款名稱 | 不支持數據 | ||
| 條款開始日期 | 不支持數據 | ||
| 條款結束日期 | 不支持數據 | ||
| 狀態 | 不支持數據 | ||
| 期間 | 不支持數據 |
- 需要使用 [學校 SIS 標識符] 字段參考相關聯的學校。 這會產生對 school.csv 檔案的相依性。
- 如果需要字詞資訊，建議移至 SDS v2.1 CSV 格式 ，並提供 academicSessions.csv 檔案。
studentenrollment.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| 區段 SIS 識別碼 | 是 | 334455 | 唯一標識碼 |
| SIS 識別碼 | 是 | 123456 | 唯一標識碼 |
- 這需要使用 [區段 SIS 識別符] 字段參考相關聯的區段。 這會產生對 section.csv 檔案的相依性。
- 這需要使用 [SIS 標識符] 字段來參考相關聯的使用者。 這會產生對 student.csv 檔案的相依性。
teacherroster.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| 區段 SIS 識別碼 | 是 | 334455 | 唯一標識碼 |
| SIS 識別碼 | 是 | 654321 | 唯一標識碼 |
- 這需要使用 [區段 SIS 識別符] 字段參考相關聯的區段。 這會產生對 section.csv 檔案的相依性。
- 這需要使用 [SIS 標識符] 字段來參考相關聯的使用者。 這會產生對 teacher.csv 檔案的相依性。
user.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| 電子郵件 | 是 | jsmith@outlook.com | 電子郵件 |
| 名字 | 是 | John | 字串 |
| 姓氏 | 是 | Smith | 字串 |
| Phone | 否 | +1234567890 | Phone |
| SIS 識別碼 | 否 | P_123456 | 唯一標識碼 |
- 如果您也要將聯繫人關聯性同步 (守護者) ，則必須在 user.csv 中包含其記錄。
- 預期電話欄位會根據 E.164 標準進行格式化，其中加號會使用加號並成功，或是加上加上字元，後面接著國家/地區代碼、區碼、電話前綴和行號。
guardianrelationship.csv
| 欄位 | 必要？ | 範例 | 資料類型 |
|---|---|---|---|
| SIS 識別碼 | 是 | 123456 | 唯一標識碼 |
| 電子郵件 | 是 | jsmith@outlook.com | 電子郵件 |
| 角色 | 否 | Parent | Enum |
- 如果您也要將聯繫人關聯性同步 (守護者) ，則必須在 user.csv 中包含其記錄。
- 這需要使用 『Email』 字段來參考相關聯的使用者。 這會產生對 user.csv 檔案的相依性。
- 這需要使用 [SIS 標識符] 字段來參考相關聯的使用者。 這會產生對 student.csv 檔案的相依性。
- 如果未提供 Role 值，則關聯性值預設為 『userContact』。