排查 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
- 示例 1:假设你有一个名为“工资单 ID”的计算字段。 可以在 Workday 中将“External_Payroll_ID”定义为自定义 ID,并使用使用将“Custom_ID_Type_ID”作为选择机制的 XPATH 对其进行检索: