將資料連線至學校資料同步

重要事項

透過與學校資料同步處理 (SDS) 連線並提供機構資料，即表示您確認您有權與Microsoft共用此資料，並承諾遵守貴組織的資料控管標準。

設定適用於 Microsoft 365 教育版租用戶的 SDS

  • Microsoft 365 教育版租用戶
  • 需要全域系統管理員權限
  • 存取 SDS 的全域系統管理員需要 SDS 方案 1 (A1) 或 SDS 方案 2 (A3 / A5) 授權

SDS 存取和首次登入

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

  • 選取 [開始使用]。

    顯示歡迎訊息的螢幕擷取畫面。

  • 選取 [繼續]。

    顯示 SDS 概觀的螢幕擷取畫面。

    在下一個步驟之前，請稍等片刻讓服務佈建到租用戶。

    螢幕擷取畫面顯示等待服務佈建完成時擱置中。

  • 選取 來源格式。 如需透過 SDS v2.1 CSV 或 SDS v1 CSV 提供的資料，請選取 CSV。 如需透過 OneRoster API 提供的資料，請選取 API。 做出選擇之後，選取 [下一步]。

    顯示 csv 或 API 格式提示的螢幕擷取畫面。

  • 提供連線資料的名稱 學生資訊系統 (SIS) 或學生管理系統 (簡訊) 。 包含可協助區分不同來源間連線資料的資訊，以用於管理和疑難排解之目的。 針對格式版本，選取 [SDS v2.1 CSV]。 選取 [下一步] 繼續。

    顯示名稱和 v2.1 csv 格式提示的螢幕擷取畫面。

  • 選取 [瀏覽裝置 ] 以顯示 [瀏覽和選取項目] 對話方塊。

    注意事項

    在建立連線資料設定期間進行初始上傳之後，無論您是否在選用檔案中進行資料變更，您都需要始終為後續上傳提供同一組檔案。 否則，系統會判斷記錄已不再為作用中，並標示為非作用中。

    選取提示以瀏覽 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

    瀏覽至檔案位置並選取 v2.1 csv 檔案的螢幕擷取畫面。

  • 完成選取檔案時，請選取 [ 下一步 ] 以繼續。 系統會在繼續下一個畫面之前驗證所選檔案的名稱。 如果找不到必要的檔案，會出現一則訊息，您需要定址並重新選取該檔案或檔案。

    顯示驗證 v2.1 csv 檔案名稱的螢幕擷取畫面。

  • 驗證檔案名稱之後，將會上傳檔案以驗證所選檔案的結構，並根據 SDS CSV v2.1 規格使用標頭名稱正確格式化。

    • 如果您收到此訊息： 找到的一或多個檔案不符合預期的格式。 檢視畫面以查看是否有任何檔案格式不正確。 在修正問題之後，您必須瀏覽回先前的畫面以重新選取檔案。

    • 如果您收到此訊息： 我們找不到一或多個選用檔案。 檢視畫面以查看找不到哪個檔案或檔案。 如果您沒有預料到此訊息，您必須瀏覽回先前的畫面以重新選取檔案。 否則，請選取 [下一步 ] 以繼續。

    v2.1 檔案上傳和驗證檔案標頭的螢幕擷取畫面。

  • 驗證檔案結構描述之後，SDS 會從上傳的檔案執行快速資料驗證。 上傳的資料會通過一些 SDS 資料比對和驗證規則，以協助識別良好的必要和提供的選擇性資料。 這不是所有的驗證規則，而是最常遇到的規則。

    提示

    資料驗證結果不會封鎖 在上線或 CSV 上傳體驗期間，您有兩個選項：退出並在修正資料後稍後返回，或繼續進行下一個步驟以繼續設定資料連線，稍後為後續上傳提供更正的資料。

    透過資料驗證處理 v2.1 檔案的螢幕擷取畫面。

    透過資料驗證處理的 v2.1 檔案螢幕擷取畫面。

  • 如需已標幟為調查的資料之詳細資訊，請從清單中選取檔案名稱的詳細資料，以深入了解特定項目。

    您可以按檔案下載報告，以領先一步在來源系統中進行調查和修復。

    已標幟的檔案欄會顯示，並能夠展開並調查標幟它們的規則。

    已選取 v2.1 csv 檔案的螢幕擷取畫面以檢視詳細資料。

    例如，透過按一下規則，您可以查看前 10 筆記錄的另一項摘要。

    已選取 v2.1 檔案以檢視選取規則詳細資料的螢幕擷取畫面。

    調查完成後，請關閉對話方塊，然後選取 [ 下一步]。

  • 選取使用者身分識別規則選項。 為教職員和學生角色進行選取。 如果您的教職員和學生規則不同，請選取分割選項以定義唯一規則。 對您的選取項目感到滿意後，請選取 [下一步 ] 以繼續。

    注意事項

    使用者比對是在資料擷取期間執行，不會寫入或更新 Microsoft Entra ID 中的使用者物件。 比對會執行並儲存在 SDS 資料湖中。 如需詳細資訊，請參閱在將資料管理至 Microsoft 365 時，以撰寫比對連結轉寄的資料，Microsoft 365 使用者佈建類型 。

    • 來源屬性：根據來自 SIS/簡訊的資料的使用者屬性。
      • 可用的來源選項包括 Username、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 屬性的建構。

    顯示 [使用者身分識別規則] 提示的螢幕擷取畫面。

  • 輸入 SDS 應阻止從已連線資料來源同步更新資料的日期。 通常會在學年結束時停止同步資料。 最多為從同步開始日期起 18 個月。

    顯示同步結束日期提示的螢幕擷取畫面。

  • 檢閱所顯示的資訊。 如果一切正常，請選取 [連接資料 ] 按鈕。 如果沒有，您可以瀏覽回更正。

    檢閱的螢幕擷取畫面。

    處理的螢幕擷取畫面。

  • 您的連線資料組態已建立，且第一次執行擱置中，請選取 [完成] 按鈕。

    已建立來源的連線資料設定螢幕擷取畫面。

    提示

    您可以在定義 Connect 資料組態後立即設定管理 資料組態 、在作用中的第一次執行期間，或稍後在第一次執行完成之後設定。

    顯示 [首頁儀表板] 和管理資料動作的螢幕擷取畫面。

  • 若要檢查同步執行的狀態，請瀏覽回 [首頁儀表板] 頁面。

    如果您的資料沒有問題，[首頁] 儀表板會指出， 找不到任何資料錯誤或警告。 以及 在您上次執行期間，我們未遇到任何資料錯誤或警告。繼續努力！

    如果您的資料有問題，[首頁儀表板] 會通知您 我們發現您的資料有一些問題。 並鼓勵您調查 同步健康情況。

    提示

    若要在初始 CSV 上傳後提供資料更新，請參閱 手動 SDS CSV 上傳。

    提示

    您可以使用 Power Automate 將 CSV 上傳自動化。 如需詳細資訊，請參閱 自動化 SDS CSV 上傳。

