CDS 또는 기타 타사 시각화 도구 통합

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 6분
  • 기술 시각화를 위해 CDS Visual 또는 기타 타사 도구를 통합합니다. 구성 입력을 시각적 업데이트와 동기화하여 사용자 경험을 개선합니다.

    CPQ 사용자가 구성 입력을 변경할 때 시각화가 실시간으로 업데이트되도록 필드 값을 외부 공급업체 시각화 도구와 공유하도록 구현할 수 있습니다. 이 문서에서는 CDS 시각적 도구를 예로 통합하는 방법에 대해 설명합니다. CDS 모델 설정에 따라 시각화는 CAD 도면, 2D 이미지 및 3D 대화형 이미지로 렌더링될 수 있습니다.

    제품 영상

    CDS 간의 CPQ 통합은 Blueprint 레이아웃 정의에서 수행됩니다. 다음 레이아웃 CSV 파일에는 관리자가 CPQ CDS 시각화가 렌더링될 위치를 정의하는 방법에 대한 샘플이 포함되어 있습니다. 또한 전송할 CDS 환경 및 CPQ 필드 데이터도 지정합니다.

    Layout_CDS_in_sidebar [Google 스프레드시트]

    단계별 가이드

    이 문서는 CDS 구성을 추가하는 방법을 결정하는 데 도움이 될 수 있습니다.

    1. 구성기에서 레이아웃 편집기를 CPQ 엽니다.
    2. CSV 레이아웃 파일을 다운로드합니다.
    3. CSV 레이아웃 파일을 열고 CDS 레이아웃 요소 필드(아래에 자세히 강조 표시되어 있음)를 추가합니다.
    4. CSV 레이아웃 파일을 에 다시 업로드합니다.CPQ 이제 CDS 레이아웃 요소가 레이아웃에 있어야 합니다.
    5. CDS 레이아웃 요소에 대한 구성 옵션을 열고 필요한 JSON 데이터 라인을 추가합니다.

    기술 구성 옵션

    CDS 간의 CPQ 통합은 Blueprint 레이아웃 정의에서 수행됩니다. 다음 레이아웃 CSV 파일은 관리자가 UI에서 CDS 시각화가 렌더링될 위치를 정의하는 방법을 보여줍니다. 또한 전송할 CDS 환경과 필드 데이터도 CPQ 지정합니다.

    레이아웃은 레이아웃 편집기에서 직접 업데이트할 수 있습니다. 레이아웃 편집기에서 아래 빨간색으로 강조 표시된 필드를 사용하여 CSV 파일에 CDS라는 새 섹션을 만들고 새 파일을 레이아웃에 업로드합니다.

    기술 구성 옵션

    여기에서 이 레이아웃 요소에 대한 설정을 열고 CDS 속성 JSON 편집기를 사용하여 다음 필드를 구성할 수 있습니다.

    메뉴

    이 요소에서 이러한 속성을 구성할 수 있습니다. 다음 표에서는 각 요소의 이름과 설명을 제공합니다.

    표 1. CDS 레이아웃 요소의 속성
    속성 이름 필수 설명
    이벤트 필드 no

    CDS로 보낼 필드의 배열 또는 객체입니다.

    배열은 포함된 문자열이 변수 이름과 CDS 변수 이름이라고 CPQ 가정합니다.

    객체에는 키:값 쌍이 있습니다. 키는 변수 이름이고 CPQ 값은 CDS 변수 이름입니다.

    세트 필드는 다음 형식을 사용하여 여기에서 정의할 수 있습니다.

    설정합니다. {setVariableName}입니다. {fieldVariableName}

    이벤트 세트 no

    CDS로 보낼 세트의 배열 또는 객체입니다.

    배열은 포함된 문자열이 변수 이름과 CDS 변수 이름이라고 CPQ 가정합니다.

    객체에는 키:값 쌍이 있습니다. 키는 변수 이름이고 CPQ 값은 CDS 변수 이름입니다.

    세트는 최대 25개의 인덱스 길이로 전체적으로 전송됩니다.

    setVariableName: [
    {
    field1: 'value',
    field2: 'value'
    }
    {
    field1: 'value',
    field2: 'value'
    }
    ]
    eventProductPickers no

    전체 제품 선택기의 데이터를 객체 배열로 CDS에 보냅니다.

    배열은 포함된 문자열이 변수 이름과 CDS 변수 이름이라고 CPQ 가정합니다.

    객체에는 키:값 쌍이 있습니다. 키는 변수 이름이고 CPQ 값은 CDS 변수 이름입니다.

    제품 선택기는 최대 25개의 인덱스 길이로 전체적으로 전송됩니다.

    옵션 #1:

    {
       "eventProductPickers": [
          "productPicker1",
          "productPicker2"
       ]
    }

    옵션 #2:

    {
      "eventProductPickers": {
         "logikProductPicker1": "cdsProductPickerName1",
         "logikProductPicker2": "cdsProductPickerName2"    }
    }
    도메인 yes CDS 시각화의 도메인
    env no 제공되지 않은 경우 기본값은 "qa"입니다.
    setActiveTriggers no

    집합의 부울 필드에 해당하는 변수 이름의 배열입니다. 나열된 필드는 집합 반복자에서 사용될 때 집합의 어떤 인덱스가 활성 상태인지 나타내는 트리거 역할을 합니다.

    기본 컨테이너 또는 확장 가능한 섹션을 반복 계층 유형으로 사용하는 경우 필요합니다.

    height no 시각화 창의 높이(px) - 기본값은 500입니다.
    width no 시각화 창의 너비(px) - 기본값 500

    JSON 문자열 형식

    최종 JSON 문자열 형식은 다음과 유사해야 합니다.

    {
    
    "domain": "exampleDomain", "env": "qa"
    
    "eventFields": ["field1", "field2", "field3"]
    
    }

    메모

    • 레이아웃 정의 샘플에서 CDS 렌더링은 오른쪽 위에 있는 BasicContainer 사이드바에 표시됩니다.
      • CDS는 JSON 객체를 텍스트 필드에 전달 CPQ 할 수 있습니다.
      • 고급 규칙을 사용하여 CDS의 JSON 응답을 구문 분석합니다.
    • CDS 요소 행의 '값' 열(열 I)에 제공된 JSON에는 다음 구문이 포함되어 있습니다.

      {
      "eventFields": [ "FIELD1",
      "FIELD2", "FIELD3"
      ],
      "domain": "CDS_DOMAIN", "env": "CDS_ENV_SECTOR"
      }

      도메인: CDS에서 제공하는 프로젝트에 서비스를 제공하는 도메인의 이름입니다.

      env: CDS에서 제공하는 프로젝트에 대한 환경 서비스의 이름입니다. 예: "qa".

      eventFields 배열에는 CDS에 전달되는 필드의 CPQ 변수 이름이 포함되어 있습니다. 과거에는 CDS가 변수를 변수 이름과 CPQ 일치시키는 것이 표준이었습니다. CDS를 사용하여 구현할 때가 맞는지 확인합니다.

      eventFields에는 CDS 간에 CPQ 통신할 모든 필드(즉, CDS 시각적 개체를 제어하는 필드와 CDS 시각화의 변경 사항에 따라 다시 CPQ 전달되는 필드 모두CPQ)가 포함되어야 합니다.

    • 처음 25개의 인덱스만 보낼 수 있지만 세트를 CDS에 전달할 수도 있습니다. 이는 속성 이름이 eventFields 대신 eventSets라는 점을 제외하고는 위의 프로세스를 미러링합니다.
    • CDS로 보낼 세트의 배열 또는 객체:
      • 배열은 포함된 문자열이 변수 이름과 CDS 변수 이름이라고 CPQ 가정합니다.
      • 객체에는 키:값 쌍이 있습니다. 키는 변수 이름이고 CPQ 값은 CDS 변수 이름입니다.
      • 다음 구문을 사용하여 최대 25개의 인덱스 길이로 전체적으로 전송됩니다.

        setVariableName: [
        {
        field1: 'value', field2: 'value'
        },
        {
        field1: 'value', field2: 'value'
        },
        ]
    • 제품 선택기는 처음 25개의 인덱스만 보낼 수 있도록 제한하여 CDS에 전달할 수도 있습니다. 이는 속성 이름이 eventFields 또는 setFields 대신 eventProductPicker임을 제외하고는 위의 프로세스를 미러링합니다. 다음 두 구문이 작동합니다.
      {
        "eventProductPickers": ["productPicker1", "productPicker2"]
      }
      {
        "eventProductPickers": {
          "logikProductPicker1": "cdsProductPickerName1",
          "logikProductPicker2": "cdsProductPickerName2"
        }
      }
    • CDS는 양방향 통신을 위해 설정할 수 있습니다. 단방향 통신은 사용자가 관련 CPQ 필드를 업데이트할 때 CDS 그래픽을 업데이트합니다. 두 번째 모드에서는 사용자가 CDS 그래픽을 조작할 수 있으며 CDS는 관련 CPQ 필드 입력을 업데이트합니다. 표준 필드의 경우 CDS는 매핑된 CPQ 필드에 다시 씁니다. 양방향 통신 설정 CPQ 에서 세트를 사용하는 경우 CPQ CDS 관리자는 다음 설정을 조정해야 합니다.
      • CPQ 관리자는 CDS에서 세트 데이터가 기록될 고유한 이벤트 필드를 정의합니다.
      • CDS 관리자는 이 필드를 세트 데이터의 대상으로 지정합니다.
      • CPQ 관리자는 필드를 구문 분석하고 세트를 채우는 결정 규칙을 정의합니다.