同步运行状况和监视

  • 项目

家庭仪表板

在数据处理期间，学校数据同步 (SDS) 通过向数据湖引入良好数据并标记不良数据来验证数据。 每次同步运行结束时，都会生成统计信息，以帮助进行运行状况和监视。

为了确定数据的运行状况，通过数据匹配和验证规则传递，以帮助保护仅进入数据湖的良好必需和可选数据。 未通过验证的数据被标识为错误或警告，并且不会发送到数据湖。

如果未找到错误或警告，则运行结果为 “已完成”。 主仪表板将指出“未找到数据错误或警告”和“在上次运行期间，我们没有遇到任何数据错误或警告。 继续伟大的工作！

无错误或警告横幅的屏幕截图。

如果发现错误和警告，则运行结果为 “已完成”，但出现错误。

  • 当所需数据的记录上的值未通过数据匹配和或验证规则时，将引发错误;记录已删除，未发送到数据湖。

如果只找到警告，则运行结果为 “已完成”，并显示警告。

  • 当可选数据的记录上的值未通过数据匹配和或验证规则时，将引发警告;已删除 值，但记录已发送到数据湖。

主页仪表板通知“我们发现你的数据存在一些问题”，并鼓励你调查同步运行状况。 有关同步运行结果的详细信息，请选择“ 调查同步运行状况”。

所发现问题横幅的屏幕截图。

同步运行状况

同步运行状况是一种工具，可帮助你更好地了解已同步数据的运行状况，并帮助进行数据调查。

数据更改基于最近同步运行中的数据更改。

同步运行是连接和管理数据配置的排序。

运行运行状况屏幕的屏幕截图。

同步运行状况还提供过去 14 次运行的历史表示形式。

  • 运行开始时间：整体运行启动时的时间戳
  • 运行结束时间：整体运行结束时的时间戳
  • 运行状态：所有数据流的总体状态
    • 正在运行：主动执行
    • 已完成：已完成，没有任何错误或警告
    • 已完成并出现错误：已完成但已发现错误
    • 已完成并显示警告：已完成，但只发现了警告
    • 失败：由系统或客户取消运行

若要调查已标记的数据，可以选择“ 下载报表 ”以检索报表的副本。

报表的格式如下：

列名称 说明 示例
Rule 验证规则的表示形式 RequiredDataViolated
ExternalIdentifier 源系统中相关实体的外部/源 ID 7B2C8A0B33-F7E5-460B-993A-7257165430F7
Severity 已标记数据的严重性表示形式 验证错误、验证警告
EntityCode 与错误相关的区域的表示形式 人员、组织、注册
FriendlyMessage 基于错误和警告消息 源 [{fileName}/{apiEndPoint}] 中的 {record} 字段名称中缺少 {record} 的必需值，以创建记录。
FlowName 入站或出站流的名称 OneRoster API 入站
SourceSystemName 记录来源的源的名称 Contoso SIS
年份 学年 2023
时间 处理期间标识记录的数据/时间，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 上的验证、存储和数据运行状况概述。