如何修复导入数据时的验证错误和警告

使用 Microsoft 365 组织数据服务导入数据时,可能会遇到错误消息或警告,具体取决于设置的连接类型。 在某些情况下,需要先更正错误,然后才能继续。 在其他情况下,无需执行任何操作。 以下是这些消息的列表、它们的含义以及您可以采取哪些步骤来解决它们(如果需要)。

引入状态消息

邮件 操作
“数据处理” 无需执行任何操作。
“验证完成 – 查看详细信息” 无需执行任何操作。
“部分成功 – 查看详细信息” 未导入上传中的某些行数据。 已验证没有问题的数据行。

数据可能无法导入,因为 “Microsoft_PersonEmail” 列具有空白行,或者组织数据与数据类型不匹配。

选择 “查看详细信息 ”以下载导入日志,以便在下次导入之前查看并更正任何问题。

部分成功状态仅适用于基于 API 的连接器、Workday 连接器和 SAP SuccessFactors 连接器。
“保留验证 - 查看详细信息” 这是临时 API 错误导致的,应在几分钟内自行解决。 无需执行任何操作。
“验证失败 – 查看详细信息” 验证数据时出错。 多种类型的数据或映射问题都可能触发它。

选择 “查看详细信息 ”以下载导入日志,以便在下次导入之前查看并更正任何问题。

可能触发验证失败的常见问题:

1. 检查“Microsoft_PersonEmail”列下的空白行。 每行必须包含有效的非空值。

2. 确认包含每个选定应用程序的所有必需属性。 如果应用需要属性,则必须存在并映射属性。 缺少属性可能会导致验证立即失败。

3. 查找空白或空数据行。 没有值的行可能会阻止验证。 删除或完成文件中的任何空行。

4. 确认未将数据发送到未获得许可的应用。 如果该文件包含组织无法访问的应用程序的数据,则验证将失败。 删除或更正旨在用于没有许可证的应用的数据。

5. 检查文件中包含但任何选定应用程序均不支持的自定义属性。 如果文件包含自定义属性,但要向其发送数据的 App 不支持自定义属性,则验证将失败。 移除不受支持的自定义属性,或仅将数据发送到支持自定义属性的应用。

6. 确保没有属性名称与“Microsoft_ 保留”名称冲突。
“已暂停 - 查看详细信息” 状态挂起消息可能有几个原因:

1. 导入过程中可能出现问题。 这不是用户错误。 对于手动 .csv 导入、基于 API 的连接器或 Azure Blob 存储 连接器,请等待一天,然后再次尝试导入。 对于 Workday 和 SAP SuccessFactors 连接器,可能会在下次计划导入时修复此问题。

2. 系统可能不可用。 在此时间内运行的任何导入进程都将暂停。 对于手动 .csv 导入、基于 API 的连接器或 Azure Blob 存储 连接器,请等待一天,然后再次尝试导入。 对于 Workday 和 SAP SuccessFactors 连接器,可能会在下次计划导入时修复此问题。
“已取消 – 查看详细信息” 发生这种情况可能是因为系统自动终止了运行,可能是由于超时或配置更改。 取消的摄取 并不表示存在 数据或文件问题。

无需执行任何操作。 但是,你可以:

1. 选择 “查看详细信息 ”以查看验证报告是否可用。

2. 如果无意中取消了引入,可以根据连接器类型开始新的导入。 对于手动 .csv 导入、基于 API 的连接器或 Azure Blob 存储 连接器,可以重试导入。 对于 Workday 和 SAP SuccessFactors 连接器,无需手动触发任何操作。 连接器按照已建立的刷新计划自动拉取数据。

设置手动 .csv 导入时可能显示的消息

邮件 操作
“CSV 文件为空。 请上传其他 CSV 文件。” 使用组织数据填充提供的 .csv 模板或你自己的模板,并将其上传。
“此文件不完整。 请上传一个包含标题和数据的 CSV 文件,然后重试。” 打开 .csv 文件,检查它是否同时包含标题行和至少一行数据。 两者都是映射和导入数据所必需的。 更新文件以包含缺少的任何内容,然后再次上传文件。
“此文件包含重复的标头名称。 请删除重复项,然后重试。” 打开 .csv 文件并查看标题行。 查找多次出现的任何列,例如名为“Microsoft_PersonEmail”的两列。重命名或删除重复列名,保存文件,然后再次上传。
“此文件太大。 请上传小于 25MB 的文件。” 尝试本地导入时会出现此消息。

