일반적인 Salesforce 통합 문제

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 11분
  • CPQ와 Salesforce를 통합할 때 발생할 수 있는 문제를 해결하는 방법을 알아봅니다.

    Salesforce CPQ가 구성의 CPQ 호스트인 경우 두 사이트를 통합하면 몇 가지 일반적인 오류가 발생합니다. 다음은 솔루션과 확인해야 할 사항과 관련된 알려진 문제 목록입니다.

    일반적으로 Salesforce에서 생성된 오류가 표시되면 Salesforce 디버그 로그 를 사용하여 해당 오류가 트리거되는 위치를 찾을 수 있습니다.

    통합 문제를 조사할 때 또 다른 가치 있는 단계는 단계가 올바르게 완료되었는지 확인하는 것입니다.Salesforce 조직에 연결된 환경에 대한 설치 및 설정 가이드
    주:
    파트너 사용자에게 이러한 문제가 발생하거나 RFQ API를 사용하는 경우 먼저 이 항목의 끝에 있는 섹션을 참조하십시오 파트너 사용자/RFQ API 공유 설정 .

    Salesforce: "SBQQ: SOQL 쿼리가 너무 많음: 101"

    Salesforce 문제

    이 오류는 일반적으로 사용자가 100개가 넘는 항목이 있는 BOM을 만들고, 에서 견적CPQ을 클릭하고, 기본 Salesforce CPQ 동작으로 처리하기에는 견적 라인이 너무 많을 때 발생합니다.

    해결 방법: Salesforce CPQ 패키지 설정에서 큰 구성 사용이 설정되어 있는지 확인합니다.

    Salesforce 문제

    이 설정은 영업 담당자가 큰 번들을 구성할 때 거버너 제한에 도달할 가능성을 줄여주지만 전체적으로 수행 속도가 느려집니다. 이 설정에 대한 자세한 내용은 대규모 구성 사용을 참조하십시오.

    Salesforce: "null 객체의 역참조 시도"

    Salesforce 문제

    이 오류는 일반적으로 최종 사용자가 QLE에 CPQ 견적을 저장할 때 그리고 QLE로 돌아가기 전에 발생합니다. 영향을 받는 항목에 대한 가격 장부 항목이 누락되거나 비활성 상태이거나 중첩된 번들링 문제를 나타냅니다.

    솔루션(중첩된 번들링 없음): 제품의 가격 장부 항목이 없거나 비활성 상태입니다.

    Salesforce 문제

    Salesforce 문제

    제품의 모든 가격 장부 항목을 확인합니다. 이 오류는 다음 중 하나라도 참일 때 발생합니다.

    • 반환된 제품에 가격 장부 항목이 없습니다.
    • 반환된 제품에 비활성 가격 장부 항목이 있습니다.
    • 반환된 제품의 관련 가격표가 비활성 상태입니다.
    • 표준 가격 장부는 기본적으로 사용되지만 비활성 상태입니다.

    솔루션(중첩된 번들링): 중첩된 번들링을 사용하도록 설정하고 구성에 다음 구조와 일치하는 제품 구성이 있는 경우 직접적인 솔루션이 없습니다. 이 Salesforce 문제가 발생하지 않도록 구성을 설계하거나 중첩된 번들을 끌 수 있습니다.

    Parent product
    	Nested child 1 
    		Product X
    	Nested child 2
    		Product X

    이 문제에 대한 자세한 내용은 다음 Salesforce.com 주제를 참조하십시오.

    외부 구성기를 통해 동일한 제품을 두 개의 서로 다른 동적 중첩 번들에 추가하면 "null 객체의 참조를 역참조하려고 시도" 오류가 발생합니다.

    중첩 번들링을 비활성화하기로 결정한 경우 외부 구성기에 대한 추가 설정 > 중첩 번들 > Salesforce CPQ> 설치된 패키지 > 설정을 통해 SFDC에서 비활성화할 수 있습니다.

    Salesforce 문제

    또한 이 요청을 DevOps 팀에 보내 측면에서 이 기능을 CPQ 끄도록 지원 티켓을 제출하십시오. 이 기능을 끌 때까지 문제가 계속 발생합니다.

    구성 라인 항목 또는 구성 필드 데이터 세트를 생성하지 않음

    이 기능은 많은 구현에서 사용되지 않지만, 사용하는 경우 예상되는 Salesforce 객체를 생성하는 것이 무엇보다 중요합니다. 구성 라인 항목(CLI) 및 구성 필드 데이터 세트(CFDS)는 기본 관리 패키지로 관리되는 Salesforce 객체이며, 이들의 생성은 견적 라인으로 푸시되는 데이터와 비동기식으로 이루어집니다.

    사용자가 에서 구성을 CPQ저장하는 순간 QLE에서 생성된 최종 견적 라인을 저장하는지 여부에 관계없이 이러한 객체를 생성하는 프로세스가 시작됩니다. 이 경우 일반적으로 확인할 곳은 한 곳뿐입니다.

    해결 방법: 이러한 개체의 생성은 사용 가능한 다음 설정에 따라 달라집니다.

    • (CLI의 경우) Salesforce 객체 CPQ 관리자에 BOM 데이터 CPQ 푸시 설정
    • (CFDS의 경우) Salesforce 객체 CPQ 에 구성 데이터 CPQ 밀어넣기 관리자 설정
    • 새로 고침 토큰 사용자 이름의 SFDC 권한

    Salesforce 문제

    이러한 설정을 사용하도록 설정하지 않으면 사용자가 저장을 클릭할 때 이러한 객체가 생성되지 않습니다.

    이러한 설정이 활성화되어 있어도 여전히 CLI 또는 CFDS가 표시되지 않는 경우(또는 확장 정보 필드 매핑이 작동하지 않는 경우) 다음을 시도하십시오.

    • 로그를 확인하여 "구성[******]에 대한 LGK__ConfigurationLineItem__c 개체의 Salesforce 동기화가 성공적으로 완료되지 않았습니다"라는 오류가 나타나는지 확인합니다. Salesforce 설정의 "일시 중지되고 실패한 플로우 인터뷰" 페이지에 자세한 정보가 있을 수 있습니다.
    • 통합 사용자에게 필요한 권한목록에 대해 통합 사용자의 권한을 확인합니다.

    저장해도 하위 견적 라인이 생성되지 않습니다.

    Salesforce 문제

    CPQ BOM에는 제품 CPQ 환경이 있습니다.

    Salesforce 문제

    Salesforce에 저장하면 환경이 아닌 상위 구성 가능 제품만 있습니다.CPQ

    BOM 항목이 다음 조건을 충족하는 경우에만 견적 라인 항목을 생성합니다.

    • 항목의 BOM 유형은 "저장 요청에 포함할 BOM 유형" 설정에서 지정됩니다
    • 제품이 Salesforce와의 제품 동기화를 통해 데이터베이스에 존재합니다.

    이 문제는 사용자가 저장할 위치를 CPQ 클릭하고 구성을 시작한 상위 구성 가능 제품만 볼 수 있고 구성기에서 CPQ 생성된 하위 견적 라인이 없을 때 발생합니다. 이는 일반적으로 Salesforce의 제품 객체와 에서 생성된 CPQBOM 항목 사이에 연결이 없음을 의미합니다.

    해결 방법:
    • 제품 규칙에 의해 결정된 동일한 제품 ID를 가진 제품이 Salesforce 사이트에 있는지 확인합니다. 제품이 있는 경우 제품 기록의 필드(예: "활성")를 업데이트하고, 저장하고, 되돌리고 30분 정도 기다린 후 다시 시도하십시오.

      제품 기록 동기화는 성능 속도를 높이기 위해 제품2 기록의 마지막 수정 날짜에 의존합니다. 다른 환경에서 다시 지정한 경우, 이전 환경에 없었던 제품이 이제 여기에 존재할 수 있으며 재연결 날짜보다 오래된 날짜를 가질 수 있습니다. 30분마다 제품 동기화가 완료될 때까지 기다렸다가 구성을 다시 저장해 보십시오.

    • BOM 항목에 관리자에 CPQ 정의된 올바른 BOM 유형이 있는지 확인합니다.

      Salesforce 문제

      BOM 항목이 제조 유형이고 관리자가 CPQ 설정 탭에 판매 및 설치만 정의한 경우 해당 항목은 QLE로 반환되지 않습니다.

    • 상위 구성 가능 제품에 관련 동적 기능이 정의되어 있는지 확인합니다.

      Salesforce 문제

      그렇다면 옵션 선택 방법도 동적인지 확인합니다.

      Salesforce 문제

      이 관련 기능은 구성 가능한 제품에서 Logik 활성화 를 클릭하면 자동으로 생성되어야 하지만 Salesforce 조직의 일부 사용자 지정 제품 트리거로 인해 이 자동화가 중단될 수 있습니다. 기능 생성을 다시 트리거하려면 Logik 사용을 비활성화하고 저장한 다음 다시 활성화해 보십시오. 그런 다음 해당 제품으로 구성해 보십시오.

      (중첩 번들을 사용하는 경우 하위 견적 라인 항목이 연결된 모든 제품에는 최상위 상위 구성 가능 제품뿐만 아니라 제품과 관련된 이 동적 기능이 있어야 합니다.)

    저장해도 예상대로 견적 라인이 생성되지 않습니다.

    이는 일반적으로 하위 견적 라인의 필드 중 하나가 구성에 반영되지 않은 방식으로 채워질 때 발생합니다.CPQ 명확한 오류가 없기 때문에 추적하기 까다로운 문제입니다.

    솔루션: SFDC 환경에 견적 라인에 대해 작동하는 견적 계산기 플러그인(QCP) 스크립트, 플로우 또는 Apex 트리거가 있는지 확인합니다.

    특히 QCP의 경우 사용자 지정 스크립트를 검색합니다. 또한 견적 계산기 플러그인 필드(설치된 패키지 설정 > Salesforce CPQ > 플러그인>)에 스크립트가 있는지 확인합니다.

    Salesforce 문제

    이 사용자 지정 스크립트를 검토하여 예상대로 작동하는지 확인합니다.

    CPQ: "JSON 문자열이 힙 크기 제한을 초과합니다."

    Salesforce 문제

    이는 LGK__BomData__c 필드에 너무 많은 데이터(예: 많은 견적 라인 또는 확장 정보)가 포함되어 있고 사용자가 견적을 재구성하려고 할 경우에 발생합니다.

    해결 방법: BOM 항목 제한 기능으로 작성되는 항목 수를 제어합니다. 이 문제를 해결하려면 오류를 일으키는 구성의 BOM에서 항목을 계산합니다. (항목 수는 BOM의 라인 수입니다. 항목은 BomData 필드에서 "{}"로 구분됩니다.) 그런 다음, 지원 케이스를 만들어 테넌트 설정을 그 수의 절반으로 설정합니다. 이 Salesforce 필드를 사용하지 않는다면, 0으로 설정하십시오.

    재구성은 선택 항목을 저장하지 않습니다. CPQ

    최종 사용자는 구성을 올바르게 저장할 수 있으며 문제 없이 QLE에 쓸 수 있습니다. 그러나 사용자가 재구성을 시도해도 모든 선택 항목이 유지되지는 않습니다.

    해결 방법:

    • 이 문제가 특정 사용자 또는 프로필에서만 발생하는지 확인합니다. 해당 권한이 잘못 설정되었을 수 있습니다.
    • 제품에 관련 기능 이름, 구성 속성 및 가격표가 정의되어 있는지 확인합니다.

      Salesforce 문제

    • Blueprint에서 특정 선택을 지우는 규칙을 트리거할 수 있는 쌍을 사용하는지 또는 보강 구성/재구성 시 설정이 잘못되었는지 확인합니다. 이 문제에 대한 자세한 내용은 다음 문서를 참조하십시오 스크립팅: 첫 번째 및 후속 구성 확인 중.

    저장해도 하위 견적 라인이 생성되지 않습니다.

    구성하려는 구성 가능 제품에 활성화된 자동화에 CPQ 문제가 있을 수 있으며 재구성에 필요한 구성 속성을 생성하지 않았을 수 있습니다. 재구성하려면 견적 라인이 이전 구성의 UUID를 참조하는 구성 ID 속성이 있어야 합니다.

    구성 가능 제품의 상세 페이지에서 활성화 Logik.io 선택을 취소하고 저장한 다음 다시 확인하여 구성 속성이 생성되었는지 확인합니다.

    SFDC에서 관리자에 액세스할 CPQ 수 없음

    이 문제로 인해 관리자가 의 설계 및 구현 CPQ작업을 하지 못할 수 있습니다. 이 문제에는 여러 가지 원인이 있습니다.

    Salesforce 문제

    용액:

    • 한 명의 사용자에게만 이런 일이 발생하는 경우:
    • 사용자 그룹에 대해 이러한 상황이 발생하는 경우:
      • 프로파일 및 권한 그룹에 적절한 SFDC 권한이 있는지 확인합니다. Logik 구성을 시작할 때 권한이 부족하거나 빈 화면이 표시되는 경우 수행할 작업을 참조하십시오.
      • iFrame이 활성화된 상태에서 설정 섹션의 신뢰할 수 있는 URL에 추가되었는지 확인합니다 CPQ . 모든 경우에 필요한 것은 아니지만, 이 추가 기능은 여러 국가의 사용자가 있거나 CPQ Subscription Manager/RLM을 사용하는 조직에 도움이 되는 것을 확인했습니다.

        신뢰할 수 있는 URL 화면

      • 모든 사용자에 대해 이러한 상황이 발생하는 경우 사용자 지정 설정에 URL이 올바르게 입력되었는지 확인합니다.

        사용자 지정 설정

        이는 일반적으로 SFDC 조직과 환경을 통합 CPQ 할 때 수행되는 첫 번째 단계 중 하나입니다. 경우에 따라 URL을 설정하는 사용자가 의도치 않게 URL을 모든 사용자가 액세스할 수 있도록(중간 상자) 대신 프로필(하단 상자)에 대한 재정의로 설정합니다.

    구성을 시작할 수 없음

    Salesforce의 "권한 부족" 오류 메시지는 QLE에서 렌치 아이콘을 클릭하거나 견적에서 라인 편집 을 클릭한 후 제품을 선택할 때 사용자가 접할 수 있는 많은 화면 중 하나일 뿐입니다.

    정보 메시지

    이 문제가 발생하면 다른 문제로는 콘텐츠 차단됨 화면(SFDC에서 관리자에 액세스할 CPQ 수 없음 문제)을 보거나, 빈 화면을 보거나, 오류 메시지가 표시될 수 있습니다.

    이는 관리자에 액세스하는 데 필요한 동일한 권한에 대한 문제를 포함하여 다양한 이유로 발생할 수 있습니다 CPQ . 그러나 이 문제는 구성기의 최종 사용자(즉, 영업/파트너 사용자)에게만 영향을 미칩니다.

    해결 방법:

    • 이 문제가 하나의 Blueprint에 대해서만 또는 하나의 견적에서 시작할 때 발생하는 경우 관리자의 CPQ 로그 탭에 오류가 있는지 확인합니다.

      로그

      로그에서 오류가 발견되지 않으면 을 검토 일반적인 오류 메시지 및 원인합니다. 이는 Blueprint의 구성/재구성 시 스크립트 또는 견적에서 예상되는 쌍둥이 필드에 문제가 있기 때문일 수 있습니다.

    • 한 명의 사용자에게만 이 문제가 발생하는 경우 브라우저 문제가 발생하는지 확인합니다. 사용 중 발생하는 일반적인 브라우저 문제 CPQ 문서를 참조하십시오.
    • 사용자 그룹에 대해 이러한 상황이 발생하는 경우 해당 프로파일 및 권한 그룹에 적절한 SFDC 권한이 있는지 확인합니다. Logik 구성을 시작할 때 권한이 부족하거나 빈 화면이 표시되는 경우 수행할 작업을 참조하십시오.
    • 모든 사용자에 대해 이러한 상황이 발생하는 경우 Salesforce CPQ에서 URL이 올바른지 확인합니다. Salesforce CPQ> 설치된 패키지 > 설정으로 이동> 외부 구성기 URL 및 외부 공급업체 구성기를 > > 추가 설정을 구성합니다.

      외부 구성기

      이는 일반적으로 SFDC 조직과 환경을 통합 CPQ 할 때 수행되는 첫 번째 단계 중 하나입니다. URL은 일반적으로 https://<domain-name>.<sector>.logik.io/ui/configure 형식을 취하지만 VisualForce 페이지를 사용하여 구성기를 시작하는지 여부에 따라 다를 수 있습니다.

      URL이 위의 양식이 아닌 경우 조직에 구성기를 시작하기 위해 완료된 사용자 지정 설정에 대한 설명서가 CPQ 있어야 합니다.

    파트너 사용자/RFQ API 공유 설정

    설정 > 공유 설정에서 다음 객체의 기본 외부 액세스가 비공개로 설정되어 있는지 확인합니다.
    • 가격 장부
    • 제품 기능
    • 견적
    • 견적 라인
    • 구성 속성
    • 구성 라인 항목

    공유 설정

    Salesforce CPQ는 재구성 통합의 일부가 작동하려면 이러한 객체에 액세스해야 합니다.

    일반적으로 이 객체는 통합 사용자가 생성하므로 공유 설정을 편집할 필요가 없지만 대부분의 경우 파트너 사용자는 RFQ 중에 이러한 기록을 참조하려고 시도할 수 있으므로 공용 읽기 전용 또는 공용 읽기/쓰기로 설정해야 합니다.

    Salesforce 플랫폼 문제

    "기록 저장 중 오류 발생" 메시지가 표시될 수 있습니다.

    기록 저장 오류: 구성 가능한 제품을 정적 제품으로 변환할 수 없습니다. 하위 구성요소가 요구 사항을 충족하는지 확인하고 다시 시도하십시오.

    이 오류는 제품2 기록에서 필드의 LGK__IsConfigurable__c 선택을 취소하려고 할 때 발생할 수 있습니다. 이 문제를 해결하려면 Salesforce 앱 시작 관리자에서 Logik.io 관리자 사용자 지정 설정 페이지로 이동하여 구성 가능한 제품 설정 트리거 건너뛰 기 설정을 활성화합니다.