通过

同步运行状况和监视

  • 项目

家庭仪表板

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

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

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

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

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

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

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

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

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

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

同步运行状况

同步运行状况概述

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

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

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

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

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

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

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

报表的格式如下：

列名称 说明 示例
Rule 验证规则的表示形式 RequiredDataViolated
ExternalIdentifier 源系统中相关实体的外部/源 ID 7B2C8A0B33-F7E5-460B-993A-7257165430F7
Severity 已标记数据的严重性表示形式 验证错误、验证警告
EntityCode 与错误相关的区域的表示形式 人员、组织、注册
FriendlyMessage 基于错误和警告消息 源 [{fileName}/{apiEndPoint}] 中的 {record} 字段名称中缺少 {record} 的必需值，以创建记录。
FlowName 入站或出站流的名称 OneRoster API 入站
SourceSystemName 记录来源的源的名称 Contoso SIS
时间 处理期间标识记录的数据/时间，UTC。  2023-08-21T02：53：00Z
  • 有关数据匹配和验证规则的详细信息，请参阅 验证规则和说明。
  • 有关支持的默认值列表 的详细信息，请参阅默认值列表。
  • 具有联系人/监护人角色的用户需要 familyName、givenName 和电子邮件。
  • 应将电话和短信包含在 E.164 中，并且必须包含 + 。 (示例：+1234567890)

提示

若要在首次运行后手动上传更改以更新源数据，请参阅 使用学校数据同步手动上传 CSV。

警告

具有相应运行的最大上传次数为每个日历日六次。 之后，如果上传，则根据每 12 小时的 SDS 自动运行节奏，最多只能再运行两次。

确定修正错误的优先级

排查错误时，建议优先处理相同实体代码的大多数实例的验证错误，而不要排除任何其他错误。

验证错误可能会导致同一数据运行中的每个实例出现大量后续错误。 通常，修正这些验证错误首先会修正在验证期间找到的许多与名册相关的错误。

同步运行状况视图详细信息

同步详细信息概述

若要查看运行中的统计信息，可以选择“ 查看详细信息 ”以打开浮出控件以查看“运行详细信息”。 运行中的统计信息显示在“ 概述 ”选项卡上。

运行详细信息浮出面板的屏幕截图。

同步详细信息阶段

阶段是一种工具，用于在所选运行中继续执行活动同步运行的各个阶段时提供见解。 自动刷新作为一个阶段显示的信息已完成，另一个开始。

根据数据大小，阶段可以长时间处于“正在运行”状态。

同步运行状况数据阶段屏幕的描述。

注意

有关详细信息， 请参阅有关运行 详细信息中发现的统计信息的机构和运行统计信息。

SDS 如何确定存在的数据并设置活动状态

用户与组织的关联基于其与组织绑定的角色。

用户与类的关联基于其与注册绑定的角色。

根据连接的数据，这些规则用于确定对记录及其在数据存储中的会话状态的感知。

  • 数据反映首次显示新记录的时间。
    • SDS 将首次看到日期 (时间) 和上次修改日期 (时间设置为当前) 。
  • 当同一记录在后续运行中出现时，数据会反映。
    • SDS 保留第一次看到日期 (时间) 值，将上次修改日期 (时间) 设置为当前日期。
  • 当后续运行中不存在同一条记录时，数据会反映。
    • SDS 保留第一个看到日期 (时间) 和上次修改日期 (时间) 值。
      • 当组织、人员 (用户) 和会话记录随时间推移而保留且未停用时，会发生异常。
      • 有针对“已停用”的滚动更新。 例如，如果不存在用户记录，系统会保留现有第一次看到日期 (时间) 和上次修改日期 (时间) 值。

注意

有关数据处理的详细信息，请参阅 SDS 上的验证和数据运行状况概述。