Page History

...

MCP Tools and Tables

Category	Items
Tools	`get_table_schema`, `write_objects`, `get_objects`, `list_elements`, `list_dynamics`, `browse_runtime_properties`
Tables	`DisplaysList`, `DisplaysSymbols`, `DisplaysLayouts`

Critical: Use DisplaysList for creating and editing displays. DisplaysDraw is the Designer visual editor UI — NOT a writable table.

...

DashboardDisplay defines the grid: Columns and Rows arrays (use "*" for proportional sizing)
Each Cell references Row/Col (0-based) and contains a Content element
No Left/Top needed — elements auto-fill their cell
ColSpan/RowSpan for multi-cell elements
Cell.HeaderLink adds a header label to the cell
For all controls and symbols verity and change as needed the Height and Widith it will be used.
For Symbols modify the height and width proportional to original size, so its resized nicely.

Browse available symbols:

...

Use list_elements('ThemeColors') for available named theme brushes (StateOK, StateAlarm, Water, AlarmHighPriority, etc.).

Mistake	Why It Happens	How to Avoid
Using `DisplaysDraw` as table_type	Confused with `DisplaysList`	`DisplaysDraw` is the visual editor UI, not a writable table
Omitting PanelType	Defaults silently to Canvas	Always set PanelType explicitly
Using `@Label.` in display elements	Confused with symbol definitions	`@Label.` is only for DisplaysSymbols internals. Use `@Tag.` when placing symbols
Not discovering dynamics first	Doesn't know what's available	Call `list_dynamics()` with no parameter to see all dynamic types
Screenshots for self-validation	Habit from other tools	Trust `write_objects` success. User sees live updates
Setting colors without clearing theme	Theme overrides custom colors	Set value AND clear theme: `{Fill: '#FF3498DB', FillTheme: ''}` — or just omit to use themed defaults
Sending partial display content	Forget it's a document object	Always read-modify-write for existing displays
Canvas positioning in Dashboard	Mixing layout paradigms	Canvas uses Left/Top + Elements; Dashboard uses Row/Col + Cells
Referencing symbols with wrong path	Incomplete library path	Browse with `list_elements('Symbol/HMI')` to get exact paths
Guessing dynamic property names	Different dynamics have different schemas	Always call `list_dynamics('DynamicTypeName')` for exact schema
CodeBehind in wrong Contents format	Missing language prefix	Contents must start with `CSharp\r\n` or `VBdotNet\r\n` before code

Display Action	Tool Call
Get display schema	`get_table_schema('DisplaysList')`
Get Canvas structure	`list_elements('Canvas')`
Get Dashboard structure	`list_elements('Dashboard')`
Get element schema	`list_elements('ElementName')`
Browse all dynamics	`list_dynamics()`
Get specific dynamic schema	`list_dynamics('FillColorDynamic')`
Browse symbols	`list_elements('Symbol/HMI')` or `list_elements('Library')`
Browse Wizard symbols	`list_elements('Wizard')`
Read existing display	`get_objects('DisplaysList', names=['PageName'], detail='full')`
Write display	`write_objects('DisplaysList', data=[...])`
Navigate Designer to display	`designer_action('navigate', 'Display.PageName')`
Browse runtime properties	`browse_runtime_properties('Client')`

Server-side logic, tag calculations, CodeBehind patterns: Load the Scripts and Expressions skill — search_docs('scripts', labels='skill')
New solution from scratch: Load the New Solution skill — search_docs('new solution', labels='skill')
Specific protocol connectivity: Use list_protocols() to browse, then search_docs('modbus', labels='connector') for protocol-specific docs
Advanced symbol creation: search_docs('custom symbols', labels='tutorial') for building reusable parameterized symbols