使用 SDS v2.1 CSV 擷取數據

發行項
03/19/2024

設定 Microsoft 365 教育版租使用者的 SDS

Microsoft 365 教育版租使用者
需要全域管理員許可權

警告

您可以使用 CSV (逗號分隔值) 檔案，將您的學校資訊系統 (SIS) /學生管理系統同步 (SMS) 。 SDS 僅支援上傳 UTF-8 格式和 RFC 相容的 CSV 檔案。每個 CSV 檔案都必須包含 'Required' 底下註明 'Yes' 的欄位數據，註明的欄位「否」是「選擇性」數據。標示為「必要」的字段標頭必須存在於提供的檔案中，否則將不會被接受。如果未傳遞對應的選擇性數據，則標記為「選擇性」的欄位標頭不一定存在於檔案中。如需詳細資訊，請參閱 SDS v2.1 CSV 檔案格式。

重要事項

藉由連線並讓機構數據可供學校數據同步使用，您會確認您有權與 Microsoft 共用此數據，並認可遵守貴組織的數據控管標準。

若要存取 SDS 管理員入口網站啟動網頁瀏覽器，請流覽至 sds.microsoft.com，然後使用您的 Microsoft 365 全域管理員帳戶登入。

選取 [開始使用]。
選取 [繼續]。

在下一個步驟之前，請稍候一段時間，讓服務布建到租使用者。
選 取 [建立新的輸入流程] ，然後選取 [下一步 ] 以繼續。
選擇您的數據來源。針對 SDS CSV 2.1，您可以選取 [ 連線到我的數據] 選項。
選取格式。針對 CSV，您可以選取 [ CSV] 選項。 下一步 繼續。
您必須提供 SIS/SMS 的名稱。此外，選取 [SDS v2.1 CSV]。選取 [下一步] 繼續。
選 取 [瀏覽檔案 ] 以顯示瀏覽和選取對話框。

注意事項

在建立輸入流程期間初始上傳之後，無論選擇性檔案中是否進行數據變更，您都必須一律為後續上傳提供相同的檔案集。如果您未這麼做，系統會判斷記錄已不再作用中，而且會將它們標示為這類記錄。
流覽至檔案位置，然後選取檔案。

請參閱 SDS V2.1 CSV 檔案格式。

必要：您必須先選取下列三個檔案，才能進行。如果您只管理使用者而非類別，則只需要提供這些檔案。
- orgs.csv
- users.csv
- roles.csv
選擇性/必要：如果您只管理使用者，則不需要。如果您也管理類別和類別註冊，您必須提供下列兩個檔案，以及上述三個檔案。如果沒有，請勿選取任何具有這些名稱的檔案。如果已選取其中一個，而另一個未選取，當您選取 [ 下一步] 時，會出現一則訊息，指出其中一個檔案遺失。您必須先更正再繼續。
- classes.csv
- enrollments.csv
選擇性：下列是選擇性檔案，可用來增強體驗。除非上述檔案具有以下列附註為基礎的數據參考，否則不需要。
- academicSessions.csv (如果您的 roles.csv、classes.csv 或 courses.csv 包含學術會話數據，請在處理數據時提供以避免錯誤訊息。)
- courses.csv (如果您的 classes.csv 數據包含課程的連結，提供以避免在處理數據時出現錯誤訊息。)
- demographics.csv
- userFlags.csv
- relationships.csv
當您完成選取檔案時，請選取 [下一步 ] 繼續。系統會先驗證選取檔案的名稱，再繼續下一個畫面。如果找不到必要的檔案，則會出現訊息，而且您需要尋址並重新選取檔案。
在驗證檔名之後，檔案會上傳以驗證所選檔案的結構，並根據SDS CSV v2.1規格，以標頭名稱正確格式化。
- 如果您收到訊息： 下面找到的一或多個檔案不符合預期的格式，請檢閱畫面以查看是否有任何檔案格式不正確。您必須流覽回先前的畫面，才能在修正問題之後重新選取檔案。
- 如果您收到訊息： 我們找不到一或多個選用檔案，請檢閱畫面以查看找不到哪些檔案。如果您未預期此訊息，您必須流覽回先前的畫面，才能重新選取檔案。否則，請選取 [下一步 ] 繼續。
驗證檔案架構之後，SDS 會從上傳的檔案執行快速數據驗證。上傳的數據會通過一些 SDS 數據比對和驗證規則，以協助識別良好的必要和提供的選擇性數據。這並非所有驗證規則，而是最常遇到的規則。

提示

數據驗證結果在上線或 csv 上傳體驗期間是非封鎖的，您有兩個選項：在修正數據之後結束並稍後傳回，或繼續進行下一個步驟以繼續設定您的數據連線，稍後再提供更正的數據與後續上傳。
如需已標幟要進行調查之數據的詳細資訊，請從清單中選取檔名的檢視詳細數據，以深入瞭解特定專案。

