필터

필터를 쓰면 엔티티 속성이나 텔레메트리 키에 조건을 정의해 위젯이 표시할 엔티티를 제한할 수 있습니다. 필터가 있는 위젯은 별칭의 모든 엔티티 대신 조건에 맞는 엔티티만 보여 줍니다.

필터는 대시보드 수준에서 정의한 다음 위젯 데이터 소스마다 할당합니다.

---

1. 대시보드를 열고 수정 모드로 바꿉니다.
2. 대시보드 툴바에서 Filters(깔때기) 아이콘을 클릭합니다.
3. Filters 대화상자에서 Add filter를 클릭합니다.
4. Filter name을 입력합니다.
5. Add key filter를 클릭해 조건을 정의합니다.
6. 키 필터를 설정합니다(아래 키 필터 설정 참고).
7. 추가를 클릭해 키 필터를 저장합니다.
8. Add filter 대화상자에서 추가를 클릭해 필터를 저장합니다.
9. Filters 대화상자에서 저장을 클릭해 적용합니다.

Add filter 대화상자 아래쪽의 Filter preview에 결과 논리식이 실시간으로 표시됩니다.

---

키 필터는 위쪽의 세 필드로 정의합니다.

필드	설명
Key type	필터링할 엔티티 데이터의 유형: Time series, Attribute, Entity field 등.
Key name	텔레메트리 키나 속성의 이름(대소문자 구분).
Value type	값의 데이터 유형: Numeric, String, Boolean 등.

키 필터 안에서 추가 버튼과 Add complex 버튼으로 조건을 정의합니다.

• 추가 — 단순 비교 연산(예: 30보다 큼)을 추가합니다. 단순 연산이 여러 개면 그리고로 결합됩니다.
• Add complex — 그리고나 또는으로 결합한 하위 조건 묶음을 추가합니다. 범위 조건이나 합집합 조건에 씁니다.

복합 조건은 중첩해서 (A 그리고 B) 또는 (C 그리고 D) 같은 패턴을 나타낼 수 있습니다.

예 — 온도가 10과 30 사이:

• 연산 1(추가): 큼 10
• 연산 2(추가): 작음 30
• 두 연산은 자동으로 그리고(AND)로 결합됩니다.

예 — 배터리 잔량이 10% 미만이거나 95% 초과:

• Add complex로 묶음을 추가하고 연산자를 또는으로 정합니다.
• 하위 연산 1: 작음 10
• 하위 연산 2: 큼 95

기본적으로 연산 값은 고정된 숫자나 문자열입니다. Dynamic source type을 바꾸면 실행 중의 속성 값에 연결할 수 있습니다.

옵션	설명
No dynamic value	고정된 값을 씁니다(기본값).
Current tenant	테넌트 속성에서 기준값을 읽습니다.
Current customer	현재 고객의 속성에서 기준값을 읽습니다.
Current user	현재 사용자의 속성에서 기준값을 읽습니다.

동적 소스를 선택하면 소스 속성 필드가 나타납니다. 기준값으로 쓸 속성 이름을 입력합니다. 그러면 사용자나 고객마다 자기 속성 값에 따라 걸러진 데이터를 보게 됩니다.

연산 행마다 있는 톱니바퀴 아이콘을 클릭하면 Edit filter predicate user parameters 대화상자가 열립니다. 이 설정은 실행 중에 대시보드 사용자에게 연산 값을 어떻게 보여 줄지 정합니다.

매개변수	설명
편집 가능	켜면 사용자가 수정 모드로 들어가지 않고 대시보드에서 바로 이 필터 값을 바꿀 수 있습니다.
사용자 지정 라벨	필터 조건에 표시할 라벨입니다. 끄면 라벨이 자동으로 만들어집니다(예: temperature 큼).
Display order	사용자에게 보이는 필터 패널에서 이 조건이 나타나는 순서입니다.
단위	단위 설정을 엽니다. 원본 단위, 선택 사항인 단위 변환, 미터법·야드파운드법·하이브리드 단위계의 대상 단위를 정합니다.

---

필터는 위젯의 데이터 소스에 할당해야 효과가 있습니다.

1. 위젯을 편집용으로 엽니다.
2. 데이터 탭에서 데이터 소스 행을 찾습니다.
3. 필터 필드를 클릭하고 원하는 필터를 선택합니다.
4. 변경 사항을 적용하고 저장합니다.

위젯 데이터 소스마다 필터는 한 번에 하나만 쓸 수 있습니다.

---

Filters 대화상자의 필터마다 편집 가능 토글이 있습니다. 켜면 대시보드를 편집할 수 없는 고객 사용자도 실행 중에 대시보드 툴바에서 활성 필터를 바꿀 수 있습니다. 끄면 편집 권한이 없는 모든 사용자에게 필터가 고정됩니다.

이 설정은 필터 조건 사용자 매개변수의 연산별 편집 가능 설정과 다릅니다. 연산별 설정은 사용자가 특정 연산의 기준값을 바꿀 수 있는지 정합니다.

---

• 엔티티 별칭
• 대시보드