检查 .csv 文件的大小。 如果数据大于 2 GB,请尝试将数据拆分为多个较小的文件。 这需要多次上传,但允许您引入所有所需的数据。 还可以尝试删除不必要的属性。

保存较小的文件,然后重新上传。
“此文件太大。 请上传小于 2GB 的文件。” 尝试从 SharePoint 上传时会出现此消息。

检查 .csv 文件的大小。 如果数据大于 25 MB,请尝试将数据拆分为多个较小的文件。 这需要多次上传,但允许您引入所有所需的数据。 还可以尝试删除不必要的属性。

保存较小的文件,然后重新上传。
“此文件包含以”Microsoft“开头但不能识别为保留属性的标头。 只有保留属性可以使用“Microsoft”作为前缀。 请重命名或删除这些属性,然后再次上传文件。” 有一组已定义的保留属性,可以使用“Microsoft_”前缀。 在 此处查看完整列表。

文件包含使用此前缀但不在此保留列表中的列标题。

打开 .csv 文件并找到以“Microsoft_”开头的任何标头。如果这些是自定义属性,请重命名它们以删除 Microsoft 前缀。 如果列旨在引用保留属性,请将其更新为匹配官方列表中的确切名称。 保存更新的文件并再次上传。
“只能导入 CSV 文件。” 验证所使用的文件类型和 SharePoint URL:

1. 确认该文件实际上是一个 .csv 文件。 打开文件以确保它保存为 .csv 文件,而不是 .xlsx、.txt 或 .zip 等其他格式。

2. 确认正在使用正确的文件路径。 即使 SharePoint 中存在正确的 .csv 文件,使用错误的 URL (如共享链接而不是文件路径) 也会导致错误。 请按照 此处 所述的步骤生成正确的路径。

验证文件类型和 URL 后,使用正确的 .csv 文件和文件路径重试上传。
“缺少一些必需的属性。

尚未映射要向其发送数据的应用程序所需的某些属性。 如果所需的映射未完成,上传到这些应用可能会失败。”
每个应用和服务都有自己的一组必需属性。 确保映射完整:

1. 检查要向其发送数据的应用程序的必需属性列表。 这些属性都必须映射。

2. 将所需属性与 .csv 文件中包含相应数据的列映射。

如果 .csv 文件不包含相应的属性,请更新文件以包含所需属性所需的数据。

如果您不想添加缺少的属性映射,请从目标列表中删除该应用程序。 否则,上传可能会失败。
“你的一个或多个数据访问选择缺少必需的映射属性,这可能导致导入到这些应用失败。 映射缺失的属性或删除对相关应用的访问权限,以防止出现此错误。” 每个应用和服务都有自己的一组必需属性。 确保映射完整:

1. 转到 “映射属性” 页。

2. 检查要向其发送数据的应用程序的必需属性列表。 这些属性都必须映射。

3. 将所需属性与 .csv 文件中包含相应数据的列映射。

如果 .csv 文件不包含相应的属性,请更新文件以包含所需属性所需的数据。

如果您不想添加缺少的属性映射,请从目标列表中删除该应用程序。 否则,上传可能会失败。
“一些导入的属性需要注意。 当未映射的属性将成为应用不支持的自定义属性时,或者当文件包含与保留名称冲突的属性名称时,可能会发生这种情况。 下载错误日志以查看特定问题,然后映射或删除受影响的属性并上传新文件。 详细了解如何修复验证错误。” 下载错误日志,查看需要更正哪些属性。

选取 App 以共享接受自定属性的数据,然后将属性映射到保留属性。 或者,将其从文件中删除。

有一组已定义的保留属性使用“Microsoft_”前缀。 在 此处查看完整列表。

.csv 文件可能包含使用作为保留属性集一部分的名称的列标题。 例如,不应使用名为“PersonEmail”的列标题,因为 Microsoft_PersonEmail 是保留属性。

打开 .csv 文件,并使用用于保留属性的名称查找任何标头。 如果列旨在引用保留属性,请将其更新为匹配官方列表中的确切名称。 保存更新的文件并再次上传。 或者,将这些属性映射到保留属性名称。

