HR 사용자 업데이트 문제 해결
Null 및 빈 값이 예상대로 처리되지 않음
적용 대상:
- 온-프레미스 Active Directory 사용자 프로비저닝에 대한 Workday
- Workday에서 Microsoft Entra 사용자 프로비전
- 온-프레미스 Active Directory 사용자 프로비저닝에 대한 SAP SuccessFactors
- 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 프로비저닝 커넥터는 현재 빈 문자열 값 설정을 지원하지 않으므로 앞에서 언급한 오류가 표시됩니다. |
| 해결 방법 | 프로비저닝 로그를 확인합니다. Null 또는 빈 문자열 값을 받는 대상 Active Directory의 특성을 식별합니다. 식 매핑을 사용하도록 이러한 특성에 대한 특성 매핑을 업데이트합니다. 권장 해결을 참조하세요. |
권장 해결 방법
Workday에서 AD 특성 jobTitle에 매핑된 BusinessTitle 특성이 Null이거나 비어 있을 수 있다고 가정해 보겠습니다.
- 옵션 1: 함수 스위치 를 사용하여 빈 값 또는 null 값을 확인하고 비어있지 않은 리터럴 값을 전달합니다.
Switch([BusinessTitle],[BusinessTitle],"","N/A")
옵션 2: IgnoreFlowIfNullOrEmpty 함수를 사용하여 온-프레미스 Active Directory/ Microsoft Entra ID에 보낸 페이로드에서 비어 있거나 Null 특성을 삭제합니다.
IgnoreFlowIfNullOrEmpty([BusinessTitle])
일부 Workday 특성 업데이트가 누락됨
적용 대상:
- 온-프레미스 Active Directory 사용자 프로비저닝에 대한 Workday
- Workday에서 Microsoft Entra 사용자 프로비전
| 문제 해결 | 세부 정보 |
|---|---|
| 문제점 | Workday 인바운드 프로비저닝 앱을 구성하고 Workday 테넌트 URL에 성공적으로 연결했습니다. Workday에서 특정 특성 업데이트의 흐름이 지연되거나 경우에 따라 증분 동기화 중에 Workday의 특성 변경 내용이 예상대로 흐르지 않는 것을 관찰합니다. |
| 원인 | 증분 동기화 중에 프로비저닝 앱에서 Workday 트랜잭션 로그로부터 주 Worker 엔터티에 대한 변경 내용을 쿼리하고, 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 특성에 대한 변경 내용이 전달되지 않는 경우 이 동작이 자주 발생하는 경우 매주 또는 매월 전체 동기화를 주기적으로 실행하는 것이 좋습니다. |
특성을 찾을 수 없음
적용 대상:
- 온-프레미스 Active Directory 사용자 프로비저닝에 대한 Workday
- Workday에서 Microsoft Entra 사용자 프로비전
- 온-프레미스 Active Directory 사용자 프로비저닝에 대한 Workday
- 온-프레미스 Active Directory 사용자 프로비저닝에 대한 SAP SuccessFactors
- 온-프레미스 Active Directory에 대한 API 기반 프로비전
| 문제 해결 | 세부 정보 |
|---|---|
| 문제점 | 오류 코드가 표시됩니다. HybridSynchronizationActiveDirectoryCannotFindAttribute |
| 원인 | Active Directory 스키마: 특성에서 특성 이름을 찾을 수 없습니다. |
| 해결 방법 | 특성이 최근에 Active Directory에 추가된 경우 시작 시 스키마를 캐시하므로 프로비전 에이전트를 다시 시작합니다. |
extensionAttribute를 통한 사용자 일치가 작동하지 않음
적용 대상:
- Workday에서 Microsoft Entra 사용자 프로비전
- SAP SuccessFactors - Microsoft Entra 사용자 프로비전
| 문제 해결 | 세부 정보 |
|---|---|
| 문제점 | Microsoft Entra ID의 extensionAttribute3 사용하여 직원 ID를 저장하고 사용자 일치를 위해 Workday WorkerID 또는 SuccessFactors personIdExternal 특성에 매핑한다고 가정해 보겠습니다. 이 구성을 사용하면 프로비전 프로세스의 일치 단계가 실패합니다. 이 문제는 사용자 만들기와 업데이트 모두에 영향을 줍니다. |
| 원인 | Azure AD Graph API의 $filter 매개 변수가 extensionAttributes 필터링을 지원하지 않으므로 Microsoft Entra ID OnPremisesExtensionAttributes(extensionAttributes1-15)를 일치 특성으로 사용할 수 없습니다. |
| 해결 방법 | 일치 특성 쌍에서 Microsoft Entra ID OnPremisesExtensionAttributes(extensionAttributes1-15)를 사용하지 않습니다. employeeID를 사용합니다. |
Microsoft Entra ID 메일 특성에 대한 업데이트가 지원되지 않음
적용 대상:
- Workday에서 Microsoft Entra 사용자 프로비전
- SAP SuccessFactors - Microsoft Entra 사용자 프로비전
- API 기반 프로비저닝 Microsoft Entra ID
| 문제 해결 | 세부 정보 |
|---|---|
| 문제점 | HR 시스템에서 Microsoft Entra ID로 메일 특성 프로비저닝을 구성했습니다. 프로비전 로그에 메일 특성에 대한 레코드가 표시되더라도 메일 특성에 대한 업데이트가 작동하지 않습니다. |
| 원인 | Microsoft Entra에 대한 프로비저닝 커넥터는 사용자가 만드는 동안에만 메일 특성 설정을 지원합니다. 사용자가 만들어지면 커넥터는 전자 메일 주소 업데이트를 지원하지 않습니다. |
| 해결 방법 | 기존 사용자의 메일 특성을 업데이트하려면 Exchange Online 포털 또는 PowerShell을 사용하는 것이 좋습니다. |
Workday에서 작업 마지막 날 필드 프로비전
적용 대상:
- 온-프레미스 Active Directory 사용자 프로비저닝에 대한 Workday
- 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 종료 처리 지연
적용 대상:
- 온-프레미스 Active Directory 사용자 프로비저닝에 대한 Workday
- 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")`