編輯 Connect 資料設定

  • 從 [首頁儀表板]，使用左側導覽前往 同步 |設定。

重要事項

不論 SDS v1 CSV 或 v2.1 CSV 格式為何，下列步驟都是相同的。

顯示 csv 同步設定的螢幕擷取畫面。

  • 在 [已連線的資料] 索引標籤上，選取 [ 編輯已設定來源的來源詳細資料 ]。

    提示

    若要在初始 CSV 上傳後提供資料更新，請參閱 手動 CSV 上傳。

  • 檢閱使用者身分識別規則選項。

    注意事項

    使用者比對是在資料擷取期間執行，不會寫入或更新 Microsoft Entra ID 中的使用者物件。 比對會執行並儲存在 SDS 資料湖中。 如需詳細資訊，請參閱在將資料管理至 Microsoft 365 時，以撰寫比對連結轉寄的資料，Microsoft 365 使用者佈建類型 。

    • 來源屬性：根據來自 SIS/簡訊的資料的使用者屬性。
      • 可用的來源選項包括 Username、Email 和 ActiveDirectory MatchId。
    • 要符合的屬性： 要比對的 Microsoft Entra ID 中的使用者屬性。
      • 可用的 Microsoft Entra ID 比對選項為 UserPrincipalName 和 Mail。

    若要 讓您的屬性符合： UserPrincipalName 或 Mail，範例 - prefix@domain，來源資料中必須包含 @domain 。

    在使用者具有多個角色的情況下，會使用下列規則來判斷在使用者記錄與 Microsoft Entra 使用者物件之間應使用哪些教職員或學生比對規則。

    • 如果為所有學生角色設定了 isPrimary，即使與教職員角色存在關聯，也會根據學生角色進行比對。

    • 如果為任何教職員角色設定了 isPrimary，即使與學生角色有關聯，也會根據教職員角色進行比對。

    • 如果同時為教職員和學生角色設定了 isPrimary，則會根據教職員角色進行比對。

    • 如果未針對任何角色設定 isPrimary，特別是混合了教職員和學生角色，則比對會以教職員角色為基礎。

    重要事項

    將 [管理資料] 設定為 Microsoft 365 使用者 provisingin 類型時，如果已啟用「建立不相符使用者」選項，則會使用這些規則，以定義 Microsoft Entra UserPrincipalName 屬性的建構。

    選取 [下一步] 繼續。

    顯示 [編輯使用者身分識別規則提示] 的螢幕擷取畫面。

  • 檢閱 SDS 應阻止從已連線資料來源同步更新資料的日期。 通常會在學年結束時停止同步資料。 最多為從同步開始日期起 18 個月。

    螢幕擷取畫面顯示 [編輯同步結束日期提示]。

  • 檢閱所呈現的資訊。 如果一切正常，請選取 [提交 ] 按鈕。 如果沒有，您可以巡覽回更正。

    編輯檢閱的螢幕擷取畫面。

    編輯處理的螢幕擷取畫面。

  • 您的連線資料組態已更新，請選取 [關閉 ] 按鈕。

    來源的連線資料設定已更新的螢幕擷取畫面。

  • 上次更新時間：