별칭

별칭은 위젯에서 데이터 소스로 쓰는, 엔티티 하나 또는 엔티티 그룹에 대한 참조입니다.

별칭은 정적(고정된 엔티티를 가리킴)이거나 동적(엔티티 유형, 관계, 대시보드 상태에 따라 실행 중에 결정됨)일 수 있습니다.

별칭은 대시보드 툴바에서 만들거나, 위젯을 설정하면서 바로 만들 수 있습니다.

대시보드 툴바에서:

1. 대시보드를 열고 수정 모드로 바꿉니다.
2. 툴바 오른쪽 위의 개체 별명 아이콘을 클릭합니다.
3. 열린 대화상자에서 별칭 추가를 클릭합니다.
4. 별칭에 이름을 입력하고, 필터 유형을 선택하고, 필요한 필드를 채운 다음 추가를 클릭합니다.
5. 오른쪽 아래의 저장을 클릭해 적용합니다.

위젯을 설정하면서 새 별칭을 만들려면:

1. 위젯의 연필 아이콘을 클릭해 위젯 설정을 엽니다.
2. 데이터 소스 영역으로 가서 개체 별명 탭을 선택합니다.
3. 새 별칭 이름을 입력하고 새로 별명 만들기를 클릭합니다.
4. 별칭 설정을 마치고 추가를 클릭합니다.
5. 위젯을 적용하고 저장합니다. 별칭이 만들어져 바로 할당됩니다.

위젯 설정에서 데이터 소스 영역을 열고 개체 별명 탭으로 바꾼 다음 드롭다운에서 별칭을 선택합니다. 필요한 데이터 키를 추가하고 적용합니다.

별칭을 편집하려면:

1. 대시보드를 열고 수정 모드로 바꿉니다.
2. 툴바에서 개체 별명 아이콘을 클릭합니다.
3. 바꿀 별칭 옆의 연필 아이콘을 클릭합니다.
4. 설정을 바꾸고 저장을 클릭합니다.
5. 오른쪽 아래의 저장을 클릭해 적용합니다.

별칭을 삭제하려면:

1. 대시보드를 열고 수정 모드로 바꿉니다.
2. 툴바에서 개체 별명 아이콘을 클릭합니다.
3. 지울 별칭 옆의 개체 별명 삭제 아이콘을 클릭합니다.
4. 오른쪽 아래의 저장을 클릭해 적용합니다.

대시보드 위젯에서 쓸 수 있는 별칭 유형은 다음과 같습니다.

별칭 설정 대화상자의 Resolve as multiple entities 토글은 별칭이 엔티티를 둘 이상 돌려줄 수 있는지 정합니다. 여러 엔티티를 다루는 별칭 유형(예: 개체 목록, 개체 유형)에서는 기본으로 켜지고, 엔티티 하나를 다루는 유형에서는 꺼집니다. 값 하나를 표시하는 위젯(예: Value card)은 엔티티 하나짜리 별칭으로 동작하고, 표와 차트 위젯은 보통 여러 엔티티 별칭을 씁니다.

별칭 유형	설명
단일 개체	유형과 이름으로 고른 특정 엔티티 하나로 결정됩니다.
개체 목록	직접 고른 엔티티 목록으로 결정됩니다.
개체 이름	지정한 유형의 엔티티 가운데 이름이 지정한 글자로 시작하는 엔티티 전체로 결정됩니다.
개체 유형	고객의 엔티티를 포함해 지정한 유형의 엔티티 전체로 결정됩니다.
대시보드 상태로 부터의 개체	대시보드 상태 매개변수로 전달된 엔티티로 결정됩니다.
자산 유형	지정한 자산 프로필의 자산으로 결정됩니다. 이름으로 거를 수도 있습니다.
장치 유형	지정한 장치 프로필의 장치로 결정됩니다. 이름으로 거를 수도 있습니다.
Entity View type	지정한 유형의 엔티티 뷰로 결정됩니다. 이름으로 거를 수도 있습니다.
API Usage State	플랫폼의 API 사용량 통계로 결정됩니다.
관계 질의	루트 엔티티와 관계로 연결된 엔티티로 결정됩니다. 깊이와 방향을 지정합니다.
자산 검색 질의	루트 엔티티와 관계로 연결된, 지정한 프로필의 자산으로 결정됩니다. 깊이와 방향을 지정합니다.
장치 검색 질의	루트 엔티티와 관계로 연결된, 지정한 프로필의 장치로 결정됩니다. 깊이와 방향을 지정합니다.
개체 보기 검색 질의	루트 엔티티와 관계로 연결된, 지정한 유형의 엔티티 뷰로 결정됩니다. 깊이와 방향을 지정합니다.