查看保留属性的完整列表。

设置 Azure Blob 存储连接器时可能显示的消息

邮件 操作
“凭据无效。 请联系 Azure 管理员进行更新。” 输入的 Azure Blob 身份验证 URL 不正确。 要解决此问题:

请联系 Azure 管理员查看与存储帐户关联的凭据。 他们应确认:

1. 服务主体仍处于活动状态

2. 使用正确的客户端 ID 和租户 ID

存储 Blob 数据读取者 (使用正确的角色分配)

Azure 管理员提供更新后的凭据后,请返回到连接器设置页并输入新的身份验证详细信息。
“CSV 文件为空。 请上传其他 CSV 文件。” 上传一个有效的仅标头 .csv 文件,其中包含你计划映射和导入的属性。

1. 创建 .csv 文件并确保第一行包含要导入的所有属性。

2. 不需要数据行。

完成后,以 .csv 格式保存文件并再次上传文件。
“此文件包含重复的标头名称。 请删除重复项,然后重试。” 打开 .csv 文件并查看标题。 查找多次出现的任何列,例如名为“Microsoft_PersonEmail”的两列。重命名或删除重复列名,保存文件,然后再次上传。
“此文件太大。 请上传小于 512 KB 的文件。” 检查 .csv 文件的大小。 如果大于 512 KB,请尝试将标头拆分为多个较小的文件。 这需要更多上传,但允许引入所有所需的属性。 还可以尝试删除不必要的属性。

保存缩减后的文件,然后再次上传。 
“此文件包含以”Microsoft“开头但不能识别为保留属性的标头。 只有保留属性可以使用“Microsoft”作为前缀。 请重命名或删除这些属性,然后再次上传文件。” 有一组已定义的保留属性使用“Microsoft_”前缀。 在 此处查看完整列表。

文件包含使用此前缀但不在此保留列表中的列标题。

打开 .csv 文件并找到以“Microsoft_”开头的任何标头。如果这些是自定义属性,请重命名它们以删除 Microsoft 前缀。 如果列旨在引用保留属性,请将其更新为匹配官方列表中的确切名称。 保存更新的文件并再次上传。
“只能导入 CSV 文件。” 确认该文件实际上是一个 .csv 文件。 打开文件以确保它保存为 .csv 文件,而不是其他格式,如 .xlsx、.txt 或 .zip。

验证文件类型后,使用正确的文件重试上传。
“此 CSV 文件应仅包含标头。 请删除所有数据行,然后重新上传文件。” 上传仅包含属性名称而不包含组织数据的 .csv 文件。

要解决此问题:

1. 打开 .csv 文件。

2. 删除所有数据行,仅保留标题行。

3. 确保标题下方没有空白行、多余行或隐藏内容。

完成后,将文件另存为 .csv 文件并再次上传。
“缺少一些必需的属性。

尚未映射要向其发送数据的应用程序所需的某些属性。 如果所需的映射未完成,上传到这些应用可能会失败。”
每个应用和服务都有自己的一组必需属性。 确保映射完整:

1. 检查要向其发送数据的应用程序的必需属性列表。 这些属性都必须映射。

2. 将所需属性与 .csv 文件中包含相应数据的列映射。

如果您的文件不包含相应的属性,请更新您的文件以包含所需属性所需的数据。

如果您不想添加缺少的属性映射,请从目标列表中删除该应用程序。 否则,上传可能会失败。
“你的一个或多个数据访问选择缺少必需的映射属性,这可能导致导入到这些应用失败。 映射缺失的属性或删除对相关应用的访问权限,以防止出现此错误。” 每个应用和服务都有自己的一组必需属性。 确保映射完整:

1. 转到 “映射属性” 页。

2. 检查要向其发送数据的应用程序的必需属性列表。 这些属性都必须映射。

3. 将所需属性与 .csv 文件中包含相应数据的列映射。

如果您的文件不包含相应的属性,请更新您的文件以包含所需属性所需的数据。

如果您不想添加缺少的属性映射,请从目标列表中删除该应用程序。 否则,上传可能会失败。
“提供的链接有问题。 请确保 URL 正确,并且你具有必要的权限和访问权限。 如果此问题仍然存在,请联系 Microsoft 支持。” Azure blob 身份验证 URL 必须正确,才能设置连接器。 要解决此问题:

