입력 매개변수와 선택기 카드
이 장의 매개변수와 선택기는 모두 표준 Quiver 카드이며 transform table 안의 변환으로는 제공하지 않습니다. 분석에 추가하고 입력과 연결하는 일반 절차는 매개변수 구성을 따릅니다.
단일 값 매개변수
다음 카드는 Flow start로 표시되며 상위 카드 입력 없이 값을 정의합니다.
| 카드 | 출력형 | 사용 예 |
|---|---|---|
| Numeric parameter | Number | 객체의 숫자 필터, 수식의 계수, Rolling aggregate의 창 길이 숫자 |
| String parameter | String | 문자열 필터 등 후속 카드의 입력 |
| Boolean parameter | Boolean | Boolean 필터 또는 전역 설정의 켜기/끄기 |
| Date/time parameter | Time | 날짜/시각 속성 필터, 시계열 차트나 Overlay chart의 날짜 마커 |
| Duration unit parameter | Duration unit | 이동 집계의 시간 단위 또는 Shift time series의 이동 시간 단위 |
Boolean으로 전역 설정을 제어하려면 Allow settings to be controlled를 켭니다. 시간 길이의 숫자와 Duration unit은 각각의 출력형을 요구하는 입력에 연결합니다.
Date/time range parameter
Flow start에서 Time range를 만드는 매개변수입니다. 필터나 시간 범위 입력에 연결할 수 있으며 편집기에서 세 가지 방식을 선택합니다.
| 방식 | 정의 |
|---|---|
| Fixed range | 고정 시작과 끝 날짜/시각을 직접 선택 |
| Relative range | 현재 시각에 대한 상대 길이. 예: 2 weeks ago부터 now |
| Use variables | 시작과 끝에 서로 다른 날짜/시각 변수 연결 |
Relative range는 페이지를 불러올 때마다 갱신합니다. 스트리밍 축의 연속 갱신 설정과는 구분합니다.
이벤트 객체의 시작과 끝을 기준으로 필터를 만들려면 두 시각을 각각 변수로 준비하고 Use variables로 범위를 구성합니다. 시간 및 값 범위에서 여러 차트에 연결하거나 통계에 사용하는 방법을 확인합니다.
Numeric range parameter
Flow start에서 Number range를 만듭니다. 숫자 범위를 받는 카드의 변수로 사용하며 시계열 차트의 Y축 범위 지정에 자주 사용합니다.
X/Y range parameter
Flow start에서 X/Y range를 반환합니다. X 범위와 Y 범위를 함께 정의하며 각 범위는 시간, 숫자 또는 순서형 문자열 범위일 수 있습니다. 주로 차트의 사각형 선택 범위를 저장하는 데 사용합니다.
Object selector
객체 유형이나 입력 객체 집합에서 단일 객체를 선택하는 드롭다운입니다.
| 구분 | 형식 |
|---|---|
| 입력 | 없음 또는 Object set |
| 출력 | Single object |
Prompt와 Help text로 어떤 객체를 선택해야 하는지 안내합니다. Show object view를 켜거나 다음 작업 메뉴에서 Object view 카드를 추가하면 선택한 객체의 뷰를 볼 수 있습니다.
객체 집합 표의 행을 Pop out object로 꺼낼 때도 Object selector가 자동으로 추가됩니다. 기준 객체 전환에서는 선택기로 관련 시계열을 함께 바꾸는 방법을 설명합니다.
속성값과 문자열 선택
| 카드 | 입력형 | 출력형 | 선택지 |
|---|---|---|---|
| Property value select parameter | Object set | String 또는 String array | 객체 집합의 문자열 속성값 |
| String selector | String array | String 또는 String array | 미리 지정한 문자열 배열 |
두 카드 모두 단일 선택 또는 다중 선택으로 구성할 수 있습니다. Property value select parameter는 카테고리처럼 고유값 수가 적은 String 속성의 필터를 매개변수화할 때 사용합니다.
String selector는 대시보드 사용자가 미리 정한 선택지만 고르도록 제한할 때 적합합니다. Dataset을 사용하는 분석에서는 Unique column values (dataset)의 배열 결과를 String selector에 연결할 수 있습니다. 객체 집합의 속성값에는 Property value select parameter를 직접 사용할 수 있습니다.
Transform table row selector
Transform table에서 한 행을 선택하는 매개변수입니다. 행의 기본 키 또는 0부터 시작하는 행 인덱스로 선택을 정의합니다. 입력과 출력은 모두 Transform table입니다.
선택한 행의 열을 후속 수식에 연결하면 시계열과 임계값 등을 함께 전환할 수 있습니다. 수동 표를 이용한 전환이 그 예입니다.
문자열 배열을 직접 입력하는 String array parameter의 계약은 배열 카드에 설명되어 있습니다.