유형과 이름으로 고른 특정 엔티티 하나로 결정됩니다.

설정:

예: HMI 장치 하나(my device)를 거르는 별칭.

직접 고른 엔티티 목록으로 결정됩니다.

설정:

예: 선택한 HMI 장치(my device)를 표시하는 별칭.

지정한 유형의 엔티티 가운데 이름이 지정한 글자로 시작하는 엔티티 전체로 결정됩니다.

설정:

예: 이름이 “my”로 시작하는 HMI 장치를 표시하는 별칭.

고객의 엔티티를 포함해 지정한 유형의 엔티티 전체로 결정됩니다.

설정:

예: 선택한 엔티티 유형에 맞는 장치를 표시하는 별칭.

대시보드 상태 매개변수로 전달된 엔티티로 결정됩니다. 드릴다운 대시보드에서 현재 선택한 엔티티의 데이터를 표시할 때 씁니다.

사용자가 위젯과 상호작용하면(예: 표의 행 클릭) 탐색 동작이 선택한 엔티티를 이름 있는 매개변수로 다음 대시보드 상태에 넘길 수 있습니다. 이 별칭은 그 매개변수를 읽어 담긴 엔티티로 결정되므로, 대상 상태의 위젯이 사용자가 선택한 엔티티의 데이터를 자동으로 표시합니다.

설정:

예: 장치 행을 클릭하면 선택한 장치의 데이터를 보여 주는 상세 상태로 이동하는 드릴다운 대시보드.

지정한 자산 프로필의 자산으로 결정됩니다. 이름으로 거를 수도 있습니다.

설정:

예: 프로필이 “buildings”이고 이름이 “Build”로 시작하는 자산을 거르는 별칭.

지정한 장치 프로필의 장치로 결정됩니다. 이름으로 거를 수도 있습니다.

설정:

예: 프로필이 “thermometers”이고 이름이 “Therm”으로 시작하는 장치를 거르는 별칭.

지정한 유형의 엔티티 뷰로 결정됩니다. 이름으로 거를 수도 있습니다.

설정:

예: 유형이 “Compressors Entity View Type”인 엔티티 뷰를 거르는 별칭.

플랫폼의 API 사용량 통계로 결정됩니다.

설정:

예: 플랫폼 API 사용량 통계를 위젯에 표시하는 별칭.

루트 엔티티와 관계로 연결된 엔티티로 결정됩니다. 깊이와 방향을 지정합니다.

설정:

예: “Contains” 관계로 District A와 연결된 엔티티를 표시하는 별칭.

루트 엔티티와 관계로 연결된, 지정한 프로필의 자산으로 결정됩니다. 깊이와 방향을 지정합니다.

설정:

예: 루트 엔티티와 연결된, 지정한 프로필의 자산을 표시하는 별칭.

루트 엔티티와 관계로 연결된, 지정한 프로필의 장치로 결정됩니다. 깊이와 방향을 지정합니다.

설정:

예: 루트 엔티티와 연결된, 지정한 프로필의 장치를 표시하는 별칭.

루트 엔티티와 관계로 연결된, 지정한 유형의 엔티티 뷰로 결정됩니다. 깊이와 방향을 지정합니다.

설정:

예: 루트 엔티티와 연결된, 지정한 유형의 엔티티 뷰를 표시하는 별칭.