사용 사례: 직접 URL을 통해 네이티브 UI 표시 CPQ

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분

    • 외부 라이브러리 대신 URL을 사용하여 구성 UI를 초기화하는 방법에 대해 알아봅니다.

    이 문서에서는 외부 라이브러리(예: easyXDM)에 의존하지 않고 구성 URL을 사용하여 구성 UI를 초기화할 수 있는 방법에 CPQ 대한 개요를 제공합니다.

    기본 구성 URL은 https://{tenant}.logik.io/ui/configure/{configurableProductId} 형식이며, 위치:

    • {tenant} CPQ 는 사용 중인 테넌트로, Salesforce 또는 헤드리스를 사용하는 CPQ 경우 관리자 경험의 기본 URL에서 찾을 수 있습니다.
    • {configurableProductId}는 구성에 사용할 구성 가능한 제품의 제품 ID CPQ 입니다.

    예시 구성 URL: https://demo6.demo.logik.io/ui/configure/01t5f000006QKynAAG?v=1

    구성 URL 쿼리 매개변수

    URL 쿼리 매개변수를 통해 추가 설정 및 데이터를 전달할 수 있습니다.

    표 1. 구성 URL 쿼리 매개변수유효한 값과 함께 설명된 매개변수
    매개변수 설명 필수 가치/메모
    v 버전 예 1
    pid 가격 장부 ID Salesforce 가격 장부 ID
    ID 구성 ID 로드할 기존 구성의 로직 UUID
    뚜껑 견적 라인 ID Salesforce 견적 라인 ID
    QID 견적 ID Salesforce 견적 ID
    log 로그 실행(비행 경로) 없음 | 사용 가능 | 활성

    이 매개변수는 대/소문자를 구분합니다.
    cm 커밋된 구성 ID 계약 주문이 수정 CPQ 되면 이전 구성 ID를 식별합니다. 그러면 해당 ID가 커밋된 구성 ID가 됩니다.
    필드 필드

    필드 객체의 배열입니다. 예: [{"variableName ":"textField1","value":"test"},{...}]

    JavaScript에서 encodeURI를 사용하여 특수 문자를 이스케이프합니다.
    에어컨 작업 컨텍스트 null 또는 "개정"
    e 편집 가능성 다음 중 하나입니다.
    • "tm9uZQ"(없음)
    • "QXZhaWxhYmx l"(사용 가능)
    • "QWN0aXZl"(활성)
    이 매개변수는 대/소문자를 구분합니다.
    레이아웃 레이아웃 변수 이름 구성 가능한 제품의 Blueprint에서 로드할 레이아웃의 이름
    돌아오다 반환 URL window.location을 저장 또는 취소 시로 설정하는 URL입니다. 인코딩되고 URL에 안전해야 함
    RT 런타임 토큰 아래 메모를 참조하십시오. 관리자 설정의 CPQ 런타임 토큰
    rta 런타임 API URL

    인코딩되어야 하며 URL로부터 안전해야 합니다. 런타임 토큰 매개변수를 사용하는 경우 적극 권장합니다. Javascript에서 encodeURI를 사용하여 특히 API를 호출할 때 특수 문자가 이스케이프되도록 합니다.
    통화 통화 ISO 코드
    주:
    rt(런타임 토큰) 매개변수를 사용하는 경우 Firefox 또는 Safari 브라우저를 사용할 때 모든 요청을 인증할 수 있도록 rta도 포함하는 것이 좋습니다.

    이미 인증한 구성 URL에 액세스하지 않는 경우(Salesforce 또는 직접) 인증하려면 런타임 토큰이 인증에 필요합니다. 연결된 SFDC 환경을 통해 인증하거나 헤드리스 환경의 구성 URL에 액세스하기 전에 구성 URL에 액세스하는 경우 테넌트 URL을 CPQ 활용 런타임 클라이언트의 원본으로 나열해야 합니다. 예: https://<yourLogikUrl>.test.logik.io.

    버전 매개변수가 포함되지 않으면 UI가 로드되지 않고 "오류: 버전을 지정해야 합니다." 오류가 표시됩니다.

    반환 URL이 포함되지 않은 경우 UI는 저장 시 UUID(예: {"uuid": "8b88c843-d10b-468b-8c49-17f8c9698799"})와 취소 시 빈 개체({})를 사용하여 상위 항목까지 postMessage를 브로드캐스트합니다.

    구성 URL 사용

    구성 URL은 최상위 창 또는 페이지의 iframe에서 사용할 수 있습니다.

    easyXDM 예제를 사용하여 구성을 초기화할 때와 달리 구성 URL을 사용할 때 구성 데이터는 Javascript의 브라우저 콘솔로 전송되지 않습니다.

    구성 URL을 최상위 창 URL로 사용할 때 고려 사항:

    • 저장 또는 취소 작업 CPQ 에서 UI는 백엔드를 CPQ 호출하여 구성을 저장하거나 취소합니다. 이러한 호출은 브라우저의 네트워크 탭에서 보고 전송되고 반환되는 데이터를 볼 수 있습니다.
    • 반환 URL이 포함된 경우 UI는 저장("견적") 또는 취소 시 창 위치를 해당 URL로 설정하려고 시도합니다.

    iframe에서 구성 URL 사용에 대한 고려 사항:

    • 반환 URL이 포함된 경우 UI는 저장("견적") 또는 취소 시 창 위치를 해당 URL로 설정하려고 시도합니다. 반환 URL이 포함되지 않은 경우 UI는 CPQ 저장 시 UUID(예: {"uuid": "8b88c843-d10b-468b-8c49-17f8c9698799"})와 취소 시 빈 개체({})를 사용하여 상위 항목까지 postMessage를 브로드캐스트합니다.
    • 두 구현 중 하나에서 저장 또는 취소 작업을 실행한 후 구성이 제거됩니다. 후속 저장 작업으로 인해 오류 메시지와 함께 404 오류가 발생합니다. "구성 ID가 '<Logik UUID>인 테넌트에 대한 규칙 엔진을 찾을 수 없습니다. 후속 취소 작업에서도 404 오류가 발생합니다.

    구성 결과

    저장된 구성의 결과는 GET API를 사용하여 BOM 데이터를 검색하여 액세스할 수 있습니다.

    구성 API URL을 통한 Postman 컬렉션

    결과는 웹후크를 통해 다운스트림 시스템으로 전송할 수 있습니다. 웹후크 문서를 참조하십시오.