1. 验证 URL 是否正确。 请确保使用的是正确的链接,而不是共享链接。 确认链接包含正确的容器和路径。

2. 检查拼写错误或部分链接。 确保已复制整个 URL。

3. 请咨询 Azure 管理员,确保服务主体具有所需的权限。 如果删除了访问权限,Azure 管理员需要将其还原。

确认并获得更新的 URL 后,请返回到 Azure Blob 存储连接页并重新输入凭据。

如果问题仍然存在,请联系 Microsoft 支持人员以获取更多帮助。
“一些导入的属性需要注意。 当未映射的属性将成为应用不支持的自定义属性时,或者当文件包含与保留名称冲突的属性名称时,可能会发生这种情况。 下载错误日志以查看特定问题,然后映射或删除受影响的属性并上传新文件。 详细了解如何修复验证错误。” 下载错误日志,查看需要更正哪些属性。

选取 App 以共享接受自定属性的数据,然后将属性映射到保留属性。 或者,将其从文件中删除。

有一组已定义的保留属性使用“Microsoft_”前缀。 在 此处查看完整列表。

.csv 标题文件可能包含使用作为保留属性集一部分的名称的列标题。 例如,不应使用名为“PersonEmail”的列标题,因为 Microsoft_PersonEmail 是保留属性。

打开 .csv 头文件,并使用用于保留属性的名称找到任何头文件。 如果列旨在引用保留属性,请将其更新为匹配官方列表中的确切名称。 保存更新的文件并再次上传。 或者,将这些属性映射到保留属性名称。

查看保留属性的完整列表。

设置基于 API 的连接器时可能显示的消息

邮件 操作
“此应用 ID 无效。 请检查条目,然后重试。” 应用 ID 无效,在提供有效的应用 ID 之前,无法对 API 终结点进行身份验证或建立连接。

要解决此问题,请让全局管理员:

1. 验证是否复制了应用 ID,是否与显示完全一致。

2. 确认应用 ID 属于正确的租户。

3. 确保应用注册仍然存在。

4. 如果应用已删除或重命名,请创建新注册。

完成后,使用正确的应用 ID 更新连接器设置。
“CSV 文件为空。 请上传其他 CSV 文件。” 上传一个有效的仅标头 .csv 文件,其中包含你计划映射和导入的属性。

1. 创建 .csv 文件并确保第一行包含要导入的所有属性。

2. 不需要数据行。

完成后,以 .csv 格式保存文件并再次上传文件。
“此文件包含重复的标头名称。 请删除重复项,然后重试。” 打开 .csv 文件并查看标题。 查找多次出现的任何列,例如名为“Microsoft_PersonEmail”的两列。重命名或删除重复列名,保存文件,然后再次上传。
“此文件太大。 请上传小于 512 KB 的文件。” 检查 .csv 文件的大小。 如果大于 512 KB,请尝试将标头拆分为多个较小的文件。 这需要更多上传,但允许引入所有所需的属性。 还可以尝试删除不必要的属性。

保存缩减后的文件,然后再次上传。 
“此文件包含以”Microsoft“开头但不能识别为保留属性的标头。 只有保留属性可以使用“Microsoft”作为前缀。 请重命名或删除这些属性,然后再次上传文件。” 有一组已定义的保留属性使用“Microsoft_”前缀。 在 此处查看完整列表。

文件包含使用此前缀但不在此保留列表中的列标题。

打开 .csv 文件并找到以“Microsoft_”开头的任何标头。如果这些是自定义属性,请重命名它们以删除 Microsoft 前缀。 如果列旨在引用保留属性,请将其更新为匹配官方列表中的确切名称。 保存更新的文件并再次上传。
“只能导入 CSV 文件。” 确认该文件实际上是一个 .csv 文件。 打开文件以确保它保存为 .csv 文件,而不是 .xlsx、.txt 或 .zip 等其他格式。

验证文件类型后,使用正确的文件重试上传。
“此 CSV 文件应仅包含标头。 请删除所有数据行,然后重新上传文件。” 上传仅包含属性名称而不包含组织数据的 .csv 文件。

要解决此问题:

1. 打开 .csv 文件。

2. 删除所有数据行,仅保留标题行。

3. 确保标题下方没有空白行、多余行或隐藏内容。

完成后,将文件另存为 .csv 文件并再次上传。
“缺少一些必需的属性。

尚未映射要向其发送数据的应用程序所需的某些属性。 如果所需的映射未完成,上传到这些应用可能会失败。”
每个应用和服务都有自己的一组必需属性。 确保映射完整:

1. 检查要向其发送数据的应用程序的必需属性列表。 这些属性都必须映射。

2. 将所需属性与 .csv 文件中包含相应数据的列映射。

如果您的文件不包含相应的属性,请更新您的文件以包含所需属性所需的数据。

如果您不想添加缺少的属性映射,请从目标列表中删除该应用程序。 否则,上传可能会失败。
“你的一个或多个数据访问选择缺少必需的映射属性,这可能导致导入到这些应用失败。 映射缺失的属性或删除对相关应用的访问权限,以防止出现此错误。” 每个应用和服务都有自己的一组必需属性。 确保映射完整:

1. 转到 “映射属性” 页。

2. 检查要向其发送数据的应用程序的必需属性列表。 这些属性都必须映射。

3. 将所需属性与 .csv 文件中包含相应数据的列映射。

如果您的文件不包含相应的属性,请更新您的文件以包含所需属性所需的数据。

如果您不想添加缺少的属性映射,请从目标列表中删除该应用程序。 否则,上传可能会失败。
“一些导入的属性需要注意。 当未映射的属性将成为应用不支持的自定义属性时,或者当文件包含与保留名称冲突的属性名称时,可能会发生这种情况。 下载错误日志以查看特定问题,然后映射或删除受影响的属性并上传新文件。 详细了解如何修复验证错误。” 下载错误日志,查看需要更正哪些属性。

选取 App 以共享接受自定属性的数据,然后将属性映射到保留属性。 或者,将其从文件中删除。

有一组已定义的保留属性使用“Microsoft_”前缀。 在 此处查看完整列表。

.csv 标题文件可能包含使用作为保留属性集一部分的名称的列标题。 例如,不应使用名为“PersonEmail”的列标题,因为 Microsoft_PersonEmail 是保留属性。

打开 .csv 头文件,并使用用于保留属性的名称找到任何头文件。 如果列旨在引用保留属性,请将其更新为匹配官方列表中的确切名称。 保存更新的文件并再次上传。 或者,将这些属性映射到保留属性名称。

查看保留属性的完整列表。

设置 SAP SuccessFactors 连接器时可能显示的消息

邮件 操作
“出了点问题。 与 SAP SuccessFactors 管理员共享代码LGN0005,或使用代码在 SAP SuccessFactors API 参考指南中获取详细信息。” 尝试验证 SAP SuccessFactors 凭据时出现一个或多个错误。

与 SAP SuccessFactors 管理员共享有关错误的代码,或在 SAP SuccessFactors API 参考指南中共享详细信息以获取帮助。
“验证映射时发现错误。 若要继续操作,需要上传新文件。 下载错误日志以查看问题,然后更正 JSON 文件并上传新文件。 或者通过下载该文件并上传 JSON 文件来使用默认映射。” 验证属性映射时出错。 一个或多个 JPath 不正确。

1. 下载错误日志,查看哪些属性需要更正。

2. 更新 JSON 映射文件。 修复任何无效的 JPath,并更正任何格式问题。

3. 重新上传更正后的 JSON 文件以继续。

若要使用提供的默认映射,请改为下载并上传该文件。

默认映射文件 不 包含自定义属性。
“此文件包含无效的标头。 只有保留属性才能将 Microsoft 前缀用作其名称的一部分。 重命名或删除这些属性,然后再次上传文件。” 有一组已定义的保留属性使用“Microsoft_”前缀。 在 此处查看完整列表。

文件包含使用此前缀但不在此保留列表中的列标题。

打开 JSON 文件并找到以“Microsoft_”开头的任何标头。如果这些是自定义属性,请重命名它们以删除 Microsoft 前缀。 如果列旨在引用保留属性,请将其更新为匹配官方列表中的确切名称。 保存更新的文件并再次上传。
“该文件缺少所需的 Microsoft_PersonEmail 映射。 请确保文件包含此信息,然后重试。” “Microsoft_PersonEmail”是系统必需的属性,是处理组织数据所必需的。

