排查 HR 属性检索问题

提取 Workday 属性时出现问题

适用于
* Workday 到本地 Active Directory 的用户预配
* Workday 到 Microsoft Entra 用户预配
问题说明
你已配置 Workday 入站预配应用,并已成功连接到 Workday 租户 URL。 你运行了测试同步,但观察到预配应用并未检索 Workday 中的某些属性。 只有部分属性被读取和预配到目标。
可能的原因
默认情况下,Workday 预配应用附带了适用于 Workday Web 服务 (WWS) v21.1 的属性映射和 XPATH 定义。 在预配应用中配置与 Workday 的连接时,如果明确指定了 WWS API 版本(例如:https://wd3-impl-services1.workday.com/ccx/service/contoso4/Human_Resources/v34.0),那么可能会遇到此问题,因为 WWS API 版本和 XPATH 定义之间不匹配。
解决方法选项
* 选项 1:从 URL 中删除 WWS API 版本信息并使用默认的 WWS API 版本 v21.1
* 选项 2:手动更新 XPATH API 表达式,以便其与你首选的 WWS API 版本兼容。 更新“属性映射”->“高级选项”->“编辑 Workday 属性列表”下的 XPATH API 表达式,同时参考 Workday 属性参考一节

提取 Workday 计算字段时出现问题

适用于
* Workday 到本地 Active Directory 的用户预配
* Workday 到 Microsoft Entra 用户预配
问题说明
你已配置 Workday 入站预配应用,并已成功连接到 Workday 租户 URL。 你已经在 Workday 中配置了一个集成系统,并且已经配置了指向 Workday 集成系统中的属性的 XPATH。 但是,Microsoft Entra 预配应用不会提取与这些集成系统属性或计算字段关联的值。
原因
这是一个已知限制。 Workday 预配应用目前不支持使用 Field_And_Parameter_Criteria_Data Get_Workers 请求筛选器提取计算字段/集成系统属性。
解决方法选项
请考虑使用 Workday 预配组或 Workday 自定义 ID 字段来解决问题。

建议的解决方法

  • 选项 1:使用 Workday 预配组:检查计算字段值是否可以表示为 Workday 中的预配组。 使用计算字段所用的相同逻辑,Workday 管理员可以将预配组分配给用户。 需要 Workday 登录的参考 Workday 文档:设置帐户预配组。 配置后,可以在预配作业中检索此预配组分配,并在属性映射和范围筛选器中使用它。
  • 选项 2:使用 Workday 自定义 ID:检查计算字段值是否可以表示为 Workday 配置文件上的自定义 ID。 使用 Workday 中的 Maintain Custom ID Type 任务定义新类型并在此自定义 ID 中填充值。 确保用于集成的 Workday ISU 帐户拥有 Person Data: ID Information 的域安全权限。
    • 示例 1:假设你有一个名为“工资单 ID”的计算字段。 可以在 Workday 中将“External_Payroll_ID”定义为自定义 ID,并使用使用将“Custom_ID_Type_ID”作为选择机制的 XPATH 对其进行检索:wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Identification_Data/wd:Custom_ID/wd:Custom_ID_Data[string(wd:ID_Type_Reference/wd:ID[@wd:type='Custom_ID_Type_ID']='External_Payroll_ID']/wd:ID/text()
    • 示例 2:假设你有一个名为“锁屏提醒 ID”的计算字段。 可以在 Workday 中将“锁屏提醒 ID”定义为自定义 ID,并使用将“wd:ID_Type_Reference/@wd:Descriptor”作为选择机制的 XPATH 检索与其对应的“Descriptor”属性:wd:Worker/wd:Worker_Data/wd:Personal_Data/wd:Identification_Data/wd:Custom_ID[string(wd:Custom_ID_Data/wd:ID_Type_Reference/@wd:Descriptor)='BADGE ID']/wd:Custom_ID_Reference/@wd:Descriptor

后续步骤