달력 표시 구성요소

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 2분
  • CPQ 달력 표시 구성요소를 사용하여 월별 뷰에 시간 기반 구성 옵션을 표시합니다. 사용자가 구성 인터페이스에서 직접 날짜별 기록을 보고, 선택하고, 관리할 수 있도록 세트, 필드 및 선택 설정을 구성합니다.

    CPQ 기본 UI를 사용하면 관리자가 시간 기반 구성을 지원하기 위해 사용자에게 달력 표시 구성요소를 제공할 수 있습니다. 달력은 월의 컨텍스트로 표시됩니다. 달력 표시의 기초가 되는 데이터는 세트이며, 각 달력 날짜는 세트의 한 기록으로 표시됩니다.

    아래 예는 달력 표시 구성요소로 표현되는, 매일 하나씩 30개의 기록이 있는 세트를 보여줍니다.

    달력 인터페이스

    이 예제를 지원하는 주요 요소에는 변수 이름이 availableDates인 집합이 포함됩니다. 이 세트에는 다음과 같은 관련 필드가 포함됩니다.
    • selectedDate (부울): 사용자가 하나 이상의 날짜/기록을 선택했는지 여부를 캡처합니다.
    • rawDate (텍스트): 각 세트 기록에 대해 형식화된 원시 날짜를 보유합니다.
    • availableDate (텍스트); 각 세트 기록에 대해 날짜를 "MM/DD/YYYY" 형식으로 유지합니다. 이는 달력 디스플레이에서 사람이 읽을 수 있는 날짜를 쉽게 표시하는 데 사용됩니다.
    • loadSize (선택 목록): 옵션에는 S, M 및 L이 포함됩니다. 이 선택 목록은 각 기록에 표시됩니다(월간 달력의 매일).

      달력 기록(일)은 세트 관련 필드를 원하는 수만큼 표시할 수 있습니다. 관리자는 애플리케이션에서 제공하는 사용자의 화면 크기와 응답성에 따라 정의된 필드 수에 실질적인 제한을 적용해야 합니다.

    구성/재구성 시 보강은 표시할 월에 적합한 크기와 각 기록에 대한 필드 값이 포함된 JSON 요소로 세트를 초기화합니다. 다음은 위의 원시 달력에 대한 구성 시 보강의 출력입니다.

    {
    	"availableDates": {
    			"data": [
    			{
    				"availableDate": { "value": "6/1/2024" },
    				"rawDate": {
    				"value": "2024-06-01T00:00:00.000Z"
    				}
    			}, //skipped interior records for brevity
    			{
    				"availableDate": { "value": "6/30/2024" },
    				"rawDate": {
    				"value": "2024-06-30T00:00:00.000Z"
    				}
    			}
    		],
    		"userEdited": false
    	}
    }

    관리자가 필드를 미리 채우기를 원하지 않았기 때문에 loadSize 필드가 세트 JSON에서 제외되었습니다.

    Blueprint 레이아웃에서 관리자는 세트가 표시되는 위치와 각 기록/달력 날짜에 표시될 하위 필드를 정의합니다.

    달력 데모

    속성 > 선택 설정에서 관리자는 사용자가 하루 또는 여러 날을 선택할 수 있도록 허용해야 하는지 여부를 정의합니다. 선택을 위한 부울 필드(이 경우 selectedDate)는 특정 세트 기록/달력 날짜를 선택했는지 여부를 저장합니다.

    선택 설정

    속성 > 검색 설정을 사용하면 달력에서 사용자가 한 개월 이상 선택할 수 있는 경우 사용자와 가장 관련성이 높은 날짜의 하위 집합을 표시할 수 있습니다. 이를 위해 소스 필드는 관리자가 월간 달력 세트에 표시하려는 요일(기록)입니다. 대상 필드는 전체 달력 날짜 범위를 포함하는 세트 관련 필드입니다.

    검색 설정

    속성 > 원시 값 설정 영역에는 위 페이지의 선택 항목에 따른 JSON 출력이 포함되어 있습니다. 그러나 "달력"은 현재 displayType으로 선택할 수 없으므로 관리자가 JSON을 편집하여 명시적으로 정의해야 합니다.

    원시 값 코드