看到此消息可能意味着:

1. 文件中完全缺少此属性。

2. 属性在文件中,但拼写错误或以不同的名称列出。

更新文件以包含“Microsoft_PersonEmail),拼写完全符合要求,然后再次上传文件。
“缺少一个或多个自定义属性名称。 请上传一个新文件,其中包含每个自定义属性的名称。” 自定义属性是必需的属性名称。 文件中缺少一个或多个。

1. 打开文件并确认已为任何自定义属性分配名称。

2. 确保名称不与任何保留的 Microsoft_ 属性冲突。

保存 JSON 并再次上传文件。
“对一个或多个房产的访问受到限制。 若要继续,请联系管理员以请求必要的权限并重新上传文件,或删除受限制的属性并上传新的 JSON 文件。” JSON 文件包含一个或多个具有限制的属性。 无法验证或引入具有权限的属性。

要解决这一问题,请执行以下操作:

1. 联系您的 SAP SuccessFactors 管理员以请求必要的权限。

2. 或者,从 JSON 文件中删除具有限制的属性。

授予权限或更新文件后,再次上传文件。
“缺少一些必需的属性。

尚未映射要向其发送数据的应用程序所需的某些属性。 如果所需的映射未完成,上传到这些应用可能会失败。 如果要添加这些映射,请上传新的 JSON 文件。”
每个应用和服务都有自己的一组必需属性。 确保映射完整:

1. 检查要向其发送数据的应用程序的必需属性列表。 这些属性在 JSON 文件中必须都有一个 JPath。

2. 更新 JSON 映射文件以包含任何缺少的 JPath。

保存 JSON 文件,然后再次上传该文件。

如果您不想添加缺少的属性映射,请从目标列表中删除该应用程序。 否则,上传可能会失败。
“你的一个或多个数据访问选择缺少必需的映射属性,这可能导致导入到这些应用失败。 映射缺失的属性或删除对相关应用的访问权限,以防止出现此错误。” 每个应用和服务都有自己的一组必需属性。 确保映射完整:

1. 检查要向其发送数据的应用程序的必需属性列表。 这些属性在 JSON 文件中必须都有一个 JPath。

更新 JSON 映射文件以包含任何缺少的 JPath。

保存 JSON 文件,然后再次上传该文件。

如果您不想添加缺少的属性映射,请从目标列表中删除该应用程序。 否则,上传可能会失败。
“一些导入的属性需要注意。 当未映射的属性将成为应用不支持的自定义属性时,或者当文件包含与保留名称冲突的属性名称时,可能会发生这种情况。 下载错误日志以查看特定问题,然后映射或删除受影响的属性并上传新文件。 详细了解如何修复验证错误。” 下载错误日志,查看需要更正哪些属性。

选取 App 以共享接受自定属性的数据,然后将属性映射到保留属性。 或者,将其从文件中删除。

有一组已定义的保留属性使用“Microsoft_”前缀。 在 此处查看完整列表。

映射文件可能包含使用作为保留属性集一部分的名称的 JPath。 例如,不应包含“PersonEmail”,因为 Microsoft_PersonEmail 是保留属性。

打开映射文件并找到用于保留属性的任何属性名称。 如果名称旨在引用保留属性,请将其更新为与官方列表中的确切名称匹配。 保存更新的文件并再次上传。

查看保留属性的完整列表。

设置 Workday 连接器时可能显示的消息

邮件 操作
“Workday Web 服务 URL 和/或令牌 URL 出现问题。 向 Workday 管理员显示此消息:未知此类主机。 (wd2-impl-services7.workday.com:443) ” 无法使用提供的 Web 服务 URL 和/或令牌 URL 建立连接。 这通常表明 URL 不正确、无法访问、键入错误或引用了不存在或无法解析的 Workday 租户或域。

请联系 Workday 管理员:

1. 验证 URL 是否正确。 确保没有拼写错误、多余空格、缺少段或截断 URL。 如果需要,请从 Workday 管理控制台重新复制 URL。

2. 确认 Workday 租户处于活动状态且可访问。

3. 验证权限和访问权限。

