설정
세트에서 반복 가능한 필드 그룹을 구성하고, 복잡한 구성을 단순화하고, 반복되는 요소 CPQ에서 데이터 집계를 활성화하는 방법을 알아봅니다.
세트는 관리자가 여러 제품, 구성요소 또는 옵션과 같은 유사한 구성 데이터의 여러 인스턴스를 단일 Blueprint에서 정의할 수 있게 해주는 재사용 가능하고 반복 가능한 필드 모음입니다.
집합의 각 행은 반복되는 필드 그룹의 한 인스턴스를 나타내며 해당 행의 각 필드는 독립적으로 작동합니다. 세트는 구성 설계를 간소화하고, 중복을 줄이고, 표 형식 또는 목록 기반 입력이 필요한 고급 사용 사례를 지원합니다.
관리자는 세트를 사용하여 고객이 최종 사용자 인터페이스에서 쉽게 편집할 수 있는 구조화된 테이블 모양의 레이아웃으로 구성 옵션을 표시합니다.
세트는 다음을 위해 설계되었습니다.
- 반복 가능한 구성을 단순화합니다. 각 반복에 대해 여러 필드와 규칙을 생성하는 대신 한 번 정의하고 여러 번 재사용하십시오.
- 직관적인 표 형식의 데이터 항목을 제공합니다. 최종 사용자는 구조화된 그리드에서 여러 제품 인스턴스를 추가, 제거 또는 편집할 수 있습니다.
- 동적 규칙을 지원합니다. 규칙은 같은 행의 값을 참조하거나 모든 행에서 데이터를 집계할 수 있습니다.
- 고급 보고 및 요약을 활성화합니다. 집계는 행 전체의 필드 값(예: 총 수량 또는 총 랙 단위)을 요약합니다.
세트 작동 방식
세트는 여러 구성 필드를 그룹화하고 목록의 각 항목에 대해 해당 그룹을 반복합니다.
각 세트 행은 완전히 독립적입니다.
- 같은 행의 필드는 해당 행의 다른 필드에 영향을 줄 수 있습니다.
- 한 행의 필드는 다른 행의 필드에 직접적인 영향을 줄 수 없습니다.
- 집합 밖의 필드는 세트 안의 필드에 영향을 줄 수 있지만 그 반대는 불가능합니다.
집합 밖의 필드에 영향을 주려면 다음을 사용합니다.
- 집계: 모든 행의 합계, 개수, 평균, 최대 또는 최소값입니다.
- 제품 규칙: 설정된 데이터를 기반으로 외부 필드 값을 설정하는 논리를 정의합니다.
세트에는 최대 2,000개의 행이 포함될 수 있습니다.
표시 옵션
세트는 사용자 경험 요구 사항에 따라 여러 형식으로 UI에 나타날 수 있습니다.
| 디스플레이 유형 | 설명 | 사용 사례 예시 |
|---|---|---|
| 테이블 | 머리글이있는 행, 열 및 셀; 자세한 비교에 이상적입니다. | 여러 네트워크 장치를 구성합니다. |
| 목록 | 각 행은 카드로 표시됩니다. 단일 선택 또는 다중 선택을 지원할 수 있습니다. | 배송 슬롯 또는 서비스 패키지를 선택합니다. |
| 반복기 | 탐색 컨트롤과 함께 한 번에 하나의 기록을 표시합니다. | 작은 레이아웃에서 구성을 하나씩 편집합니다. |
관리자는 레이아웃 편집기에서 레이아웃, 정렬 및 스크롤을 제어합니다.
필드 관계
| 관계 | 동작 |
|---|---|
| 내부 → 내부 | 같은 행에 있는 필드는 규칙을 통해 서로 트리거할 수 있습니다. |
| 내부 → 외부 | 직접 허용되지 않습니다. 집계 또는 제품 규칙을 사용합니다. |
| 외부 → 내부 | 허용됩니다. 집합 외부의 규칙이나 필드 작업은 집합 필드 값을 변경할 수 있습니다. |
키 속성
세트에는 사용자가 테이블이나 목록과 상호작용하는 방식을 형성하는 여러 구성 범주가 포함되어 있습니다.
- 일반 설정: 방향, 최대 높이, 정렬, 인덱스 레이블.
- 디스플레이 유형: 테이블 뷰와 목록 뷰 중에서 선택합니다.
- 인라인 설정: "행 추가" 표시기, 드롭다운 컨트롤 또는 호버 동작을 표시합니다.
- 크기 설정: 사용자가 세트 행(숫자 또는 슬라이더 필드)을 늘리거나 줄이는 방법을 관리합니다.
- 선택 설정: 부울 선택 필드를 사용하여 하나 또는 여러 행 선택을 추가합니다.
- 검색 설정: 사용자가 집합의 값을 검색할 수 있도록 허용합니다(예: 사용 가능한 날짜로 필터링).
- 메시지 설정: 특정 셀에 확인 메시지 또는 표시기를 표시합니다.
세트 데이터 관리
세트는 CSV 형식으로 데이터 임포트 및 익스포트를 지원합니다.
- 세트 데이터 다운로드: UI에 적용된 필터에 따라 표시되는 열만 익스포트합니다.
- 세트 데이터 업로드: 구조화된 CSV 파일을 사용하여 세트에서 행을 추가하거나 업데이트합니다.
- 규칙은 업로드 시 자동으로 실행됩니다.
- 새 행이 추가됩니다. 일치하는 행이 업데이트됩니다.
- 시스템에서 적용한 제한이 적용됩니다(25개 표시 열 권장).
세트의 원시 값에 JSON 속성을 추가하여 업로드/다운로드를 활성화합니다.
{
"uploadDetails": {
"uploadButton": { "label": "Upload CSV", "visible": true },
"downloadButton": { "label": "Download CSV", "visible": true }
}
}
세트를 사용한 스크립팅
규칙이나 스크립트에서 세트를 참조하려면 다음 구문을 사용하십시오.
| 사용 케이스 | 구문 예시 |
|---|---|
| 세트에 액세스 | set.<setVarName> |
| 집계 필드에 액세스 | set.<setVarName>.<aggregateVarName> |
예:
if (set.networkDevices.totalRackUnits > 50) {
field.requiresAdditionalCooling = true;
}