Navigating RuntimeWeb
RuntimeWeb is the run-time display client for viewing SAMMI pages with live data. This guide covers the UI layout and navigation.
Screen Layout
┌─────────────────────────────────────────────────┐
│ Menu Bar │ Page Title │ Connection Status │
├─────────────────────────────────────────────────┤
│ Command Toolbar (icons for window management) │
├─────────────────────────────────────────────────┤
│ │
│ Page Canvas │
│ (DDOs, static objects, background) │
│ │
│ │
└─────────────────────────────────────────────────┘
Menu Bar
The menu bar at the top shows:
- Kinesix logo — upper-left branding
- Page title — name of the currently loaded page
- Connection indicator — shows Gateway connection status (green = connected, red = disconnected)
Command Toolbar
The command toolbar provides window management icons:
| Icon | Action | Description |
|---|---|---|
| Add Window | Open a new page | Enter a page name to load |
| Delete Window | Close current page | Closes the active display |
| Restore | Restore window | Returns to normal view |
| Minimize | Minimize window | Minimizes the display |
| Refresh | Reload page | Reloads current page data |
| Logoff | Disconnect | Ends the session |
Page Canvas
The main area renders the SAMMI page:
- Static objects are drawn first (background layer)
- Dynamic objects (DDOs) are drawn on top with live data
- Objects are positioned exactly as defined in the page layout
- The canvas size matches the page’s configured dimensions
Zooming and Scrolling
- Zoom in/out:
Ctrl+Scrollwheel - Pan: Scroll bars appear when the page exceeds the viewport
- Reset zoom: Click the zoom percentage indicator
Interacting with DDOs
Some DDOs accept user input at runtime:
- Push Buttons — click to trigger commands
- Toggle Buttons — click to change state
- Sliders — drag to set values
- Spin Buttons — click arrows to increment/decrement
- Text inputs (Real, Integer, Alphanumeric) — click and type to enter values, press Enter to submit
Read-only DDOs display data but don’t accept clicks:
- Meters, Gauges, Thermometers, Progress Bars
- Trends, Plots, Bar Charts, Pie Charts
- Alarms, Annotated Text, Scroll Displays
Multi-Page Workflows
SAMMI pages can link to each other:
- Push Button actions can open other pages (Add Window command)
- Region DDOs embed sub-pages within the current page
- Notebook DDOs provide tabbed containers for multiple sub-pages
- Command toolbar Add Window opens pages by name
Connection Status
RuntimeWeb connects to the SAMMI Gateway via WebSocket:
| Status | Meaning |
|---|---|
| Connected (green) | Receiving live data updates |
| Disconnected (red) | No Gateway connection — DDOs show last known or default values |
| Reconnecting | Attempting to re-establish connection automatically |
Tips
- RuntimeWeb automatically reconnects if the Gateway restarts
- Multiple browser tabs can view different pages simultaneously
- Pages render correctly without live data — useful for layout verification
- Use
F11for full-screen kiosk-style display