通过

解决与无效值或意外值相关的文件上传警告

  • 项目

将员工属性数据上传到 Microsoft Viva Glint 时，会收到以下警告消息之一。 从文章顶部的列表中选择你遇到的警告，然后按照相应的解决方法解决问题。

RECORD_STAGING_FAILURE

警告消息：

RECORD_STAGING_FAILURE：找到<与行号 <y> 对应的 x> 现有记录。

如果用户从 Microsoft Entra ID 中删除，并且 Viva Glint 中的相应记录被标记为 “已删除”，则会出现此问题。 以前删除的员工设置的忽略员工 ID 管理 Viva Glint 如何处理已删除的用户记录。

解决方法

若要解决此问题，请使用以下方法之一：

  • 如果使用“人员”页面上的“导入”上传数据，请确认上传。 这样，将跳过标记为Microsoft Entra ID 和 Viva Glint 中删除的记录。 所有其他没有其他错误或警告的数据都将导入 Viva Glint。

    注意：如果使用 Viva Glint Secure 文件传输协议（SFTP）上传数据，则标记为已删除的记录将自动跳过。

  • 删除已删除的记录并再次上传文件。 执行以下步骤：

    1. 如有必要，请与 Microsoft 365 或 Entra ID 管理员协作，确认从 Microsoft Entra ID 中删除的用户。

    2. 打开员工属性数据文件。 根据文件类型使用适当的方法：

      • 如果数据文件具有 .xls 或 .xlsx 扩展名，请在 Microsoft Excel 中打开该文件。
      • 如果数据文件具有 .csv 扩展名，请使用 文本导入向导 通过保留原始格式的数据将数据导入 Excel。

    3. 删除警告消息中列出的行。

      注意：行计数中不包含标题行。 例如，如果警告指示第 20 行，请转到第 21 行。

    4. 保存该文件，然后将其再次上传到 Viva Glint。

INVALID_EMPLOYEE_DATA：不支持的字符

警告消息：

INVALID_EMPLOYEE_DATA：跳过行号 <x> ，因为列 <y> 包含不受支持的字符。

出现此问题的原因是上传的文件包含旧的汉字字符。 Viva Glint 仅支持现代汉字字符。

解决方法

要解决该问题，请执行以下步骤：

  1. 打开员工属性数据文件。 根据文件类型使用适当的方法：

    • 如果数据文件具有 .xls 或 .xlsx 扩展名，请在 Microsoft Excel 中打开该文件。
    • 如果数据文件具有 .csv 扩展名，请使用 文本导入向导 通过保留原始格式的数据将数据导入 Excel。

  2. 找到警告消息中列出的行。

    注意：行计数中不包含标题行。 例如，如果警告指示第 20 行，请转到第 21 行。

  3. 查看警告消息中列出的列中的值。

  4. 将所有旧的汉字字符替换为现代汉字字符。 或者，删除旧的汉字字符。

  5. 保存该文件，然后将其再次上传到 Viva Glint。

MISSING_REQUIRED_VALUE

警告消息：

MISSING_REQUIRED_VALUE：第 x> 行<缺少用户 ID ID <>的“员工名字”、“员工姓氏”和“电子邮件地址”所需的值。

如果文件中的员工记录缺少以下一个或多个必填字段的值，则会出现此问题：

  • 名字
  • 姓氏
  • 电子邮件地址
  • 员工 ID
  • Status

解决方法

要解决该问题，请执行以下步骤：

  1. 查看员工属性数据文件，以确定缺少所需字段的值的行。

  2. 使用有效值完成受影响的字段。

    注意：对于仅提供名字的员工，请使用连字符（-）或句点（.）填充 姓氏 字段。

  3. 保存该文件，然后将其再次上传到 Viva Glint。

INVALID_EMAIL

警告消息：

INVALID_EMAIL：没有 <有效工作电子邮件的员工数量> 可能与员工 ID 作为电子邮件值发送的员工相关。

解决方法

若要解决此问题，请验证电子邮件地址的格式是否有效，包括登录名（@）和域。 如果有意使用员工 ID 填充电子邮件属性，请考虑将 @<组织的域>追加到员工 ID 值以满足此验证。

FIELD_TOO_BIG_FATAL

警告消息：

FIELD_TOO_BIG_FATAL：必填字段 <属性名称> 不能超过 64 个字符。

解决方法

若要解决此问题，请检查可能意外组合在一起的字段。 查看该文件并验证所有必需的属性是否具有小于 64 个字符的值。

注意：对于 “状态” 字段，限制为 32 个字符。

CHAR_LIMIT_EXCEED_NON_MANDATORY

警告消息：

CHAR_LIMIT_EXCEED_NON_MANDATORY：非必需字段 <属性名称> 长度超过 64 个字符。 因此，该值已截断为 64 个字符，这是报告中显示的值。 （受影响的员工数： <数字>）

解决方法

若要解决此问题，请检查可能意外组合在一起的字段。 查看文件并验证这些属性的值是否少于 64 个字符。 根据需要缩短任何截断的值，然后将文件上传到 Viva Glint。

SUSPICIOUS_VALUE

警告消息：

