Устранение проблем с обновлением пользователей при управлении персоналом
Значения NULL и пустые значения не обрабатываются должным образом
Относится к:
- Подготовка пользователей из Workday в локальной среде Active Directory
- Workday to Microsoft Entra user provisioning
- Подготовка пользователей из SAP SuccessFactors в локальной среде Active Directory
- SAP SuccessFactors для подготовки пользователей Microsoft Entra
| Устранение неполадок | Сведения |
|---|---|
| Проблема | Вы успешно настроили приложение подготовки для входящего трафика. Вы получаете значение NULL или пустое из приложения отдела кадров. Ожидается, что служба подготовки очищает соответствующее целевое значение атрибута в локальная служба Active Directory / Идентификатор Microsoft Entra. Но операция завершается сбоем с ошибкой: InvalidAttributeSyntax-LdapErr: The syntax is invalid. The parameter is incorrect. Error in attribute conversion operation, data 0, v3839. |
| Причина | Служба подготовки не имеет логику по умолчанию для обработки значений NULL. Когда она получает пустую строку из исходного приложения, она пытается передать значение в целевое приложение без каких-либо изменений. В этом случае соединитель подготовки локальная служба Active Directory в настоящее время не поддерживает настройку пустых строковых значений, поэтому вы увидите указанную ранее ошибку. |
| Решение | Проверьте журналы подготовки. Определите атрибуты в целевой службе Active Directory, которая получает значения NULL или значения с пустыми строками. Обновите сопоставление для таких атрибутов, чтобы использовать сопоставление выражений. Ознакомьтесь с рекомендуемыми разрешениями. |
Рекомендуемые разрешения
Предположим, что атрибут BusinessTitle, сопоставленный с атрибутом AD jobTitle, может иметь значение NULL или быть пустым для Workday.
- Вариант 1. Используйте переключатель функции, чтобы проверить наличие пустых или пустых значений литералов.
Switch([BusinessTitle],[BusinessTitle],",","N/A")
Вариант 2. Используйте функцию IgnoreFlowIfNullOrEmpty, чтобы удалить пустые или пустые атрибуты в полезных данных, отправленных в локальная служба Active Directory / Идентификатор Microsoft Entra.
IgnoreFlowIfNullOrEmpty([BusinessTitle])
Отсутствуют некоторые обновления атрибутов для Workday
Относится к:
- Подготовка пользователей из Workday в локальной среде Active Directory
- Workday to Microsoft Entra user provisioning
| Устранение неполадок | Сведения |
|---|---|
| Проблема | Вы успешно настроили приложение подготовки Workday для входящего трафика и успешно подключены к URL-адресу клиента Workday. Вы видите, что в потоке определенных обновлений атрибутов из Workday или в некоторых случаях изменения атрибутов из Workday не выполняются должным образом во время добавочной синхронизации. |
| Причина | Во время добавочной синхронизации приложение подготовки отправляет запрос к журналу транзакций Workday, чтобы получить изменения основной сущности Worker, при этом обрабатываются только изменения, отслеживаемые журналом транзакций Workday. Если изменения атрибута Workday в настройке не отслеживаются в журнале транзакций Workday, идентификатор Microsoft Entra не получает это изменение. Например, атрибут 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 to Microsoft Entra user provisioning
- Подготовка пользователей из Workday в локальной среде Active Directory
- Подготовка пользователей из SAP SuccessFactors в локальной среде Active Directory
- Подготовка на основе API для локальная служба Active Directory
| Устранение неполадок | Сведения |
|---|---|
| Проблема | Вы получите код ошибки: HybridSynchronizationActiveDirectoryCannotFindAttribute |
| Причина | Имя атрибута не найдено в схеме Active Directory: атрибут. |
| Решение | Если атрибут был недавно добавлен в Active Directory, перезапустите агент подготовки, так как он кэширует схему при запуске. |
Сопоставление пользователей с помощью extensionAttribute не работает
Относится к:
- Workday to Microsoft Entra user provisioning
- SAP SuccessFactors для подготовки пользователей Microsoft Entra
| Устранение неполадок | Сведения |
|---|---|
| Проблема | Предположим, что вы используете extensionAttribute3 в идентификаторе Microsoft Entra для хранения идентификатора сотрудника и сопоставляете его с атрибутом Workday WorkerID или SuccessFactors personIdExternal для сопоставления пользователей. В такой конфигурации шаг сопоставления в процессе подготовки завершится ошибкой. Эта проблема проявляется при создании и обновлении пользователей. |
| Причина | Идентификатор Microsoft Entra ID OnPremisesExtensionAttributes (extensionAttributes1-15) нельзя использовать в качестве соответствующего атрибута, так как $filter параметр API Graph Azure AD не поддерживает фильтрацию по extensionAttributes. |
| Решение | Не используйте идентификатор Microsoft Entra ID OnPremisesExtensionAttributes (extensionAttributes1-15) в паре атрибутов сопоставления. Используйте employeeID. |
Обновления атрибута почты идентификатора Microsoft Entra ID не поддерживаются
Относится к:
- Workday to Microsoft Entra user provisioning
- SAP SuccessFactors для подготовки пользователей Microsoft Entra
- Идентификатор Microsoft Entra на основе API
| Устранение неполадок | Сведения |
|---|---|
| Проблема | Вы настроили подготовку атрибута почты из системы управления персоналом в идентификатор Microsoft Entra. Любое обновление атрибута почты не работает, даже если журналы подготовки отображают запись для атрибута почты. |
| Причина | Соединитель подготовки в Microsoft Entra поддерживает настройку атрибута почты только во время создания пользователя. После создания пользователя соединитель не поддерживает обновление адреса электронной почты. |
| Решение | Чтобы обновить атрибут почты для существующих пользователей, рекомендуется использовать портал Exchange Online или PowerShell. |
Подготовка поля "Последний день работы" из Workday
Относится к:
- Подготовка пользователей из Workday в локальной среде Active Directory
- Workday to Microsoft Entra user provisioning
| Устранение неполадок | Сведения |
|---|---|
| Проблема | Вы настроили сопоставление атрибутов для атрибута Workday "Последний день работы" (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 to Microsoft Entra user provisioning
| Устранение неполадок | Сведения |
|---|---|
| Проблема | Во время добавочной синхронизации может возникнуть задержка в 12–18 часов при обработке события прекращения для работников, расположенных в Азиатско-Тихоокеанском регионе и Австралии и Новой Зеландии. |
| Причина | Учетные записи пользователя системы интеграции Workday всегда извлекают данные на основе часового пояса Тихого океана. В настоящее время соединитель не реализует специализированный запрос для обработки записей завершения, относящихся к часовой поясу. |
| Решение | Существует два возможных обходных решения: |
Используйте подготовку по запросу для обработки события завершения определенного пользователя.
В 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")`