验证规则和说明
按数据类型列出的匹配和验证规则
| 数据类型 | 匹配规则 | 验证规则 | 存储的值 |
|---|---|---|---|
| 唯一 ID * | 区分大小写 | 已收到 | |
| 枚举** | 不区分大小写 | 匹配为小写 | As camelCase |
| String | 区分大小写 | 已收到 | |
| 电子邮件 | 小写 | RFC 5532 (3.4.1) | 小写 |
| 日期或日期时间 | ISO8601 | ISO8601 | ISO8601 |
| Phone | E.164 | E.164 | 已收到 |
| 布尔值 | 不区分大小写 | 匹配为“true”或“false” | 小写 |
*该记录在所有记录中都是唯一的。 全局唯一标识符，但它可能采用也可能不采用通用唯一标识符的形式， (UUID) 。
** 年级级别 ENUM 的传入值上缺少前导零“0”，例如“1”，将与定义的值列表 (ENUM) “01”匹配，并将存储为“01”。
** 有关默认 ENUM 值的详细信息， 请参阅值的默认列表。
应根据 E.164 标准设置电话和短信字段的格式，其中加号字符由电话号码使用并成功，或者更确切地说，加号字符后跟国家/地区代码、区号、电话前缀和行号。 (示例：+1234567890)
规则和说明
| 规则名称 | 规则说明 | 状态 | 规则操作 | 友好消息示例 | 从 (源或写入到Microsoft Entra ID) |
|---|---|---|---|---|---|
| 内部应用程序错误 | 发生意外错误。 | 灾难性错误 | 停止数据运行 | 尝试处理时出现应用程序错误： {error} | 连接数据 & 管理数据 |
| 找不到文件 | 找不到所需的文件。 | 灾难性错误 | 停止数据运行 | 在路径 {Path} 中找不到 {expectedFileName}。 请检查 {Name} 的路径，以确保存在 {expectedFileName} 或文件名为 {expectedFileName} 并重新运行同步。 | 连接数据 |
| 操作已取消 | 数据运行期间出现需要取消数据的问题。 | 灾难性错误 | 停止数据运行 | 操作已取消，并显示以下消息：{cancelMessage} | 连接数据 |
| 标头不存在 | 确保发送格式正确的文件进行处理，其中包含定义的文件头。 | 灾难性错误 | 停止数据运行 | 在 {fileName} 中找不到 {expectedHeaderName}。 请更正提取以添加或确保其读取为 {expectedHeaderName}。 上传更正的文件并重新运行同步。 | 连接数据 |
| 标头中的重复列 | 若要确保发送格式正确的文件进行处理，该文件包含定义的文件头而不是同一标头的多个 () 。 | 灾难性错误 | 停止数据运行 | 在 {fileName} 中发现了两个或更多 {expectedHeaderName}。 请更正提取、上传更正的文件，然后重新运行同步。 | 连接数据 |
| 无效的文件格式 | 当压缩文件中存在不支持的文件或文件夹时， (zip) 。 | 灾难性错误 | 停止数据运行 | 存档验证失败。 存档 {archiveName} 中找到不支持的文件 {fileInArchive}。 | 连接数据 |
| 找到重复文件 | 当存档包含也在存档外部上传的文件时。 示例：上传 users.csv 和 users.zip，users.zip 还包含 users.csv。 | 灾难性错误 | 停止数据运行 | 存档验证失败。 在存档 {archiveName} 和存档外部找到的重复 {fileInArchive}。 | 连接数据 |
| 找到重复文件 | 在多个存档中找到重复文件时。 示例：上传 users.zip 和 relationship.zip，relationship.zip 还包含 users.csv。 | 灾难性错误 | 停止数据运行 | 存档验证失败。 在存档 {archiveName1}、 {archiveName2} 中找到重复的 {fileInArchive}。 | 连接数据 |
| 找不到交叉引用映射 | 验证是否在提供的关联数据中找到链接数据 (示例：用户缺少组织，注册) 缺少部分。 | 错误 | 从发布中删除记录 | 无法从源 [{fileName}/{apiEndPoint} 找到 {record} 的 {entityType} 记录。 确认 {entityType} sourcedId 和 {record} sourcedId 正确或更新源系统中的数据并重新运行同步。 | 连接数据 & 管理数据 |
| 找不到可选交叉引用映射 | 验证是否在提供的关联数据中找到链接数据 (示例：用户缺少组织，注册) 缺少部分。 | 警告 | 删除记录中的值，发送用于过帐的记录 | 在 {entityType} 的 {field} 字段 {value} 中找到无效的可选引用值 {value}，并且该值已从记录中删除以继续处理。 确认 {entityType} sourcedId 和 {record} sourcedId 正确或更新源系统中的数据并重新运行同步。 | 连接数据 |
| 日期时间格式错误 | 若要确保传递的数据值具有正确的格式 (ISO8601) 。 | 错误 | 从发布中删除记录 | 来自源 [{fileName}/{apiEndPoint}] 的 {field} 中的 {record} 的日期的格式不正确：“YYYYY-MM-DD”。 | 连接数据 & 管理数据 |
| 缺少必需数据 | 检测记录的必填字段中的缺失值。 | 错误 | 从发布中删除记录 | 源 [{fileName}/{apiEndPoint}] 中的 {record} 字段名称中缺少 {record} 的必需值，以创建记录。 | 连接数据 & 管理数据 |
| 格式值错误 | 若要确保字段中传递的数据与定义的格式匹配。 另请参阅按数据类型列出的匹配和验证规则。 | 错误 | 从发布中删除记录 | 在源 [{fileName}/{apiEndPoint}] 的 {field} 中找到的 {record} 没有正确设置 {field} 格式的值。 | 连接数据 & 管理数据 |
| 分析错误 | 为了确保每条记录都能关联正确的列中的数据。 记录可能由于单个逗号、找到回车符或缺少引号而被标记。 | 错误 | 从发布中删除记录 | 无法分析源 [{fileName}/{apiEndPoint}] 中的 [if api： {apiEndpoint}] 以查找列中的数据。 确保文件中的分隔符是单个逗号 (，) 和字段中的回车符是不允许的。 包含逗号和双引号的字段必须用双引号引起来。 如果使用双引号将字段括起来，则必须通过在字段前面加上另一个双引号来转义出现在该字段中的双引号。 | 连接数据 |
| 违反最大字段长度约束 | 确保传递的数据不会超过字段长度，从而导致缺少数据。 | 错误 | 从发布中删除记录 | {record} 中为 {field} 提供的值超出了支持的最大 {length} 字符长度。 | 连接数据 |
| 引用代码无效或缺失 | 标识是否找不到为记录传递的必需字段的引用值 [Enum] 以将记录关联到 。 | 错误 | 从发布中删除记录 | {record} 中 {field} 的值 {refValue} 在 {refCodeEntity} 中找不到。 请更正源系统。 | 连接数据 |
| 无效的可选引用代码 | 标识是否找不到为记录传递的可选字段的引用值 [Enum] 来关联记录。 | 警告 | 删除记录中的值，发送用于过帐的记录 | {record} 中 {field} 的值 {refValue} 在 {refCodeEntity} 中找不到。 请更正源系统。 | 连接数据 |
| 缺少相应必需值的可选数据 | 确保如果记录为可选数据传递值，则还会提供现在需要值也存在的任何其他关联数据。 | 警告 | 删除记录中的值，发送用于过帐的记录 | 在 {record} 的可选字段中提供了一个值，但在关联字段中缺少相应的值，以成功发布数据。 | 连接数据 |
| 循环引用 | 确保如果记录具有父级关联，则未提供循环引用。 | 警告 | 删除记录中的值，发送用于过帐的记录 | {entityType}{entityId} 在循环引用中与 {entityType} () {entityList} 链接。 {entityParentIdField} 的值将从记录中删除以继续处理。 | 连接数据 |
| 找不到用户映射标识符 | 确保根据配置的用户标识规则存在值。 | 错误 | 从发布中删除了记录 | 找不到用户 {record} 的用户映射标识符 {identifierType}。 | 连接数据 |
| 用户映射已找到多个匹配项 | 如果发现多个Microsoft Entra帐户与此用户匹配，则只会使用第一个 AAD 帐户进行匹配。 将删除其他匹配项。 | 错误 | 从发布中删除辅助记录 | 具有映射标识符 {identifierType}={value} 的用户 {record} 在 Microsoft Entra ID 中发现了多个匹配项。 仅使用找到的第一个匹配项，请参阅 Microsoft Entra ObjectId {AadObjectId}。 | 连接数据 |
| 找到的用户映射冲突匹配项 | 防止将其他用户自动关联到现有和匹配Microsoft Entra帐户。 | 错误 | 从发布中删除记录 | 映射标识符为 {identifierType}={value} 的用户 {record} 与现有的映射Microsoft Entra ObjectId {AadObjectId} 匹配。 将使用找到的现有匹配项，并且将跳过此匹配项。 | 连接数据 |
| 找不到用户匹配Microsoft Entra ID | 通知提供的用户记录无法根据配置的用户/标识匹配规则找到与Microsoft Entra用户的匹配项。 | 警告 | 记录与Microsoft Entra ID不匹配 | 映射标识符为 {identifierType}={value} 的用户 {record} 与任何Microsoft Entra用户不匹配。 这可能是源系统中提供的值根据配置的用户标识规则不正确，或者 Azure Active Directory Sync 在最新运行之前尚未添加用户。 | 连接数据 |
| 缺少用户关联 | 通知用户记录已提供，但未作为学生或教职员工角色关联到组织或学生联系人角色。 | 警告 | 从发布中删除记录 | 源 [{fileName}/{apiEndPoint}] 中的用户 {record} 缺少组织 & 角色关联数据或联系人关系关联数据。 如果这是有效的用户，请更新源数据，以提供适当的组织 & 角色或联系人关系关联。 | 连接数据 |
| 未指定主角色 | 通知为用户提供了多个角色记录，但其中一条未标记为“主要角色”。 | 警告 | 记录已添加为接收 | 用户 {record} 的源 [{fileName}/{apiEndPoint}] 中发现了多个角色记录，但未将其中一个角色表示为同一组织的主要角色。 建议从源中将此用户的角色之一指定为主要角色 | 连接数据 |
| 指定了多个主要角色 | 通知提供了多个角色记录，多个角色记录标记为“主要角色” | 警告 | 记录已添加为接收 | 用户 {record} 的源 [{fileName}/{apiEndPoint}] 中发现了多个角色记录，并将其定义为同一组织的主要角色。 建议将此用户的角色之一指定为源中的主角色。 | 连接数据 |
| 用户角色缺失角色组关联 | 标识用户已获得有效角色，但角色未关联到角色组，因此不确定应使用哪些匹配规则。 | 错误 | 从发布中删除记录 | 源 [{fileName}/{apiEndPoint}] 中的用户 {record} 与有效角色 {value} 相关联，但该角色未关联到角色组。 需要更新值列表，将 {value} 关联到角色组。 | 连接数据 |
| 常规 Post 数据错误 | 提交记录时返回错误。 | 错误 | 从发布中删除记录 | 由于 {error}，无法添加 {record}。 请检查或更新源系统进行更正。 | 连接数据 |
| UPN 格式错误 | 通知使用或生成的用户主体名称的格式不正确，以满足Microsoft Entra要求。 | 错误 | 记录未发布到Microsoft Entra ID | 用户记录{record} 没有格式正确的用户主体名称{value}，无法在 Microsoft Entra ID 中创建用户对象。 请根据为“用户名”配置选择的字段，更正源系统中此用户记录的数据。 | 管理数据 |
| Microsoft Entra无效的属性值 | 通知存在无效字符，为什么尝试写入Microsoft Entra ID | 错误 | 记录未发布到Microsoft Entra ID | 由于一个或多个无效属性，无法在 Active Directory 中创建或更新 {record}。 检查 {field} 中 {record} 的值，确保它们仅包含字母数字字符，没有空格且少于 256 个字符。 请更正源系统中的数据或激活 {FlowName} 中替换特殊字符的设置。 | 管理数据 |
| 缺少依赖许可证 | 通知尚未将从属许可证分配给记录。 | 错误 | 记录未发布到Microsoft Entra ID | 从属许可证当前未分配给 {record}。 例如 - Classroom 许可证要求 {record} 必须已具有 Exchange Online 和 SharePoint Online 的许可证。 通过分配依赖许可证并重新运行同步来解决此问题。 | 管理数据 |
| 无可用许可证 | 通知没有要分配给用户的许可证。 | 错误 | 记录未获得许可 | 未能将许可证分配给 {record}。 许可证已过期或用尽 (此类型的所有可用许可证已分配) 。 通过添加 {licenseType} 的更多许可证并重新运行同步进行修正。 | 管理数据 |
| 无法删除组的最后一个所有者 | 通知现有已同步团队课堂组没有所有者记录。 | 错误 | 未从Microsoft Entra ID中删除记录 | 无法从 {teamsType} 中删除 {record}，因为 {teamsType} 必须至少有一个所有者。 请在源系统中检查或更新数据，或检查筛选器选择，以确保至少分配了一个所有者。 | 管理数据 |
| 已超出资源大小 | 通知记录包含过多的“组织”关联。 | 错误 | 记录未发布到Microsoft Entra ID | {record} 被分配到太多学校， (超过 30) 。 请从不再需要的学校中删除 {record} 的成员身份。 | 管理数据 |
| 重复的目标条目 | 通知Microsoft Entra ID中存在具有相同 sourceId 的两条或更多条记录。 | 错误 | 记录未发布到Microsoft Entra ID | Active Directory 中存在两条或更多条记录，其中 {record} 的 sourcedId 相同。 请识别并删除不正确的标识。 | 管理数据 |
| 找不到Microsoft Entra匹配项 | 通知无法将链接从源添加到Microsoft Entra ID，因为Microsoft Entra ID中找不到目标。 | 错误 | 未链接到Microsoft Entra ID的记录 | {record} 无法更新，因为 Active Directory 中找不到匹配项。 验证入站流的标识匹配条件。 | 管理数据 |
| 找到现有对象 | 通知已在 Microsoft Entra ID 中找到同一 sourceId 的链接。 | 错误 | 记录未发布到Microsoft Entra ID | {entityType} 的 {record} 在过去已使用相同的 sourcedId 创建。 请停用或删除旧的 {entityType}。 | 管理数据 |
| 无效的主体名称格式 | 通知无法添加链接，因为正在生成的用户主体名称上发现了意外格式。 | 错误 | 未链接到Microsoft Entra ID的记录 | {record} 无法更新，因为 Active Directory 中找不到匹配项。 用户主体名称的格式意外。 | 管理数据 |
| 无法同步本地拥有的对象 | 通知租户正在使用从本地到其 Microsoft 365 租户的 Azure Active Directory 同步，不会从源数据更新 AAD 中用户值的更改。 | 错误 | 记录未发布到Microsoft Entra ID | 无法更新从本地 Active Directory 同步的 {record} 的属性 (，例如：名字) 。 请先在本地 Active Directory 中进行更改。 | 管理数据 |
| 重复的安全组 ID | 通知租户删除Microsoft Entra ID中不允许且无法创建其他安全组的特殊字符后生成了重复的安全组 ID。 | 错误 | 记录未发布到Microsoft Entra ID | 删除组织 sourcedId：{identifierValue} 的特殊字符后，多个安全组具有重复的标识符值 {identifierSource}。 | 管理数据 |