同步健康情況和監視
首頁儀錶板
在數據處理期間，學校數據同步 (SDS) 將良好的數據帶入數據湖並標示不正確的數據來驗證數據。 在每次同步執行結束時，都會產生統計數據來協助健康情況和監視。
若要判斷數據的健康情況， 會透過數據比對和驗證規則傳遞，以協助保護只進入數據湖的良好必要和選擇性數據。 未通過驗證的數據會識別為錯誤或警告，而且不會傳送至數據湖。
如果找不到任何錯誤或警告，則執行的結果為 Completed。 主儀錶板會指出「找不到數據錯誤或警告」和「我們在上次執行期間未遇到任何數據錯誤或警告。」 請繼續進行出色的工作！
如果發現錯誤和警告，則執行的結果會是 [已完成併發生錯誤]。
- 當記錄上必要數據的值未通過數據比對和或驗證規則時，就會引發錯誤;記錄已移除且未傳送至數據湖。
如果只找到警告，則執行的結果會是 [已完成]，並出現警告。
- 當選用數據的記錄值未通過數據比對和或驗證規則時，就會引發警告;已移除值，但記錄已傳送至數據湖。
[首頁儀錶板] 會通知「我們發現您的數據有一些問題」，並鼓勵您調查同步健康情況。 如需同步執行結果的詳細資訊，請選取 [調查同步健康情況]。
同步健康情況
同步健康情況是一種工具，可協助您進一步瞭解已同步數據的健康情況，並協助進行數據調查。
數據的變更是根據最近同步執行的數據變更而發生。
同步執行是連接和管理數據組態的排序。
同步健康情況也提供過去 14 次執行的歷史表示法。
- 執行開始：整體執行開始的時間戳
- 執行結束：整體執行結束時的時間戳
- 執行狀態：所有數據流的整體狀態
- 執行中：正在執行
- 已完成：完成但沒有任何錯誤或警告
- 已完成併發生錯誤：已完成，但發現錯誤
- 已完成並出現警告：已完成，但只找到警告
- 失敗：由系統或客戶取消執行
若要調查標幟的數據，您可以選取 [下載報 表] 來擷取報表的複本。
報表的格式如下：
| 欄名稱 | 描述 | 範例 |
|---|---|---|
| 規則 | 驗證規則的表示法 | RequiredDataViolated |
| ExternalIdentifier | 來源系統中相關實體的外部/來源標識符 | 7B2C8A0B33-F7E5-460B-993A-7257165430F7 |
| 嚴重性 | 標幟數據的嚴重性表示法 | 驗證錯誤、驗證警告 |
| EntityCode | 與錯誤相關的區域表示法 | 人員、組織、註冊 |
| FriendlyMessage | 根據錯誤和警告訊息 | 在來源 [{fileName}/{apiEndPoint}] 的域名 {field} 中遺漏 {record} 的必要值，以建立記錄。 |
| FlowName | 輸入或輸出流程的名稱 | OneRoster API 輸入 |
| SourceSystemName | 記錄來源來源的名稱 | Contoso SIS |
| 年 | 學年 | 2023 |
| Time | 數據/在處理期間識別記錄的時間，UTC。 | 2023-08-21T02：53：00Z |
- 如需數據比對和驗證規則的詳細資訊，請參閱 驗證規則和描述。
- 如需支援之預設值清單的詳細資訊，請 參閱預設值清單。
- 具有聯繫人/守護者角色的使用者需要familyName、givenName和電子郵件。
- 預期電話和簡訊必須包含在 E.164 和 + 中。 (範例： +1234567890)
提示
若要在第一次執行之後手動上傳變更以更新源數據，請參閱使用 SDS v2.1 CSV 更新源數據。
警告
具有對應執行的上傳數目上限是每個行事曆日期的六次。 之後，如果您上傳，它最多只會根據每 12 小時的 SDS 自動執行頻率執行兩次。
排定補救錯誤的優先順序
針對錯誤進行疑難解答時，建議您在針對任何其他錯誤進行疑難解答之前，優先處理相同實體程序代碼中大部分實例的驗證錯誤。
驗證錯誤可能會對相同數據執行內的每個實例造成許多後續錯誤。 通常，補救這些驗證錯誤會先補救在驗證期間找到的許多名冊相關錯誤。
同步健康情況檢視詳細數據
若要查看執行中的統計數據，您可以選取 [ 檢視詳細數據 ] 以開啟飛出視窗，以查看執行詳細數據。 執行的統計數據會顯示在 [ 概觀 ] 索引標籤上。
若要進一步瞭解可能引發錯誤和警告的階段，請選取 [ 階段] 索 引標籤。資訊會分成下列階段，視已啟用的管理數據組態而定。
機構數據
Microsoft 365 使用者
Microsoft 365 群組
Microsoft IT 群組
最新狀態
- 已完成：完成但沒有任何錯誤或警告
- 已完成併發生錯誤：已完成，但發現錯誤
- 已完成並出現警告：已完成，但只找到警告
- 失敗：由系統或客戶取消執行
注意事項
如需詳細資訊， 請參閱 執行詳細數據上找到的統計數據的機構和執行統計數據。
SDS 如何判斷數據是否存在並設定作用中狀態
注意事項
如需學年設定的詳細資訊，請參閱 學年處理
使用者與會話的關聯 (例如，學年) 是以其與組織系結的角色為基礎。
用戶與類別的關聯是以其與註冊系結的角色為基礎，其中也包含會話的連結。
根據連線的數據，這些規則可用來判斷記錄的認知及其在數據存放區中的會話狀態。
- 數據會反映第一次顯示新記錄的時間。
- SDS 會將第一個看見的日期 (時間) 和上次修改日期 (時間) 為目前，如果適當，則會將記錄標示為「在會話中為作用中」為 true。
- 數據會在後續執行中出現相同的記錄時反映。
- SDS 會保留第一個看見的日期 (時間) 值、將上次修改的日期 (時間) 設為目前，並將「在會話中為作用中」保持為 true。
- 數據會在後續執行中沒有相同的記錄時反映。
- SDS 會保留第一個看見的日期 (時間) 和上次修改的日期 (時間) 值，如果適當的話，將記錄標示為「在會話中作用中」為 false。
- 當組織、使用者 (使用者) 和會話記錄持續存在且未啟用時，就會發生例外狀況。
- 有「已啟用」的滾動更新。 例如，如果用戶記錄不存在，系統會保留現有的第一個看見日期 (時間) 和上次修改日期 (時間) 值。 系統會將用戶的組織/角色和註冊記錄的「在會話中為作用中」設定為 false。
- SDS 會保留第一個看見的日期 (時間) 和上次修改的日期 (時間) 值，如果適當的話，將記錄標示為「在會話中作用中」為 false。
注意事項
如需數據處理的詳細資訊，請參閱 SDS 上的驗證、儲存和數據健康 情況概觀。