Console Navigation and Common Screens
Table of Contents
- Overview
- Overall Screen Frame
- Top Bar
- Domain-wide Search
- Left Menu Structure
- Real-time Notifications and Toasts
- Common Screen Patterns
- Recommended Operating Workflow
- Permissions and Menu Visibility
- Frequently Asked Questions
- Related Screens
Overview
This document describes the console frame shared by every screen after login. The current console consists of a top domain search, a real-time toolbar on the right, a left task-group menu, and a body area built from cards, charts, and tables.
The complete menu map and workflow diagram are available at a glance in Full Menu Structure and Operating Flow.
Operators typically follow this flow.
- Check the site map, pipeline, KPIs, and infrastructure health on the Dashboard.
- Click an abnormal KPI to drill down into Connection Status, Alarms, Equipment, or Daily Statistics.
- Use the top domain search to look up a site, asset, tag, OPC, edge, flow, or alarm configuration ID and jump straight to its detail screen.
- Watch the LIVE indicator, alarm badge, and toasts in the top right for new abnormal signals.
The "Summary" landing screen from older documentation is now called the Dashboard in the current UI. The internal URL remains
/map/index.
Overall Screen Frame
┌──────────────┬────────────────────────────────────────────────────────────┐
│ PlantPulse │ ☰ [도메인 검색 사이트 / 에셋 / 태그 / OPC / ... CTRL+K] │
│ 좌측 메뉴 │ [LIVE] [알람] [전체] [설정] [매뉴얼] [사용자] │
├──────────────┼────────────────────────────────────────────────────────────┤
│ Overview │ 페이지 제목 / 현재 업무 설명 │
│ Connectivity │ ┌────────────────────────────────────────────────────────┐ │
│ Factory │ │ 지도·카드·차트·테이블·트리·드로어 등 선택 화면 본문 │ │
│ ... │ └────────────────────────────────────────────────────────┘ │
└──────────────┴────────────────────────────────────────────────────────────┘
| Area | Role |
|---|---|
| Top bar | Menu collapse, global domain search, LIVE status, alarms, full screen, preferences, manual, user menu |
| Left menu | Task-group menu based on the actual server web nav-role/admin.jsp |
| Body header | Page title, current site/task context, query, refresh, and navigation buttons |
| Body area | Maps, cards, charts, tables, trees, detail panels |
| Toast area | Briefly displays real-time diagnostic and alarm events in the top right |
Top Bar
The top bar behaves identically on every screen.
| Order | Element | Usage |
|---|---|---|
| 1 | Menu toggle | Collapses or expands the left menu. Use it to free up body space on narrow screens. |
| 2 | Domain search | Open by clicking or with Ctrl+K / Cmd+K on Mac. Searches domain IDs across the entire console. |
| 3 | LIVE status | WebSocket connection status. The LIVE dot pulses when the connection is healthy. |
| 4 | Alarms | Shows the recent alarm count and a preview. The menu footer links to Alarms. |
| 5 | Full screen | Toggles browser full-screen mode. |
| 6 | Preferences | Opens user display settings such as screen scale, alarm popups, and diagnostic log display. |
| 7 | Manual | Opens the GitBook manual in a new tab. |
| 8 | User menu | Provides profile, password change, and logout. |
The top search differs from the per-screen search forms. A per-screen search filters the current list, while domain search finds key IDs across the whole console and navigates to the detail screen.
Domain-wide Search
Domain search calls /api/v4/domain/search and shows the results in a DataTable. Clicking an ID cell copies it to the clipboard, and the action button navigates to the detail screen for that domain.
Search Targets
| Domain | Example | Navigates to |
|---|---|---|
| SITE / AREA / LINE | S1_LOTTE_CS_DJ_SITE | Dashboard, asset tree, model |
| EQUIPMENT / ASSET | ASSET_LINE_01 | Asset tree, equipment detail |
| TAG | TAG_EDGE_00303_90000 | Tags, data query, trend |
| OPC | OPC_MAIN_01 | Connection detail |
| EDGE | EDGE-303 | Edge detail |
| ALARM_CONFIG | Alarm configuration ID | Advanced EQL alarms |
| FLOW | Flow ID | Flow list / editor |
| USER / SECURITY | User or security policy ID | System and security management |
| EMPLOYEE / CUSTOMER / PRODUCT | Production master ID | Production management screens |
Using Search Results
| Action | Result |
|---|---|
Ctrl+K / Cmd+K | Opens the domain search dialog regardless of which input field has focus. |
| Click a domain chip | Filters to that domain only. |
| Click an ID | Copies the ID to the clipboard. |
| Click the detail button | Navigates to the detail or list screen for that domain. |
| Click a recent search term | Runs the search again with the same keyword. |
Searching an ID seen in an alarm message or diagnostic toast during operation dramatically shortens the time it takes to reach the object at fault.
Left Menu Structure
The current left menu follows the order below, based on the server web's unified menu rendering. Group names are shown in English, while the individual menu names appear as Korean labels.
Overview
| Menu | Internal URL | Purpose |
|---|---|---|
| Dashboard | /map/index | Site map, data pipeline, platform health, key KPIs |
| Statistics | /statistics/index | Annual heatmap and operating statistics for the selected day |
Connectivity
| Menu | Internal URL | Purpose |
|---|---|---|
| Protocols | /connect/index | Register data sources such as OPC/PLC/Modbus/DB/API |
| Connection Status | /connect/status | Monitor all connections for normal, delayed, abnormal, disconnected, and unconnected states |
| Edge | /edge/index | Field edge device status and detailed control |
Factory Model
| Menu | Internal URL | Purpose |
|---|---|---|
| Model | /model/index | Site, area, line, and equipment hierarchy model |
| Assets | /asset/tree/index | Asset tree and detailed properties |
| Tags | /tag/index | Collection tag definitions and status |
| Ontology | /ontology/index | Semantic model and relationship definitions |
| Metadata | /metadata/index | Extended attributes per domain |
| Master Data | /basedata/index | Operating reference values and common codes |
Production
| Menu | Internal URL | Purpose |
|---|---|---|
| Customers | /customer/index | Customer master |
| Products | /product/index | Product master |
| Employees | /employee/index | Operator and person-in-charge information |
| Shift Schedule | /calendar/index | Shifts and operating schedules |
| Work Orders | /order/index | Production work orders |
Equipment
| Menu | Internal URL | Purpose |
|---|---|---|
| Equipment List | /equipment/index | Equipment cards and entry to per-equipment dashboards |
| Data Query | /asset/data/index | Query collected data by asset and tag |
| Timeline Comparison | /timeline/index | Compare tags and equipment on a shared time axis |
ISO
| Menu | Internal URL | Purpose |
|---|---|---|
| ISO Data | /asset/plugin/index | Per-equipment source data for OEE/RAM/EMS calculations |
| ISO Analysis | /analysis/index | KPI analysis based on ISO 22400 |
Data
| Menu | Internal URL | Purpose |
|---|---|---|
| Stream | /stream/index | Real-time time series streaming charts |
| Trend | /storage/index | Tag time series trends and sampling analysis |
| Snapshot | /snapshot/index | Time series snapshots by interval |
| Data Export | /data/index | Query tag time series data and export to CSV |
| Objects (BLOB) | /blob/store | Storage for images, documents, and binary files |
Alarm
| Menu | Internal URL | Purpose |
|---|---|---|
| Alarms | /alarm/index | Real-time alarm list. Info, warning, and critical count badges appear in the left menu |
| Advanced Alarm Search | /alarm/advsearch/index | Search by period, tag, status, and priority |
| Alarm Visual Analysis | /alarm/analysis/index | Matrix, heatmap, ranking, and trend analysis |
| Advanced EQL Alarms | /alarm/config/index | EQL-based alarm rule configuration |
Visualization
| Menu | Internal URL | Purpose |
|---|---|---|
| Canvas | /canvas/index | SVG-based field monitoring screens |
Automation
| Menu | Internal URL | Purpose |
|---|---|---|
| Flows | /flow/index | Automation graph list and editor. An error count badge appears in the left menu |
| Flow Execution History | /flow/log | Flow execution logs and failure history |
| EQL Queries | /query/index | Run real-time event queries |
| Statements | /statement/index | Manage deployed EQL statements |
A separate Triggers menu is currently disabled in the unified menu. Triggers are handled as nodes inside Flow graphs or in the statement context of the EQL Help.
Standard
| Menu | Internal URL / External Port | Purpose |
|---|---|---|
| Namespace | /uns/tree | Unified Namespace hierarchy and Kafka/MQTT/SparkplugB topic preview |
| Catalog | /catalog/index | Data catalog |
| OPC-UA | http://[현재호스트]:12780 | Opens the OPC-UA standard tools in a new window. |
| AAS V3 | http://[현재호스트]:8091/ui/ | Opens the AAS V3 UI in a new window. |
System
| Menu | Internal URL / External Port | Purpose |
|---|---|---|
| Users | /user/index | User account management |
| Security Policy | /security/index | Password and access security policies |
| API Tokens | /token/index | API tokens for external integration |
| Monitoring | /monitoring/index | Infrastructure health, pipeline, and engine metrics |
| Diagnostics | /diagnostic/index | System diagnostic events |
| Logs | /log/index | Application logs |
| Settings | /config/index | System key-value settings |
| Environment Info | /env/view | View environment settings by property |
| Cluster | /cluster/index | Cluster node status |
| HA | /ha/index | High availability configuration status |
| Audit | /audit/index | Audit logs |
Real-time Notifications and Toasts
Toasts in the top right briefly show new diagnostic events or equipment status changes.
진단 · 192.168.0.41
설비 상태 변경 - 설비=[ASSET_DJ_M_16_2], RUN -> FAULT
| Item | Meaning |
|---|---|
| Title | Notification type and the device or module involved |
| Body | Summary of the status change, alarm content, or diagnostic message |
| Color | Highlighted according to info, warning, or critical severity |
| Follow-up | Track alarms in Alarms, equipment status in Equipment, and system events in Diagnostics |
A toast is only a signal. Before taking action, verify the time, target ID, and detailed log on the relevant screen.
Common Screen Patterns
Status Colors
| Color | General meaning | Example |
|---|---|---|
| Green | Normal | Connection normal, infrastructure UP, equipment health normal |
| Orange | Caution / delay | Connection delay, warning alarm, processing delay |
| Red | Abnormal / critical | Connection abnormal, critical alarm, engine error |
| Gray | Unconnected / unknown | No data, no collection history yet |
Refer to Status Code Definitions for the exact meaning of each code.
Lists and Details
Most task screens follow a top search → list table → click row for details pattern.
| Step | Description |
|---|---|
| Select search conditions | Period, site, status, keyword, number of rows |
| Query | Refreshes the list or cards with the current conditions |
| Click a row | Opens the detail screen or drawer for that domain |
| Refresh | Re-runs the previous query when real-time values look suspect |
Time Ranges
The alarm, diagnostic, log, and data query screens offer quick time ranges.
| Button | Purpose |
|---|---|
10M / 30M | Track a fault that just occurred |
1H / 6H / 12H | Analyze the current day's shift periods |
ALL | Show the full period of the search conditions |
Recommended Operating Workflow
Start of Shift
- On the Dashboard, check the communication connection rate, today's collection, today's alarms, equipment operating rate, equipment availability, and OEE.
- Check the map for red or orange sites or connection status chips.
- Check the cache, WS, MQTT, Kafka, event DB, and time series status on the health rail at the right.
- Compare yesterday's and today's collection and alarm volumes in Daily Statistics.
When an Alarm Occurs
- Check for new alarms via the toast in the top right or the alarm badge.
- In Alarms, narrow the period and site and open the details.
- Enter the tag or asset ID in domain search to jump to the equipment or data query screen.
- For recurring alarms, review Advanced EQL Alarms, Flow, and EQL Help to inspect the rule and automation status.
Connection Problems
- Click the connection rate card or the map status chip on the Dashboard.
- Find delayed, abnormal, or disconnected targets in Connection Status.
- If the edge device appears to be the problem, drill down into the Edge details.
- Check Diagnostics for diagnostic events in the same time window.
Permissions and Menu Visibility
The left menu is identical regardless of role. All three roles see the same menu list.
Permission differences appear inside the screens, not in the menu. You may be able to open a menu but still be blocked from viewing, editing, deleting, or controlling, depending on your role and the server security policy.
| Role | General scope |
|---|---|
| ADMIN | Full operation, configuration, security, and system management |
| API | Account for external system integration. A security policy is assigned alongside it |
| USER | View-oriented. No modification rights |
If a function is blocked due to missing permissions, request a role change from your security administrator. For details on account management, see Security Management.
Frequently Asked Questions
Q. I can't find the old "Summary" menu.
A. Since the UI redesign, the landing screen menu is named Dashboard. The internal URL is unchanged at /map/index.
Q. The time series engine and SQL items are gone from the 도구 menu.
A. The only external items that open in a new window from the left menu are OPC-UA and AAS V3 under Standard. For general time series queries, use the Trend, Data Export, and Snapshot screens in the Data group.
Q. The menu is visible, but there is no save button or it is blocked when clicked.
A. The menu list is displayed identically for all roles; what you can actually do is determined inside the screen by your role. If you need permissions, request a role change from the Security Management administrator.
Q. I searched for data using the top search, but the current table did not change.
A. The top search is for global domain navigation. To filter the current table, use the search form at the top of each screen's body.
Q. The toast disappeared — can I see its content again?
A. View alarms again in Alarms, system events in Diagnostics, and detailed application logs on the log screen under System.
Q. The left menu is not visible.
A. Click the menu toggle at the top left. On narrow browser widths, it may be collapsed automatically.
Related Screens
- Login — Access, sessions, and menu differences by role
- Full Menu Structure and Operating Flow — Complete menu map and entry flows by situation
- Dashboard — The landing screen after login and how to read its KPIs
- Daily Statistics — Operating statistics by date
- Connection Management — Protocols, connection status, edge
- UNS — Unified Namespace and topic preview
- Status Code Definitions — Connection, health, alarm, and production status codes