通过

解决与派生属性相关的文件上传错误

  • 项目

将员工属性数据上传到 Microsoft Viva Glint 时，可能会收到以下派生错误消息之一。 从文章顶部的列表中选择遇到的错误，然后按照相应的解决方法修复错误。

日期格式配置不正确

错误消息：

DERIVATION_ERROR：为以下列错误配置日期格式：（雇用日期）。 我们期望<日期格式，如 mm/dd/yyyy。> 对于Microsoft Excel 文件，请确保单元格采用文本格式。

出现此问题的原因是上传的文件中的日期格式与在 Viva Glint 中设置属性时指定的格式不匹配。

解决方法

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

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

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

  2. 对于错误消息中列出的每个日期格式列，请执行以下步骤：

    1. 在列右侧（例如列 A），插入格式化为 “常规”的新列（B 列）。

    2. 选择新列的第一个单元格（单元格 B1），输入以下公式，然后选择 Enter：

      =TEXT（<原始日期列的第一个单元格，如 A1>，“<错误消息中预期的日期格式，如 mm/dd/yy”>）

      例如，输入以下公式：

      =TEXT（A1，“mm/dd/yyyy”）

    3. 将公式 填充到新列（B 列）中的单元格中。

    4. 使用“粘贴>特殊>值”选项，从新列（列 B）复制日期值，然后将这些值粘贴到原始日期列（列 A） 中。

    5. 删除包含公式的新列。

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

上传文件中的属性标头与 Viva Glint 配置不匹配

错误消息：

DERIVATION_ERROR：上传文件中的属性标头与 Viva Glint 配置不匹配。 确保所有属性标头名称都匹配并包含在文件中。 包括“雇用日期”和“出生日期”列。 这些列用于派生属性“任期”和“年龄组”。

此问题的原因是上传文件中的属性标头与 Viva Glint 中指定的属性名称不匹配。 属性标头必须与 Viva Glint 中的属性名称完全匹配，包括大小写和空格字符。

解决方法

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

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

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

  2. 查看 Viva Glint 中指定的属性名称：

    1. 在管理员仪表板中，选择“配置”图标，然后在“员工”部分选择“人员”。
    2. 选择“操作>管理用户属性”。
    3. 查看以下部分中的属性：

      • 活动属性

      • 派生属性

        注意：在本部分中，查看 Viva Glint 用于创建派生属性的属性。 这些属性列在“计算发件人”字段中。

      • 可选系统属性

      • 层次结构属性

  3. 对于步骤 2c 中标识的每个属性，请将 Viva Glint 中的名称与数据文件标头行中的值进行比较，然后修复任何不匹配。 请确保：

    • 没有不一致的情况。 例如， EMPLOYEE ID 和 Employee ID 不匹配。
    • 没有额外的空间。 例如， “状态” 和 “状态” 不匹配。
    • 没有拼写错误。
    • 没有额外的字符。 例如， Email_Address 和 EmailAddress 不匹配。

    若要修复不匹配问题，请 重命名 Viva Glint 中的属性或更新文件中的属性标头。

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

文件的格式意外

错误消息：

  • DERIVATION_ERROR：文件的格式意外。 需要 csv 文件格式。 检查传递的文件是否为采用 UTF-8 编码和逗号分隔值的 csv 文件。

  • DERIVATION_ERROR：文件的格式意外。 需要 xlsx 文件格式。 检查传递的文件是否为没有公式且没有其他工作表的 xlsx 文件。

出现此问题的原因是上传的文件的格式不是在 Viva Glint 中设置属性时指定的。

解决方法

若要解决此问题，请以预期格式重新保存文件，然后将其再次上传到 Viva Glint。

  • 如果预期格式为 CSV：
    • 使用 UTF-8 编码（带或不带 BOM）将文件重新保存为 CSV 文件。
    • 使用逗号分隔值。 如果任何值包含逗号，请将它们括在双引号中（例如“Manager，Customer Success”）。
  • 如果预期格式为 XLSX：
    • 将文件重新保存为 XLSX 文件。
    • 删除任何密码。
    • 请确保该文件不包含任何公式。
    • 只保留一张数据工作表。

由于数据无效，派生失败

错误消息：

DERIVATION_ERROR：处理文件失败。 由于属性（如 Hire Date>）中的数据<无效，派生失败。 查看并重新加载文件。

出现此问题的原因是上传的文件包含无效数据，例如：

  • 00/00/0000
  • 01/01/1900
  • #N/A
  • #REF

解决方法

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

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

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

  2. 对于错误消息中列出的属性，请检查值，并确定任何无效数据。

  3. 更正或删除无效数据。

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

行长度与标头的长度不匹配

错误消息：

ENRICHMENT_FAILURE：行 <行号，如 100> 长度与标头长度不匹配。 无法创建文件。

解决方法

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

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

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

  2. 查看错误消息中指定的行。

  3. 更新该行中的数据以匹配标题行中的列数。

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

MANAGER_HIERARCHY_UPDATE_ERROR

错误消息：

MANAGER_HIERARCHY_UPDATE_ERROR：至少有一个没有经理的员工记录，否则报告层次结构可能无效。 为 CEO/顶级领导者保留经理 ID 为空。

如果 CEO 或顶级人员分配了 经理 ID 值，则会出现此问题。

解决方法

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

  1. 在员工属性数据文件中，找到 CEO 或顶级人员，然后删除其经理 ID 值。

    注意：确保 “管理器 ID ”字段为空。 不要输入空格或“NULL”作为值。

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

若要避免将来出现此问题，请与人力资源信息系统（HRIS）团队合作，确保 员工属性数据中的 CEO 或顶级人员经理 ID 字段为空。

MANAGER_HIERARCHY_ERROR

错误消息：

管理器层次结构错误：在命令链中多次提及管理器电子邮件地址 snguyen@contoso.com ，从而创建一个周期。 他们要么向自己报告，要么正在与需要解决的另一个用户创建循环报告。

如果员工属性数据显示一个或多个经理自行报告或与其他经理有循环报告关系，则会发生此错误。

解决方法

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

  1. 在管理员仪表板中，选择“配置”图标，然后在“客户端设置”部分选择“活动审核日志”。

  2. 在日志中，找到未上传的文件，然后选择“详细信息”列中的“下载错误文件”。 下载的错误文件中的行表示每个管理器的直接和间接报告。

  3. 查找并删除错误文件的“说明”列中的重复数据。

  4. 将错误文件中指出的不同管理器电子邮件地址标识为有问题的地址。

  5. 对于步骤 4 中标识的每个经理电子邮件地址，请查看员工属性数据，以确定是否存在以下循环报告关系：

    • 经理向自己报告。 因此，其员工 ID 和经理 ID 相同。
    • 两个或多个经理相互报告并创建报告循环。 例如，经理 A 向经理 B 报告，经理 B 向经理 A 报告。

  6. 更正所有明显的循环报告关系。

    备注

    • 组织中的 CEO 或顶级人员不应显示为向自己报告。 其 经理 ID 字段应始终为空。
    • 如果经理显示为向自己报告，因为他们的经理职位必须填写，请改为指定其跳过级别的经理的经理 ID。

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