針對 HR 使用者更新問題進行疑難排解
Null 和空白值未如預期般處理
適用於：
- Workday 到內部部署 Active Directory 使用者佈建
- Workday 至 Microsoft Entra 使用者佈建
- SAP SuccessFactors 到內部部署 Active Directory 使用者佈建
- SAP SuccessFactors 至 Microsoft Entra 使用者佈建
| 疑難排解 | 詳細資料 |
|---|---|
| 問題 | 您成功設定輸入佈建應用程式， 您將從 HR 應用程式取得 Null 或空白值。 您預期佈建服務會在內部部署 Active Directory/Microsoft Entra ID 中清除對應的目標屬性值。 但是作業失敗，錯誤訊息為：InvalidAttributeSyntax-LdapErr: The syntax is invalid. The parameter is incorrect. Error in attribute conversion operation, data 0, v3839 |
| 原因 | 佈建服務沒有預設邏輯可進行 Null 值處理。 當佈建服務從來源應用程式取得空字串時，會嘗試將值「依原樣」傳送至目標應用程式。 在此情況下，內部部署的 Active Directory 布建連接器目前不支援設定空字串值，因此您會看到先前提及的錯誤。 |
| 解決方法 | 檢查佈建記錄。 識別目標 Active Directory 中接收 Null 或空字串值的屬性。 更新這類屬性的屬性對應，以使用運算式對應。 請參閱建議的解決方式。 |
建議的解決方式
在 Workday 中，假設對應至 AD 屬性 jobTitle 的屬性 BusinessTitle 可能是 Null 或空白。
- 選項 1：使用函式 Switch 檢查空白或 Null 值，並傳遞非空白常值。
Switch([BusinessTitle],[BusinessTitle],"","N/A")
選項 2：使用函式 IgnoreFlowIfNullOrEmpty，在傳送至內部部署 Active Directory/Microsoft Entra ID 的承載中，卸除空白或 Null 屬性。
IgnoreFlowIfNullOrEmpty([BusinessTitle])
缺少某些 Workday 屬性更新
適用於：
- Workday 到內部部署 Active Directory 使用者佈建
- Workday 至 Microsoft Entra 使用者佈建
| 疑難排解 | 詳細資料 |
|---|---|
| 問題 | 您成功設定 Workday 輸入佈建應用程式，並成功地連線到 Workday 租用戶 URL。 您觀察到從 Workday 進行某些屬性更新的流程有延遲，或在某些情況下，Workday 的屬性變更不會如預期般在增量同步處理期間流動。 |
| 原因 | 在增量同步處理期間，佈建應用程式會查詢 Workday 交易記錄中是否有主要背景工作角色實體的變更，而且只會處理 Workday 的交易記錄所追蹤的變更。 如果在 Workday 的事務歷史記錄中未追蹤對 Workday 屬性的變更，則Microsoft Entra ID 不會擷取該變更。 例如：LocalReference Workday 屬性是預設屬性對應的一部分，而且具有 XPATH wd:Worker/wd:Worker_Data/wd:Employment_Data/wd:Position_Data/wd:Business_Site_Summary_Data/wd:Local_Reference/wd:ID[@wd:type='Locale_ID']/text()。 請注意，此屬性是實體 Business_Site_Summary_Data 的一部分。 Workday 中這個屬性的值變更不會顯示在 Workday 交易記錄中。 因此，在增量同步處理期間，只有當與主要背景工作角色實體相關聯的屬性在同步處理間隔期間也有變更時，才會顯示這個屬性的新值。 |
| 解決方法 | 如果您經常發現到某些 Workday 屬性的變更不會流動這樣的行為，建議您定期執行每週或每月的完整同步處理。 |
找不到屬性
適用於：
- Workday 到內部部署 Active Directory 使用者佈建
- Workday 到 Microsoft Entra 使用者佈建
- Workday 對內部部署 Active Directory 的使用者佈建
- SAP SuccessFactors 到內部部署 Active Directory 使用者佈建
- API 驅動佈建至內部部署 Active Directory
| 疑難排解 | 詳細資料 |
|---|---|
| 問題 | 您會收到錯誤碼： HybridSynchronizationActiveDirectoryCannotFindAttribute |
| 原因 | 在 Active Directory 架構：屬性中找不到屬性名稱。 |
| 解決方法 | 如果屬性最近新增至 Active Directory，請重新啟動布建代理程式，因為它會在啟動時快取架構。 |
具有 extensionAttribute 無法運作的使用者比對
適用於：
- Workday 至 Microsoft Entra 使用者佈建
- SAP SuccessFactors 至 Microsoft Entra 使用者佈建
| 疑難排解 | 詳細資料 |
|---|---|
| 問題 | 假設您在 Microsoft Entra ID 中使用 extensionAttribute3 來儲存員工識別碼，並將其對應至 Workday WorkerID 或 SuccessFactors personIdExternal 屬性以進行使用者比對。 使用此組態時，佈建程序中的比對步驟會失敗。 此問題會影響使用者建立和更新。 |
| 原因 | Microsoft Entra ID OnPremisesExtensionAttributes (extensionAttributes1-15) 無法作為比對屬性，因為 Azure AD Graph API 的 $filter 參數不支援依據 extensionAttributes 進行篩選。 |
| 解決方法 | 請勿在比對屬性配對中使用 Microsoft Entra ID OnPremisesExtensionAttributes (extensionAttributes1-15)。 請使用 employeeID。 |
不支援 Microsoft Entra ID mail 屬性的更新
適用於：
- Workday 至 Microsoft Entra 使用者佈建
- SAP SuccessFactors 至 Microsoft Entra 使用者佈建
- API 驅動佈建至 Microsoft Entra ID
| 疑難排解 | 詳細資料 |
|---|---|
| 問題 | 您已將 HR 系統的 mail 屬性佈建設定為 Microsoft Entra ID。 即使佈建記錄顯示 mail 屬性的記錄，任何 mail 屬性的更新都無法運作。 |
| 原因 | Microsoft Entra 的佈建連接器僅在使用者建立期間支援設定 mail 屬性。 建立使用者之後，連接器就不支援更新電子郵件地址。 |
| 解決方法 | 若要更新現有使用者的 mail 屬性，請考慮使用 Exchange Online 入口網站或 PowerShell。 |
從 Workday 佈建 [工作的最後一天] 欄位
適用於：
- Workday 到內部部署 Active Directory 使用者佈建
- Workday 至 Microsoft Entra 使用者佈建
| 疑難排解 | 詳細資料 |
|---|---|
| 問題 | 您已在布建應用程式中設定 Workday 'Last Day of Work' （StatusTerminationLastDayOfWork） 屬性的屬性對應。 不過，「工作的最後一天」更新只會在終止日期生效之後發生，而您想要在終止日期之前擷取此「工作的最後一天」。 |
| 原因 | 在 Workday 中，只有在終止日期生效之後，才會在背景工作配置檔上設定 [工作的最後一天] 字段。 因此，Workday 佈建連接器無法在終止日期之前事先取得此日期。 |
| 解決方法 | 在 Workday 中，建立一個名為「過去工作日的員工」的布建群組。 在 Workday 中新增自動化，以在員工達到最後一天時，將使用者指派給此群組。 在 Microsoft Entra 佈建作業中，新增 Workday XPATH 屬性以擷取此群組指派。 |
- 範例：
`LastDayOfWorkWorkers = wd:Worker/wd:Worker_Data/wd:Account_Provisioning_Data/wd:Provisioning_Group_Assignment_Data[wd:Status='Assigned' and wd:Provisioning_Group=" Workers past Last Day of Work"]/wd:Provisioning_Group/text()`
在 accountDisabled 旗標的屬性對應邏輯中使用此欄位。
- 範例：
`Switch([LastDayOfWorkWorkers], Switch([Active], , "1", "False", "0", "True"), 'Workers past Last Day of Work', "True")`
Workday 終止處理延遲
適用於：
- Workday 到內部部署 Active Directory 使用者佈建
- Workday 至 Microsoft Entra 使用者佈建
| 疑難排解 | 詳細資料 |
|---|---|
| 問題 | 在增量同步處理期間，處理位於亞太地區和澳大利亞/紐西蘭地區之員工的終止事件可能會延遲 12-18 小時。 |
| 原因 | Workday 整合系統使用者 (ISU) 帳戶一律會根據太平洋時區擷取數據。 連接器目前不會實作特製化查詢，以處理時區專屬的終止記錄。 |
| 解決方法 | 有兩種可能的因應措施： |
使用隨選佈建來處理特定用戶的終止事件。
在 Workday 中，建立名為 Terminated Worker的佈建群組。 更新 Workday 中的終止商務程序，以在終止發生時將使用者指派給此群組。 在 Microsoft Entra 佈建作業中，新增 Workday XPATH 屬性以擷取此群組指派。
- 範例：
`TerminatedWorkers = wd:Worker/wd:Worker_Data/wd:Account_Provisioning_Data/wd:Provisioning_Group_Assignment_Data[wd:Status='Assigned' and wd:Provisioning_Group="Terminated Workers"]/wd:Provisioning_Group/text()`
在 accountDisabled 旗標的屬性對應邏輯中使用此欄位。
- 範例：
`Switch([TerminatedWorkers], Switch([Active], , "1", "False", "0", "True"), "Terminated Workers", "True")`