验证或更新 URL 后,返回到连接器设置并重新键入值。
“验证映射时发现错误。 若要继续操作,需要上传新文件。 下载错误日志以查看问题,然后更正 JSON 文件并上传新文件。 或者通过下载该文件并上传 JSON 文件来使用默认映射。” 验证属性映射时出错。 一个或多个 XPath 不正确。

1. 下载错误日志,查看哪些属性需要更正。

2. 更新 JSON 映射文件。 修复任何无效的 XPath,并更正任何格式问题。

3. 重新上传更正后的 JSON 文件以继续。

若要使用提供的默认映射,请改为下载该文件并上传该文件。

默认映射文件 不 包含自定义属性。
“此文件包含无效的标头。 只有保留属性才能将 Microsoft 前缀用作其名称的一部分。 重命名或删除这些属性,然后再次上传文件。” 有一组已定义的保留属性使用“Microsoft_”前缀。 在 此处查看完整列表。

文件包含使用此前缀但不在此保留列表中的列标题。

打开 JSON 文件并找到以“Microsoft_”开头的任何标头。如果这些是自定义属性,请重命名它们以删除 Microsoft 前缀。 如果列旨在引用保留属性,请将其更新为匹配官方列表中的确切名称。 保存更新的文件并再次上传。
“该文件缺少所需的 Microsoft_PersonEmail 映射。 请确保文件包含此信息,然后重试。” “Microsoft_PersonEmail”是系统必需的属性,是处理组织数据所必需的。

看到此消息可能意味着:

1. 文件中完全缺少此属性。

2. 属性在文件中,但拼写错误或以不同的名称列出。

更新文件以包含“Microsoft_PersonEmail),拼写完全符合要求,然后再次上传文件。
“缺少一个或多个自定义属性名称。 请上传一个新文件,其中包含每个自定义属性的名称。” 自定义属性是必需的属性名称。 文件中缺少一个或多个。

1. 打开文件并确认已为任何自定义属性分配名称。

2. 确保名称不与任何保留的“Microsoft_”属性冲突。

保存 JSON 并再次上传文件。
“对一个或多个房产的访问受到限制。 若要继续,请联系管理员以请求必要的权限并重新上传文件,或删除受限制的属性并上传新的 JSON 文件。” JSON 文件包含一个或多个具有限制的属性。 无法验证或引入具有权限的属性。

要解决这一问题,请执行以下操作:

1. 联系 Workday 管理员以请求必要的权限。

2. 或者,从 JSON 文件中删除具有限制的属性。

授予权限或更新文件后,请再次上传文件。
“缺少一些必需属性

尚未映射要向其发送数据的应用程序所需的某些属性。 如果所需的映射未完成,上传到这些应用可能会失败。 如果要添加这些映射,请上传新的 JSON 文件。”
每个应用和服务都有自己的一组必需属性。 确保映射完整:

1. 检查要向其发送数据的应用程序的必需属性列表。 这些属性在 JSON 文件中必须都有 XPath。

2. 更新 JSON 映射文件以包含任何缺少的 JPath。

保存 JSON 文件,然后再次上传该文件。

如果您不想添加缺少的属性映射,请从目标列表中删除该应用程序。 否则,上传可能会失败。
“你的一个或多个数据访问选择缺少必需的映射属性,这可能导致导入到这些应用失败。 映射缺失的属性或删除对相关应用的访问权限,以防止出现此错误。” 每个应用和服务都有自己的一组必需属性。 确保映射完整:

1. 检查要向其发送数据的应用程序的必需属性列表。 这些属性在 JSON 文件中必须都有 XPath。

2. 更新 JSON 映射文件以包含任何缺少的 JPath。

保存 JSON 文件,然后再次上传该文件。

如果您不想添加缺少的属性映射,请从目标列表中删除该应用程序。 否则,上传可能会失败。
“此 JSON 文件无效,因为它缺少一个或多个括号。 请更正格式,然后重试。” 上传的 JSON 映射文件包含格式错误。 缺少一个或多个左括号或右括号。

若要更正此错误,请打开 JSON 文件并查找错误,例如:

1. 缺少右大括号:“}”

2. 缺少的右括号:“]”

3. 对象或数组中最后一项后的多余逗号

4. 不匹配的嵌套对象或数组

