Skip to main content

Dashboard Content Settings

Manage HMI pages and dashboard content for presentations.

Overview

Dashboard Content Settings provides a central location to manage all HMI pages and content that can be used in public presentations and dashboards.

Navigation: Settings → Dashboard Settings → Content Settings

Or directly: /Settings/DashboardSettings#!/content-settings-list

Content List

The main view displays all content pages:

ColumnDescription
NameContent name
DescriptionBrief description
EnableActive status
OrderDisplay priority
TypeContent type (Drw = HMI)
ActionsPreview, Edit, Delete, Duplicate

Creating Content

Add HMI Page

  1. Click the Add (+) button
  2. Fill in the form:
FieldRequiredDescription
NameYesDisplay name
DescriptionNoBrief description
EnableYesActive status
OrderNoSort priority
Content TypeYesSelect "HMI Page"
HMI Project NameYesxDraw project folder
HMI Page NameYes.drwx filename (no extension)
Template NameYesMust be hmi
  1. Configure xView connection:
FieldDescriptionExample
Remote HostxView server IP127.0.0.1
Remote PortxView server port1001
Data Source TypeConnection methodSocket (0)
  1. Click Save

Content Configuration

Basic Information

FieldDescription
NameIdentifies the content in lists
DescriptionShows in tooltips and details
EnableOnly enabled content appears in presentations
OrderLower numbers sort first

HMI Settings

FieldDescriptionExample
HMI Project NameFolder in TSWebAssets/resources/hmi/BEM-Solar
HMI Page NameFilename without .drwx extensionbem-monitor
Template NameRoute templatehmi

xView Connection

FieldDescriptionDefault
Remote HostxView server IP addressFrom system settings
Remote PortxView TCP port1001
Data Source Type0 = Socket, 5 = Simulator0
important

Remote Host and Remote Port must be set for real-time data to work in public presentations.

Content Types

HMI Page (ContentType = 2)

Displays .drwx files created in xDraw.

File Location:

TSWebAssets/resources/hmi/{ProjectName}/{PageName}.drwx

Example:

  • Project: BEM-Solar
  • Page: bem-monitor
  • Path: TSWebAssets/resources/hmi/BEM-Solar/bem-monitor.drwx

Dashboard (ContentType = 1)

Widget-based layouts (not covered here).

URL (ContentType = 3)

External webpage embed (not covered here).

File Management

.drwx File Structure

HMI pages are stored as .drwx files (XML format):

TSWebAssets/
└── resources/
└── hmi/
└── {ProjectName}/
├── page1.drwx
├── page2.drwx
└── assets/
└── images/

Creating New Projects

  1. Create folder in TSWebAssets/resources/hmi/
  2. Add .drwx files from xDraw
  3. Create content records pointing to the files

Verifying Files

Check that files exist:

ls TSWebAssets/resources/hmi/{ProjectName}/

Editing Content

Edit Basic Settings

  1. Click the Edit (pencil) icon
  2. Modify fields as needed
  3. Click Save

Change xView Connection

  1. Edit the content
  2. Update Remote Host and/or Remote Port
  3. Save and test the preview

Update HMI Page

  1. Replace the .drwx file in the resources folder
  2. No database change needed if filename stays the same
  3. Refresh browser to see changes

Deleting Content

  1. Click the Delete (trash) icon
  2. Confirm deletion
warning

Deleting content removes it from all presentations that reference it.

Bulk Operations

Update xView Settings for All

UPDATE dashboardcontent
SET RemoteHost = '192.168.1.100', RemotePort = 1001
WHERE ContentType = 2 AND RemoteHost IS NULL;

Enable All Content

UPDATE dashboardcontent SET Enable = 1 WHERE Enable = 0;

Best Practices

Naming Convention

Use consistent naming:

  • Project Name: Company-Location (e.g., BEM-Solar)
  • Page Name: purpose-detail (e.g., bem-monitor, bem-video)
  • Content Name: Human readable (e.g., "BEM Solar Monitor")

Organization

  1. Group related pages in same project folder
  2. Use meaningful descriptions
  3. Set order values for logical sorting

Testing

  1. Always preview content after creation
  2. Test xView connection before using in presentations
  3. Verify video and banner codes are correct

Troubleshooting

Content Not Appearing

  • Check Enable is set to 1
  • Verify TemplateName is hmi
  • Ensure .drwx file exists at expected path

Real-time Data Not Working

  • Set Remote Host and Remote Port
  • Verify xView server is running
  • Check server logs for connection errors

Video/Banner Not Loading

  • Confirm VideoSourceCode/BannerContentCode in .drwx
  • Check corresponding records exist in videosource/bannercontent tables
  • Test video/banner settings independently

Database Reference

Table: dashboardcontent

CREATE TABLE dashboardcontent (
ID INT AUTO_INCREMENT PRIMARY KEY,
Name VARCHAR(255),
Description VARCHAR(255),
Enable BIT(1) DEFAULT 1,
Ord INT DEFAULT 0,
ContentType INT, -- 2 = HMI Page
Code INT,
HMIProjectName VARCHAR(100),
HMIPageName VARCHAR(100),
TemplateURL VARCHAR(255),
TemplateName VARCHAR(100), -- Must be 'hmi'
RemoteHost VARCHAR(100), -- xView IP
RemotePort INT, -- xView Port
HMIDataSourceType INT -- 0 = Socket
);