시각화 도구와 통합 CPQ

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

    • 타사 시각화 엔진(CDS, kBridge 및 Threekit)에 연결하여 구성 입력에 실시간으로 응답하는 2D/3D 제품 뷰를 렌더링하는 방법을 CPQ 알아보십시오.

    다음을 수행할 수 있습니다.
    • 사용자가 구성하는 대로 라이브 영상 표시: 색상, 치수, 옵션 및 번들은 뷰어를 즉시 업데이트할 수 있습니다.
    • UI + 시각적 상태 조정: 필드 값, 행 설정 및 선택한 제품을 렌더러에 게시합니다.
    • (선택 사항) 뷰어에서 다시 쓰기: 지원되는 벤더의 경우 캔버스의 사용자 작업이 필드를 업데이트할 수 있습니다.

    지원되는 벤더 한눈에 보기

    표 1. 벤더 목록
    벤더 지시 보낼 수 있는 항목 다시 쓸 수 있는 항목 메모
    CDS 1-way 및 2-way 필드, 세트(처음 25개 행), 제품 선택기(처음 25개 옵션), 활성 세트 인덱스 필드; 수신기 필드 JSON + 규칙 구문 분석을 통한 세트 CAD/2D/3D에 적합합니다. 유연한 매핑 객체
    k브리지 1-way 및 2-way 필드, 세트(처음 25개 행), 제품 선택기(처음 25개 옵션), 활성 세트 인덱스 필드; 수신기 필드 JSON + 규칙 구문 분석을 통한 세트 풍부한 이벤트 및 수신기 모델을 사용한 실시간 3D
    쓰리킷 1방향 필드, 자산 ID(정적 또는 통한 필드), 활성 세트 인덱스(시각적 포커스만) 지원되지 않음(Logik → 뷰어) 충실도가 높은 영상에 사용합니다. 필드 및 자산 선택 매핑
    주:
    세트 또는 제품 선택기를 CPQ 보낼 때 최대 25개의 행/옵션을 게시합니다. 25를 초과하는 지수와 옵션은 전송되지 않습니다. 세트 반복자를 사용할 때 활성 세트 인덱스 트리거를 게시하여 사용자가 편집 중인 행을 뷰어에 표시하도록 할 수 있습니다.

    통합 작동 방식

    1. 블루프린트의 레이아웃 구성요소는 시각화 패널의 위치와 크기를 정의합니다.
    2. 연결 설정은 트래픽(예: 스크립트 또는 앱 URL, 인증 토큰 및 하위 도메인)을 승인하고 라우팅합니다.
    3. 매핑 블록은 CPQ 전송할 데이터를 선택합니다.
      • eventFields — 필드 변수 이름 및 해당 뷰어 키
      • eventSets — 변수 이름 설정(처음 25개 행은 객체 배열로 게시됨)
      • eventProductPickers — 객체 배열로 선택한 옵션(처음 25개)
      • setActiveTriggers — 세트 반복자의 활성 인덱스를 나타내는 부울 필드
    4. (양방향만 해당) 수신기 필드(CPQ 텍스트 필드)는 뷰어로부터 JSON을 수신합니다.
      • 결정 규칙(또는 보강)을 추가하여 JSON을 구문 분석하고 필드를 업데이트하거나 행을 설정합니다.
      • 수신기 필드가 있는 경우 양방향에 대해 명시적으로 구성된 매핑만 다시 쓰게 됩니다.

    시각화 도구의 지원되는 기능과 지원되지 않는 기능을 보여주는 표 형식입니다.

    데이터 교환됨

    • 필드: 스칼라 값(텍스트, 숫자, 부울, 선택 목록 선택).
    • 세트: 행 객체의 배열(처음 25개)입니다. 활성 세트 인덱스를 사용하여 반복자에서 편집 중인 행과 시각적 개체를 동기화된 상태로 유지합니다.
    • 제품 선택기: 선택한 옵션 객체의 배열(처음 25개)입니다.
    • 자산(Threekit): 동적 자산 선택을 활성화하려면 Logik에서 정적 assetId 또는 asset-ID 필드를 제공합니다.

    보안 및 환경

    • 인증 및 원본: 프로덕션과 비프로덕션에 적합한 벤더 토큰과 URL을 사용합니다. 런타임 클라이언트 원본이 호출 도메인과 일치하는지 확인합니다 CPQ .
    • CSP(콘텐츠 보안 정책): 포함 및 메시징을 위해 벤더 스크립트 또는 앱 호스트를 허용합니다. 보안 팀 및 CPQ 지원팀과 조정하여 도메인을 추가합니다.
    • 문제 분리: 환경 전체에서 공유된 레이아웃에서 벤더 자격 증명과 토큰을 사용하지 않도록 합니다. 승격 시 토큰을 교환합니다.

    도구를 선택할 때

    • 캔버스에서 양방향 편집이 필요한 경우 kBridge 또는 CDS를 선택하고 수신기 필드 및 구문 분석 규칙을 구현합니다.
    • 자산 관리 및 단방향 업데이트와 함께 충실도가 높은 3D가 필요한 경우 assetId 또는 assetId 필드 전략이 있는 Threekit을 선택합니다.
    • 세트 기반 UX가 많은 경우 양방향 세트 JSON 처리 및 활성 세트 인덱스 동기화를 위해 CDS 또는 kBridge를 선호합니다.

    일반 가이드라인

    • 필요한 항목만 매핑: eventFields, eventSets 및 eventProductPicker를 성능을 위한 필수 데이터로 제한합니다.
    • 25개 항목 한도를 위한 설계: 사용자가 25개의 세트 행 또는 제품 선택기를 초과할 수 있는 경우 가드레일(예: 확인, 페이징 또는 요약)을 추가합니다.
    • 양방향 정규화: 수신기 페이로드에 대한 안정적인 JSON 스키마를 정의하고 관리되는 규칙 또는 보강에서 구문 분석 논리를 중앙 집중화합니다.
    • 안전한 승격: 토큰 및 URL과 같은 환경별 값을 외부화합니다. 프로덕션 승격 전에 테스트에서 시각적 개체를 확인합니다.
    • 체계적으로 문제 해결:
      • 런타임 또는 스크립트 오류에 대한 관리자 로그를 확인합니다.
      • 벤더 도메인에 대한 CSP 및 네트워크 액세스를 확인합니다.
      • 뷰어의 콘솔/개발 도구 및 CPQ 디버거 입력을 사용하여 상태를 재현합니다.