SUSPICIOUS_VALUE：员工 ID ID <> 的员工<属性名称>的值包含可疑字符。 检查可能已损坏的特殊/意外字符，并重新加载文件以更正。

解决方法

若要解决此问题，请检查该文件中是否存在以下字符，并在必要时将其删除：

  • 不常见的字符，例如？ 或_
  • 可能损坏的特殊语言字符

然后，再次将文件上传到 Viva Glint。

INVALID_STATUS

警告消息：

INVALID_STATUS：状态值“LEAVE”无效。 此值在所有上限中都需要完全为“ACTIVE”或“INACTIVE”。

解决方法

若要解决此问题，请确保 Status 属性的值仅包含 ACTIVE 或 INACTIVE（全部大写）。

UNEXPECTED_ATTRIBUTE

警告消息：

UNEXPECTED_ATTRIBUTE：以下属性/属性“属性名称>”<位于文件中，但未在 Viva Glint 中配置。

此问题发生在以下情况之一：

  • 上传的文件中有一个新属性，但它不包括在 Viva Glint 中设置的属性中。
  • 存在一个现有属性，其标签在上传文件的标题行中已更改。 例如， “部门 ”更改为 “部门”。
  • Status 属性在 Viva Glint 中未正确保存，并列在警告消息中。

解决方法

若要解决此问题，请使用以下方法之一，具体取决于原因：

  • 如果上传的文件中有新属性， 请将该属性 添加到 Viva Glint。

  • 如果上传文件中已重命名现有属性，请 重命名 Viva Glint 中的属性 。

  • 如果在警告消息中列出了 Status 属性，请按照 Viva Glint 中的以下步骤操作：

    1. 将属性重命名为临时值，并保存更改。
    2. 将名称还原为正确的值。

更新属性后，再次将文件上传到 Viva Glint。

INVALID_LOCALE

警告消息：

INVALID_LOCALE：区域设置值<区域设置>行<不是>有效的区域设置字符串。

如果上传的文件包含无效的语言代码值，则会出现此问题。

解决方法

要解决该问题，请执行以下步骤：

  1. 打开员工属性数据文件。 根据文件类型使用适当的方法：

    • 如果数据文件具有 .xls 或 .xlsx 扩展名，请在 Microsoft Excel 中打开该文件。
    • 如果数据文件具有 .csv 扩展名，请使用 文本导入向导 通过保留原始格式的数据将数据导入 Excel。

  2. 找到警告消息中列出的行。

    注意：行计数中不包含标题行。 例如，如果警告指示第 20 行，请转到第 21 行。

  3. 将无效 的区域设置 值替换为有效值。 有关有效语言代码值的列表，请下载 Viva Glint Employee 属性模板，选择语言代码工作表，然后检查语言代码列中的值。

  4. 保存该文件，然后将其再次上传到 Viva Glint。

INVALID_USER_TIMEZONE

警告消息：

INVALID_USER_TIMEZONE：第 x> 行<用户时区值<时区>不是有效的国际时区字符串。

如果上传的文件包含无效的时区值，则会出现此问题。

解决方法

要解决该问题，请执行以下步骤：

  1. 打开员工属性数据文件。 根据文件类型使用适当的方法：

    • 如果数据文件具有 .xls 或 .xlsx 扩展名，请在 Microsoft Excel 中打开该文件。
    • 如果数据文件具有 .csv 扩展名，请使用 文本导入向导 通过保留原始格式的数据将数据导入 Excel。

  2. 找到警告消息中列出的行。

    注意：行计数中不包含标题行。 例如，如果警告指示第 20 行，请转到第 21 行。

  3. 将无效 的用户时区 值替换为有效值。 有关有效时区值的列表，请下载 Viva Glint Employee 属性模板，选择时区工作表，然后检查规范时区列中的值。

  4. 保存该文件，然后将其再次上传到 Viva Glint。

INVALID_PERSONAL_EMAIL

警告消息：

INVALID_PERSONAL_EMAIL：第 x 行<个人电子邮件值“电子邮件地址>”<的格式不像有效的>电子邮件地址。

出现此问题的原因是您尝试上传的文件包含个人电子邮件地址属性的无效值。

解决方法

要解决该问题，请执行以下步骤：

  1. 打开员工属性数据文件。 根据文件类型使用适当的方法：

    • 如果数据文件具有 .xls 或 .xlsx 扩展名，请在 Microsoft Excel 中打开该文件。
    • 如果数据文件具有 .csv 扩展名，请使用 文本导入向导 通过保留原始格式的数据将数据导入 Excel。

  2. 找到警告消息中列出的行。

    注意：行计数中不包含标题行。 例如，如果警告指示第 20 行，请转到第 21 行。

  3. 将无效 的个人电子邮件 值替换为有效值。 有效的电子邮件地址使用以下语法：

    <username>@<email 域>

    例如，john@outlook.com。

  4. 保存该文件，然后将其再次上传到 Viva Glint。

    注意：可以确认当前上传，并在将来的上传中添加更正的地址。 但是，在更正这些地址之前，格式无效的个人电子邮件地址将与 Viva Glint 中受影响的用户保持关联。