Equipment
Table of Contents
- Overview
- Screen Layout
- Top — Page Title & Tools
- Left Sidebar — Search & Filtering
- Right — Equipment Card List
- Timeline Analysis
- Use Cases
- FAQ
- Related Screens
Overview
The Equipment menu presents all registered equipment as cards at a glance. Each card includes the equipment image, connection/health/registration status indicators, today's alarm counts, tag count, and a link to the asset tree. Use the site, area, and line filters in the left sidebar to quickly narrow down to the equipment you want.
Operators use this screen to quickly determine:
- Which equipment has lost communication
- Which equipment is flagged warning/critical by health diagnostics
- Which equipment raised critical alarms today
Path: Left menu > Equipment > Equipment List (internal URL /equipment/index)
Screen Layout
┌──────────────────────────────────────────────────────────────────┐
│ 설비 총 N개 설비 — 사이트별 모니터링 [타임라인 분석] [↻] │ ← ① 상단
├──────────┬───────────────────────────────────────────────────────┤
│ 🔎 검색 │ ⚙ [검색된 설비: N] 설비 목록 │
│ 조건 입력 │ 필터 조건에 맞는 설비 │
│ 후 검색 │ ─────────────────────────────────────────────────────│
│ [사이트▼] │ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │
│ [구역 ▼] │ │ 카드 │ │ 카드 │ │ 카드 │ │ 카드 │ │ ← ③ 카드 그리드
│ [라인 ▼] │ │ ... │ │ ... │ │ ... │ │ ... │ │
│ │ └──────┘ └──────┘ └──────┘ └──────┘ │
│ [공통유형▼]│ │
│ [설명] │ │
│ [↺][검색] │ │
└──────────┴───────────────────────────────────────────────────────┘
| Area | Position | Contents |
|---|---|---|
| ① Top | Full width | Page title, total equipment count, Timeline Analysis / Refresh buttons |
| ② Left sidebar | col-lg-2 | "Search" filter panel — site/area/line + search options, with Reset and Search buttons at the bottom |
| ③ Right | col-lg-10 | Equipment card list (number of equipment found + card grid) |
Top — Page Title & Tools
| Item | Form | Contents |
|---|---|---|
| Page title | Left | "Equipment" + subtitle 총 N개 설비 — 사이트별 모니터링 |
| Timeline Analysis | Primary button, right | "Timeline Analysis" — opens the multi-equipment timeline comparison screen (openTimeline()) |
| Refresh | Secondary button, right + ↻ | Reloads only the card list, keeping the left-hand filters as they are |
When you first open the page the card list is empty; it is populated only after you set the search options in the left sidebar and click Search.
Left Sidebar — Search & Filtering
The panel is titled Search, with the subtitle "Enter conditions, then search". The form is organized into two groups, and the two buttons sit in the panel footer.
1) Site / Area / Line
The three selectors form a single group.
| Selector | ID | Options |
|---|---|---|
| Site | site_id | "All Sites" + list of registered sites (사이트명 [설명]) |
| Area | area_id | "Select Area" + list of areas in the site (자산명 [설명]) |
| Line | line_id | "Select Line" + list of lines in the area (자산명 [설명]) |
Changing the site (
changedSite()) automatically repopulates the areas (area_list) and lines (line_list) belonging to that site. Changing the area (changedArea()) populates the line selector with only the lines in that area, and changing the line (changedLine()) immediately applies that line asset to the search conditions.
2) Search Options
| Input | ID | Form | Description |
|---|---|---|---|
| Common type | common_table_type | Selector — "All Types" + list of registered common types | Narrows by the domain common type assigned to the equipment |
| Description | description | Text input — placeholder "Description keyword" | Keyword in the equipment description text |
Common type is a dropdown, not a free-text field. The list shows only the types actually registered in the system, so if the type you are looking for is missing, no equipment has been registered with it yet.
3) Panel Footer Buttons
| Button | Action |
|---|---|
| ↺ Reset | resetFilter() — clears all of the filters and options above |
| Search | search() — applies all of the filters and options above and refreshes the card list |
Right — Equipment Card List
If the search returns no results, the following message is shown.
⚙ No equipment found
Adjust the site, area, line, or search options in the left filter panel and click the Search button.
If there are results, the equipment appears as cards in the card grid (eq-card-list).
┌───────────── 우측 영역 헤더 ─────────────┐
│ ⚙ [검색된 설비: N] 설비 목록 │
│ 필터 조건에 맞는 설비 │
└────────────────────────────────────────────┘
| Header item | Contents |
|---|---|
| Header label | [검색된 설비: N] 설비 목록 — N is the number of equipment found (search_equipment_count). The count comes before the title |
| Subtitle | "Equipment matching the filter conditions" — fixed text (not a summary of the search conditions) |
Equipment Card Structure
Each card (eq-card) consists of the following areas.
┌────────────────────────────────────┐
│ 설비명 (굵게) │ ← header
│ 설비 설명 │ ← desc
├────────────────────────────────────┤
│ 📶 ❤️ 🏷 📅 🥧 │ 🟢 🟡 🔴 │ ← status (점등 5종 + 알람 3종)
├────────────────────────────────────┤
│ │
│ 설비 이미지 (썸네일) │ ← thumb (클릭 시 설비 대시보드)
│ │
├────────────────────────────────────┤
│ 생산 상태 뱃지 │ ← OEE area (active 상태)
├────────────────────────────────────┤
│ 🏷 N ⚙ │ ← footer (태그 수 / 자산 트리 이동)
└────────────────────────────────────┘
Card Top — Name & Description
| Area | Class | Contents |
|---|---|---|
| Card header | eq-card-header | Equipment name (asset_name) — bold |
| Card description | eq-card-desc | Equipment description (description) — single line of text |
Five Status Indicators
Five indicators are arranged horizontally on the left of the card status area (eq-card-status). Hovering over an indicator shows a tooltip explaining its meaning.
| Icon | ID | Tooltip | Meaning |
|---|---|---|---|
| 📶 (Wi-Fi) | ${asset_id}_status_connection | "Connection status" | Communication connection status (5 levels: connected, connection delayed, connection error, disconnected, not connected) |
| ❤️ (Heartbeat) | ${asset_id}_status_health | "Health status" | Asset health diagnostic result (4 levels: normal, caution, critical, unknown) |
| 🏷 (Tags) | ${asset_id}_status_tag_reg | "Tag registration status" | Whether tags are registered for the equipment |
| 📅 (Calendar) | ${asset_id}_status_event_reg | "Event registration status" | Whether asset event rules are registered |
| 🥧 (Pie) | ${asset_id}_status_aggregation_reg | "Aggregation registration status" | Whether asset aggregation rules are registered |
The first two and the last three use color differently.
| Indicator | Color levels |
|---|---|
| Connection status / health status | Multiple levels depending on the diagnostic result (gray = unknown, green = normal, orange = caution, red = error) |
| Tag / event / aggregation registration status | Only green or gray — green if registered, gray otherwise |
Gray on the last three does not mean something is broken. It simply means no tags, event rules, or aggregation rules have been registered for that equipment yet.
For color meanings, see Status Code Definitions.
Three Today's Alarm Counts
To the right of the status area (separated from the five indicators by a vertical divider), today's alarm counts are shown in three colors.
| Color | ID | Tooltip | Contents |
|---|---|---|---|
| 🟢 Green | ${asset_id}_count_alarm_info | "Today's information alarms" | Number of information alarms |
| 🟡 Orange | ${asset_id}_count_alarm_warn | "Today's warning alarms" | Number of warning alarms |
| 🔴 Red | ${asset_id}_count_alarm_error | "Today's critical alarms" | Number of critical alarms |
Before values arrive, all are displayed as -.
Equipment Image, Production Status & Footer
Equipment Image (eq-card-thumb)
- Displays the image registered for the equipment as a thumbnail (
/asset/image/${asset_id}) - Clicking opens
/asset/dashboard/equipment/${asset_id}in a new window — the equipment-level dashboard screen - Equipment without a registered image shows a default placeholder image
Production Status Badge (eq-oee-area)
| ID | Contents |
|---|---|
${asset_id}_status_active | The current active status (running/stopped/waiting/idle/fault) shown as a color-coded badge |
Card Footer (eq-card-footer)
| Item | Contents |
|---|---|
| 🏷 + tag count | ${asset_id}_tag_count — number of tags registered for this equipment |
| ⚙ (gear) | Opens the asset tree screen (/asset/tree/index?sel=${asset_id}) when clicked — edit asset metadata |
Timeline Analysis
The Timeline Analysis button at the top opens the multi-equipment timeline comparison screen (/timeline/index). For details, see Equipment Submenu Screens — Timeline Comparison below.
Equipment Submenu Screens (2 in addition to the list)
The Equipment section of the left menu contains three screens.
| Menu | Internal URL | Purpose |
|---|---|---|
| Equipment List (covered above) | /equipment/index | Equipment card grid monitoring |
| Data Query | /asset/data/index | Query domain data per equipment (snapshot, alarm, event, context, aggregation, command) |
| Timeline Comparison | /timeline/index | Compare multiple equipment on a shared time axis |
ISO Data (
/asset/plugin/index) is not under Equipment; it lives in the separate ISO section of the left menu — together with ISO Analysis (/analysis/index) in the same section. See ISO Data and Analysis for details.
Data Query Screen (/asset/data/index)
A screen for querying domain data per equipment, in one of six categories.
Top Search Area
📋 데이터 조회 [기간] [데이터 유형 ▼] [시간 단위 ▼] [건수 ▼] [조회][전체 출력][↻]
| Control | Width | Description |
|---|---|---|
Period (search_time) | 280px | Start–end (centered, bold). Hidden search_date_from/search_date_to |
Data type (data_type) | 120px | 6 options — snapshot, alarm, event, context, aggregation, command |
Time unit (time_unit) | 110px | Grouping by second/minute/hour/day |
Row count (limit) | 140px | Most recent 100 (default)/1,000/2,000/5,000/10,000 rows |
| Query / Export All / Refresh | Red | search() / downloadCSV() / refresh() |
Six Data Types
| Code | Label | Description |
|---|---|---|
DATA | Snapshot | Tag values sampled at fixed intervals |
ALARM | Alarm | Alarm history for that asset |
EVENT | Event | Asset-level events (status changes, etc.) |
CONTEXT | Context | Points in time when the asset status changed (running/stopped/fault) |
AGGREGATION | Aggregation | Aggregation results per time unit (average, sum, etc.) |
COMMAND | Command | History of commands issued to the asset |
Left (col-lg-2) — Asset Tree Panel
Same as other equipment analysis screens: site selector, asset tree, search, footer (asset ID preview).
Right (col-lg-10)
1) Count-by-Time Chart (hourly_chart, 140px)
| Item | Description |
|---|---|
| Header | 📊 "Count by Time" + result summary (result_txt) |
| Chart | Bar chart by time period for the selected data type |
| Empty state | "Select equipment in the asset tree and run a query." |
2) Query Result Table (data_table)
The table header changes dynamically according to the data type.
Default (snapshot) columns:
| Column | Width | Description |
|---|---|---|
| Time | 200px | Measurement time |
| Asset ID | 150px | Asset identifier |
| Data map | 250px | JSON of tag-value pairs |
| Timestamp map | 250px | Arrival time of each tag |
When the data type is changed to ALARM/EVENT/CONTEXT/AGGREGATION/COMMAND (onDataTypeChange()), the header is redrawn with the columns matching that type.
Timeline Comparison Screen (/timeline/index)
A screen that overlays the domain events (context/aggregation/event/command) of multiple equipment on a single time axis for comparison.
Top Search Area
🔁 타임라인 비교 [기간] [타임라인 유형 ▼] [알람 표시 ▼] [건수 ▼] [조회][전체 출력][필터][↻]
| Control | Width | Description |
|---|---|---|
Period (search_time) | 280px | Start–end |
Timeline type (timeline_type) | 140px | 4 options — context (CONTEXT) / aggregation (AGGREGATION) / event (EVENT) / command (COMMAND) |
Show alarms (show_alarm) | 140px | Show (Y) / Hide (N, default) |
Row count (limit) | 140px | 100/200/300/500/1,000 rows |
| Query | Red + 🔍 | search() |
| Export All | Red + 📄 | downloadCSV() |
Condition filter (condition_button) | Red + 🎚️ | Data query condition options (hidden by default, expand with conditionOption()) |
| Refresh | Red + ↻ | — |
Condition Input (Optional)
| Input | Description |
|---|---|
condition (350px, hidden by default) | placeholder: SQL-like condition in the form 컨디션 : VALUE > 10 AND VALUE < 50 AND QUALITY = 192 |
Left (col-lg-2) — Asset Tree
The same tree panel as on other screens (Asset / Connection tabs).
Right (col-lg-10) — Timeline
| Item | Description |
|---|---|
| Header | 🕐 "Timeline" + result summary (result_txt) |
| Quick time ranges | 6 buttons (10M/30M/1H/6H/12H/ALL) |
| Timeline area | The assets checked in the left tree, shown as color bars on the same time axis |
Usage
Use this to compare running/stopped patterns across multiple equipment at once, or to analyze time differences in status changes between equipment on the same line. Turning on alarm display also shows alarm markers at the same points in time, making cause-and-effect analysis easier.
Asset-Level Dashboard (/asset/dashboard/{level}/{asset_id})
Clicking an equipment card's image opens that asset's detailed dashboard in a new window. A different dashboard screen is provided for each of the four asset hierarchy levels (site/area/line/equipment).
| Level | Internal URL | Purpose |
|---|---|---|
| Site | /asset/dashboard/site/{site_id} | Site-wide KPIs + summary of all lines |
| Area | /asset/dashboard/area/{asset_id} | Overview of lines and equipment within the area |
| Line | /asset/dashboard/line/{asset_id} | All equipment on the line in a single view |
| Equipment | /asset/dashboard/equipment/{asset_id} | Comprehensive dashboard for a single piece of equipment (most detailed) |
Equipment Dashboard (Most Detailed) — Screen Layout
Top — Dashboard Title Bar
[로고] | 설비명 [▼ 다른 설비] [↻실시간] [<date>] [↻] [✕닫기]
사이트 / 구역 / 라인 / 설비 (브레드크럼)
| Area | Description |
|---|---|
| Other equipment dropdown | "Go to other equipment at this location" — list of other equipment on the same line (equip_list) |
| Real-time toggle | Clicking enables/disables the rotating icon |
Date picker (sandbox-container) | Select a date — the screen refreshes with that day's data |
| Previous/Next day | ← → buttons to move between dates |
| Refresh | pageRefresh() |
| Close window | self.close() — for new-window mode |
| Breadcrumb | Shows the site → area → line → equipment path |
Left col-lg-8 — Main Panels
Panel 1 — Asset Information (3px blue border)
| Area | Contents |
|---|---|
| Header | 📺 Equipment name + (registration date, modification date) |
| Status indicators | Asset status (asset_status) + connection status (connection_status) — color-coded |
| Image | Asset image or SVG drawing (640×320) |
| OEE mini table | Operational metadata for that date (work order, product, shift, etc.) shown in a rounded table |
Panel 2 — Asset Timeline and Data
| Item | Description |
|---|---|
| Header | 📊 "Asset Timeline and Data" + result summary (result_txt) |
| Go to timeline | Button on the right — opens the Timeline Comparison screen |
| Timeline area | Time bars of that date's asset events (context/aggregation/event/command) |
Panel 3 — Tags and Trend Chart
| Item | Description |
|---|---|
| Header | 📈 "Tags and Trend Chart [Total tags: N]" |
| Go to tag list | Button on the right — opens the Tag List screen |
| Empty state | "Select the tags to display from the tag list on the left." |
| Chart | Time series chart of the selected tags |
Panel 4 — Three KPI Mini Charts
| Chart | Description |
|---|---|
| (Left) OEE | OEE trend for that date — empty state "No data to display." |
| (Center) RAM | Reliability/maintainability trend |
| (Right) EMS | Energy consumption trend |
Panel 5 — Equipment Status
| Area | Description |
|---|---|
| Header | 🔋 "Equipment Status [Total alarms: N]" |
| Equipment operating status donut | RUN/IDLE/STOP/FAULT ratios |
| Alarm distribution | Alarm counts by priority |
Panel 6 — Recent Equipment Alarm List
| Item | Description |
|---|---|
| Header | 🔔 "Recent Equipment Alarm List" |
| Advanced alarm search | Button on the right — opens Advanced Alarm Search |
| List | The N most recent alarms in reverse chronological order |
Right col-lg-4 — Side Panel
Asset-level supplementary information panels are stacked vertically.
| Panel | JSP | Contents |
|---|---|---|
| Alarm | pannel/alarm.jsp | Asset-level alarm summary |
| Context | pannel/context.jsp | Asset context (current operating status) |
| Aggregation | pannel/aggregation.jsp | Asset aggregations (average/max/min) |
| Event | pannel/event.jsp | Asset event history |
| Command | pannel/command.jsp | History of commands issued to the asset |
Differences in the Site/Area/Line Dashboards
Higher-level dashboards present a consolidated view of child assets.
| Level | Difference |
|---|---|
| Site | Aggregated KPIs of all lines, donut charts, list of child assets |
| Area | Consolidated operating status of the lines and equipment in that area |
| Line | All equipment on the line in a single grid view |
No separate detailed manual is provided; they follow the same pattern as this asset (equipment) dashboard, so once you are familiar with it, the other levels will come naturally.
Usage Patterns
| Analysis flow | Screen flow |
|---|---|
| Field operator monitoring screen | Equipment dashboard → open full screen in a new window → field display |
| Detailed analysis right after a fault | Equipment card → dashboard → select date → combined analysis of timeline + trends + alarms |
| Quick comparison with other equipment | Equipment dashboard → other-equipment dropdown at top right → another piece of equipment on the same line |
Use Cases
| Scenario | How to use |
|---|---|
| Site-level night inspection | Select the night-shift site in the site selector → Search → quickly identify only the cards with red indicators (disconnected / critical alarms) |
| Equipment status on a specific line | Narrow down site → area → line and search → all equipment on the line in one view |
| Monitoring by equipment type | Select a type in the "Common type" dropdown under search options → search only that family |
| Identifying assets with an alarm surge | Use sorting and filtering to check the cards with the highest red alarm counts first |
| Identifying equipment by image | Match visually and quickly using the card thumbnails |
| Editing asset metadata | Use the ⚙ button in the card footer to go to the asset tree screen |
FAQ
Q. I opened the page but the cards are empty. A. The search results are empty when you first open the page; cards appear only after you click the Search button in the left sidebar. You can also just click Search with the site left as "All Sites".
Q. I selected a site but the area selector is empty. A. Either no areas are registered for that site, or the areas were not loaded when the page opened. Change the site selector once more and the area list will be repopulated. If there really are no areas, register them under Factory Management > Model.
Q. All the indicators on a card are gray. A. No tags/events/aggregations are registered for that equipment, or no communication has ever been received. First check in Factory Management > Tags whether tags are registered.
Q. All alarm counts show -.
A. Alarm data has not loaded yet. Wait a moment or click the refresh button at the top right. If they still do not appear, check on the Alarm screen whether that equipment has raised any alarms.
Q. I only see a placeholder where the equipment image should be. A. No image is registered for that equipment. You can select the equipment in the asset tree screen and upload an image.
Q. Where does clicking a card take me? A. Clicking the image area opens that equipment's single-equipment dashboard in a new window. The ⚙ button in the card footer opens the asset tree editing screen.
Q. There are too many search results and the screen is slow. A. Narrow down in the order site → area → line, and also use the "Equipment common type" search option to reduce the results.
Q. Can I change the sort order of the search results? A. The screen displays equipment in asset tree registration order. If you need a different order, adjust it in the asset tree screen.
Q. I want to compare the operating times of several pieces of equipment at once. A. Use the Timeline Analysis button at the top to open the multi-equipment comparison screen.
Related Screens
- Factory Management — registering sites, areas, lines, equipment, and the asset tree
- Data Points — querying tag data trends for equipment
- Alarm — equipment-level alarm history
- Daily Statistics — comparative analysis by site, area, line, and equipment
- Status Code Definitions — color mapping for the 5 connection states and 4 health states
- Dashboard — equipment connection/health heat map (all equipment at a glance)