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 |
| 原因 | 佈建服務沒有預設的邏輯來處理空值。 當佈建服務從來源應用程式取得空字串時，會嘗試將值「依原樣」傳送至目標應用程式。 在此情況下，內部部署的 Active Directory 布建連接器目前不支援設定空字串值，因此您會看到先前提及的錯誤。 |
| 解析度 | 檢查配置記錄。 識別目標 Active Directory 中接收 Null 或空字串值的屬性。 請更新這些屬性的對應，改用運算式對應。 請參閱建議的解決方式。 |
建議的解決方案
在 Workday 中，假設對應至 AD 屬性 BusinessTitle 的屬性 jobTitle 可能是 Null 或空白。
- 選項 1：使用函式 Switch 檢查空白或空值，並傳遞非空白常量值。
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 交易記錄中。 因此，在增量同步期間，只有當與主要 Worker 實體相關聯的屬性在同步間隔期內發生變更時，才會顯示此屬性的新值。 |
| 解析度 | 如果您經常注意到某些 Workday 屬性的變更未能順利傳遞，我們建議您定期執行每週或每月的完整同步。 |
找不到屬性
適用於：
- Workday 到內部部署的 Active Directory 使用者設置
- Workday 至 Microsoft Entra 使用者佈建
- Workday 到內部部署的 Active Directory 使用者設置
- SAP SuccessFactors 到內部部署 Active Directory 使用者佈建
- API 驅動配置至內部部署 Active Directory
| 疑難排解 | 詳細資料 |
|---|---|
| 問題 | 您會收到錯誤碼： HybridSynchronizationActiveDirectoryCannotFindAttribute |
| 原因 | 在 Active Directory 架構：屬性中找不到屬性名稱。 |
| 解析度 | 如果屬性最近新增至 Active Directory，請重新啟動布建代理程式，因為它會在啟動時快取架構。 |
擴展屬性的使用者匹配無法正常運作
適用於：
- Workday 至 Microsoft Entra 使用者佈建
- SAP SuccessFactors 至 Microsoft Entra 使用者配置
| 疑難排解 | 詳細資料 |
|---|---|
| 問題 | 假設您在 Microsoft Entra ID 中使用 extensionAttribute3 來儲存員工標識符，並將它對應至 Workday WorkerID 或 SuccessFactors personIdExternal 屬性以進行使用者比對。 使用此組態時，佈建程序中的比對步驟會失敗。 此問題會影響使用者建立和更新。 |
| 原因 | Microsoft Entra ID OnPremisesExtensionAttributes （extensionAttributes1-15） 無法作為比對屬性使用，因為 $filterAzure AD Graph API 的參數不支援 依 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 的布建連接器不支援在使用者布建期間設定 郵件 屬性，因為此屬性是由 Microsoft Exchange Online 管理。 |
| 解析度 | 建立用戶之後，將 Exchange Online 授權指派給使用者，會自動將用戶主體名稱設定為電子郵件位址。 若要更新郵件屬性，請使用 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 中，建立名為 離職員工的布建群組。 更新 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")`