您也可以依檔案下載報表，以開始調查和來源系統中的修正。

標幟的檔案數據行會顯示，並能夠展開及調查標幟它們的規則或規則。

按兩下規則，您就可以看到前10筆記錄的另一個摘要，例如用途。

當您的調查完成時，請關閉對話框，然後選取 [ 下一步]。
選擇您目前的學年並提供易記名稱，例如 2023 或 2022 – 2023。 (字元必須是 utf8，否則會自動移除) 。

重要事項

學年是用來建立傳入數據的關聯，以協助建置年度歷程記錄數據。此方法與學年與日曆年度一致。例如，如果您的學年跨越日曆年度，從 2022/8/15 開始到 2023 年 6 月 15 日結束，則要選取的學年值就是 2023 年的結束年份。如需詳細資訊，請參閱學年處理

輸入學年開始和結束的日期。

輸入 SDS 應該根據此來源定義的學年停止同步處理數據的日期。在您剛才輸入的學年結束日期停止同步處理數據最常見。

選取 [下一步] 繼續。
選取使用者身分識別規則選項。同時為教職員和學生角色進行選擇。

注意事項

使用者比對是以輸入流程執行，而且不會寫入或更新 Microsoft Entra ID 中的用戶物件。比對會執行並儲存在EducationData Lake中。如需詳細資訊，請參閱 Microsoft 365 管理使用者，瞭解如何使用輸出流程向前寫入比對連結。
- 來源的屬性：以來自 SIS/SMS 的數據為基礎的用戶屬性。
  - 可用的來源選項為 [用戶名稱]、[Email] 和 [ActiveDirectory MatchId]。
- 要比對的屬性：要比對 Microsoft Entra ID 中的用戶屬性。
  - 可用 Microsoft Entra ID 比對選項為 UserPrincipalName 和 Mail。
- (選擇性) 如果您的用戶數據不包含 @domain 值，請從清單中選取網域。
警告

選取網域是選擇性的，而且只有在以來源中選取 的屬性 為基礎的傳入數據不包含 @domain 值時，才應該使用。如果記錄上遺漏值，SDS 不會進行檢查並附加。 SDS 會將網域選取範圍附加至所有記錄，這些記錄可能會導致@domain@domain，而且在這些實例中找不到與 Microsoft Entra ID 中使用者進行現有用戶對應的相符專案。

注意

如果 SIS/SMS 使用者，例如員工角色群組中的使用者，可以與@domain1或@domain2或@domain3您必須根據來源選取範圍中選取的屬性，在源數據中包含@domain (範例：prefix@domain) 。您的屬性必須符合下列專案：UserPrincipalName 或 Mail，才能尋找要比對的正確 Microsoft Entra 使用者。

在使用者具有多個角色的實例中，會使用下列規則來判斷用戶記錄與 Microsoft Entra 用戶對象之間應該使用哪些教職員或學生比對規則。
- 如果針對所有學生角色設定 isPrimary，即使與教職員角色的關聯存在，也會根據學生角色進行比對。
- 如果為任何教職員角色設定 isPrimary，即使與學生角色的關聯存在，也會根據教職員角色進行比對。
- 如果同時為教職員和學生角色設定 isPrimary，則會根據教職員角色進行比對。
- 如果未針對任何角色設定 isPrimary，特別是同時混用教職員和學生角色，則比對會以教職員角色為基礎。
重要事項

設定 Microsoft 365 管理使用者流程時，如果啟用 [建立不相符的使用者] 選項來定義 Microsoft Entra UserPrincipalName 屬性的建構，則會使用這些規則。

在您滿意您的選擇之後，請選取 [ 下一步 ] 繼續。
檢閱檢 閱和建立上呈現的資訊。如果一切看起來都正確，請選取 [ 建立 ] 按鈕。如果沒有，您可以巡覽回到正確。
您的輸入數據流已建立，且第一次執行擱置中，請選取 [ 完成 ] 按鈕。請回來查看您第一次執行的狀態。

提示

您可以在定義 Connect 數據組態之後、使用中第一次執行期間，或在第一次執行完成之後，立即設定管理數據組態。
若要檢查執行狀態，請流覽回 [首頁] 儀錶板頁面。

如果您的數據沒有任何問題，[首頁] 儀錶板會指出「找不到數據錯誤或警告」和「我們在上次執行期間未遇到任何數據錯誤或警告。」請繼續進行出色的工作！

如果您的數據有問題，[首頁] 儀錶板會通知「我們發現您的數據有一些問題」，並鼓勵您調查同步處理健康情況。

注意事項

若要在第一次執行之後手動上傳變更以更新源數據的變更，請參閱使用 SDS CSV 更新源數據

具有對應執行的最大上傳是每個行事曆日期的六次。如果您上傳，一天六次之後，它最多只會根據每 12 小時的 SDS 自動執行頻率執行兩次。