更正括号结构,保存文件,然后重新上传。
“该文件缺少一个或两个必需的系统属性。 请确保文件包含可以在默认映射中找到的此信息,然后重试。” “上传的 JSON 映射文件缺少一个或两个必需的系统属性。

打开 JSON 映射文件并确认它包含“Microsoft_PersonEmail”和“ExternalSource”属性。

看到此消息可能意味着:

1. 文件中完全缺少属性。

2. 属性在文件中,但拼写错误或列在不同的名称下。

更新文件以包含这些必需属性,然后再次上传文件。
“一些导入的属性需要注意。 当未映射的属性将成为应用不支持的自定义属性时,或者当文件包含与保留名称冲突的属性名称时,可能会发生这种情况。 下载错误日志以查看特定问题,然后映射或删除受影响的属性并上传新文件。 详细了解如何修复验证错误。” 下载错误日志,查看需要更正哪些属性。

选取 App 以共享接受自定属性的数据,然后将属性映射到保留属性。 或者,将其从文件中删除。

有一组已定义的保留属性使用“Microsoft_”前缀。 在 此处查看完整列表。

映射文件可能包含使用作为保留属性集中一部分的名称的 XPath。 例如,不应包含“PersonEmail”,因为 Microsoft_PersonEmail 是保留属性。

打开映射文件并找到用于保留属性的任何属性名称。 如果名称旨在引用保留属性,请将其更新为与官方列表中的确切名称匹配。 保存更新的文件并再次上传。

查看保留属性的完整列表。

按应用列出的自定义属性名称的规则

如果下面列出的属性名称作为自定义属性上传,则会导致错误。

Viva Insights

  • PersonId
  • IsActive
  • Domain
  • ObjectId
  • EmployeeJobTitle
  • FunctionType
  • LevelDesignation
  • InferredTeamSize
  • PopulationType
  • 层
  • OrgCompany
  • OrgCompanyCode
  • 组织
  • 位置
  • CompanyPostOfficeBox
  • CompanyOfficeStreet
  • CompanyOfficeCity
  • CompanyOfficeState
  • CountryOrRegion
  • CompanyOfficePostalCode
  • ManagerId
  • Person_IsManager
  • PrimaryCollaborator_PersonId
  • SecondaryCollaborator_PersonId
  • System_ExternalSourcePersonIdentifier
  • PeopleHistoricalId
  • PersonWorkMode
  • EmploymentType
  • HireDate
  • EffectiveDate
  • MetricDate
  • 按小时收费
  • 主管
  • WeeklyBadgeOnsiteDays
  • WeekendDays
  • WorkDayStart
  • WorkDayEnd
  • CostCenter
  • 部门
  • CurrentEmploymentStatus

Microsoft 365 个人资料

  • (空字符串)
  • 名字
  • 姓氏
  • 显示名称
  • 职务
  • Role
  • 级别
  • 层
  • 公司名称
  • 公司代码
  • 部门名称
  • 办公地点
  • 邮箱
  • Street
  • 市/县
  • 状态
  • 国家或地区
  • 邮政编码
  • Manager
  • 雇佣类型
  • 职务 (2)
  • 雇用日期
  • Employee Number
  • 成本中心
  • 部门
  • Phone

劳动力见解

  • PersonId
  • EmployeeJobTitle
  • FunctionType
  • LevelDesignation
  • 层
  • CompanyOfficeCity
  • CompanyOfficeState
  • CountryOrRegion
  • ManagerId
  • EmploymentType
  • HireDate
  • 按小时收费
  • 主管
  • WeeklyBadgeOnsiteDays
  • CurrentEmploymentStatus

Viva Glint

  • 电子邮件地址
  • 名字
  • 姓氏
  • 显示名称
  • 职务
  • 工作纪律
  • 级别指定
  • 层
  • 公司
  • 公司代码
  • 组织
  • 公司办公地点
  • 公司邮箱
  • Company Office Street
  • 公司办公城市
  • 公司办公室状态
  • Company Office CountryOrRegion
  • 公司办公室 邮政编码
  • Manager Email
  • 雇佣类型
  • 主管指示器
  • 状态
  • 经理 ID
  • 员工 ID
  • End Date

People Skills

  • Microsoft_PersonEmail
  • Microsoft_UserSkillNames