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)          │
│                                                 │
│                                                 │
└─────────────────────────────────────────────────┘

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:

IconActionDescription
Add WindowOpen a new pageEnter a page name to load
Delete WindowClose current pageCloses the active display
RestoreRestore windowReturns to normal view
MinimizeMinimize windowMinimizes the display
RefreshReload pageReloads current page data
LogoffDisconnectEnds 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+Scroll wheel
  • 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:

StatusMeaning
Connected (green)Receiving live data updates
Disconnected (red)No Gateway connection — DDOs show last known or default values
ReconnectingAttempting 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 F11 for full-screen kiosk-style display

See Also