리드 전환 시 자주 발생하는 오류

사용자 정의 검증 오류 계정, 연락처, 기회, 리드 검증 규칙

검증 규칙이 리드 전환의 리드, 계정, 연락처, 기회 개체에 적용됩니다.
이는 'Require Validation for Converted Leads(전환된 리드에 대한 검증 요구)' 설정을 선택했을 때만 적용됩니다. 해당 설정의 선택 여부는 Setup(설정) | Lead settings(리드 설정)으로 이동해서 'Require Validation for Converted Leads(전환 리드에 대한 검증 요구)' 권한을 통해 확인할 수 있습니다.
관련 세부 정보는 리드 전환 시 검증 규칙이 실행되지 않음에서 확인할 수 있습니다. 이 설정을 선택하지 않았다면 리드 전환에 대해서는 리드 검증 규칙만 적용됩니다.

사용자 정의 검증 오류는 Converted Status(전환 상태) 선택 목록 아래에 빨간색의 굵은 글씨로 표시됩니다.


'FIELD_FILTER_VALIDATION_EXCEPTION(필드 필터 검증 예외), 값이 존재하지 않거나 필터 기준과 일치하지 않음'

이 오류 메시지는 개체에 대해 정의된 Lookup Field(조회 필드) 필터를 수정해서 업데이트 시 필터 기준이 반영되지 않도록 할 경우 발생합니다. 

이 문제의 해결법은 다음 문서에서 다루고 있습니다. 
오류 수신: 필드 필터 검증 예외, 값이 존재하지 않거나 필터 기준과 일치하지 않음.

이 오류는 리드 전환(계정, 기회, 연락처) 시 대상 개체의 조회 필드 중 하나에 대한 조회 필터로 인해 발생할 수도 있습니다. 

오류: 'System.DmlException: 삽입 실패. 0번째 행의 첫 번째 예외; 첫 번째 오류: 필드 필터 검증 예외, 값이 존재하지 않거나 필터 기준과 일치하지 않음.'

이 문제를 해결하려면 조회 필터를 'Required(필수)'가 아닌 'Optional(선택 사항)'으로 설정하거나 필터 논리를 수정해야 합니다.

마지막으로 이  오류는 리드 개체로부터 계정, 연락처, 기회 레코드로 매핑된 필드의 데이터 형식이 동일하지 않을 때 트리거될 수 있습니다. 리드 전환을 위한 필드를 매핑할 때 계정, 연락처, 기회에 대한 필드가 동일한 데이터 형식인지 확인하세요.

예: 다른 텍스트 필드에 매핑된 텍스트 필드

보류 중인 시간 기반 워크플로 작업

리드에 대해 보류 중인 'Time Based Workflow Action(시간 기반 워크플로 작업)'이 있을 때, 사용자가 시스템 전환을 시도할 경우 사용자가 리드를 전환할 수 없으며 다음 오류가 표시됩니다.

'오류: 워크플로에서 사용 중인 리드를 전환할 수 없음'

 이 문서에서는 워크플로에서 사용 중인 리드를 전환할 수 없음 시나리오를 확인할 수 있습니다.

대상 개체에 필수 필드가 누락됨

계정, 기회, 연락처 개체의 필수 필드가 'Lead Field Mapping(리드 필드 매핑)'에 매핑되지 않았거나 리드에 대해 입력되지 않았다면 사용자에게 오류 메시지가 표시됩니다. 'Field Level Security(필드 수준 보안)'으로 인해 필드가 필요할 수 있습니다. 

이때 다음과 유사한 메시지가 표시됩니다.

'오류: System.DmlException: 삽입 실패. 0번째 행의 첫 번째 예외; 첫 번째 오류: 필수 필드 누락, 필수 필드 누락: [CE / WFD 설명]: [CE / WFD 설명](시스템 코드)'

리드 전환 시 'System.DmlException: Insert failed(System.DmlException: 삽입 실패)' 오류 발생 에서 문제 해결 과정을 확인할 수 있습니다. 

사용자 정의 Apex 오류

사용자 정의 apex 오류는 조직 내에서 사용자 정의 코드가 올바르게 실행되지 않을 때 발생합니다. Apex 코드는 리드, 계정, 연락처, 기회, 관련 사용자 정의 개체에 대해 작성할 수 있습니다.

이런 오류 유형이 발생하면 다음과 유사한 메시지가 표시됩니다.

"오류:Apex 트리거 {Apex 트리거 이름}이(가) 예기치 않은 예외를 발생시켰습니다. 관리자에게 문의하세요:...)"

이 오류를 바로잡으려면 개발자를 통해 사용자 정의 Apex 코드를 검사해서 문제 해결을 진행해야 합니다. 

오류: '잘못된 상호 참조 키'

해결 방법: 리드 레코드에 편집 액세스 권한을 부여하거나 승인 프로세스를 통해 레코드가 잠겨 있는지 확인합니다.

추가 리소스:  
리드 전환 시 '연락처, 계정, 기회에 일부 값이 제한되어 있어 이 리드를 전환할 수 없습니다' 오류
리드 전환 시 중복 값 발견 오류
리드 전환에 대한 고려 사항
리드 전환 문제 해결
디버그 로깅 설정

YouTube 비디오: 오류 문제 해결: 리드 전환 실패