How do I Create multiple containers for a multi-monitor setup?

ClearSCADA versions prior to version 2014 R1 allowed multiple ViewX instances to be created on the same client PC for use with multiple monitor set-ups.  These multiple instances of ViewX were known as "heads".  Starting with ClearSCADA 2014 R1 the configuration of multiple ViewX instances has been modified and the term changed from "heads" to "containers".  This article describes how to configure multiple ViewX "containers" on a single client system with multiple monitors.

Note: The format for the StartupConfiguration.xml file changed after ClearSCADA 2015.  Therefore, there are two examples shown below: one example for ClearSCADA 2014/2015 and a second example for ClearSCADA 2017 R2 and newer.


1) Create a StartupConfiguration.xml file.  (By default this is found in C:\ProgramData\Schneider Electric\ClearSCADA)

The file should look something like this.  (Note - ensure the double-quotes are all the straight type and not the curly type - see screen shot below.  Also, Main needs to match the name used in the Configure Connections dialog.  i.e. if it is spelled MAIN in the Configure Connections dialog then it needs to be spelled MAIN in the file.  The name in the screen shot below (Main) assumes that the name in the Configure Connections dialog is set to Main.

ClearSCADA 2014/2015 example

<Startup>

<WindowContainers AlarmBannerWindow="Right">

<PrimaryWindowContainer Monitor="1" InterfaceMode="MultipleDocuments" DisplayMode="FullScreen"/>

<SecondaryWindowContainer Name="Left" Monitor="2" LegacyHead="2" InterfaceMode="MultipleDocuments" DisplayMode="Restored" />

<SecondaryWindowContainer Name="Right" Monitor="3" LegacyHead="3" InterfaceMode="MultipleDocuments" DisplayMode="Restored" />

</WindowContainers>

<InitialDocuments>

<Document Window="Primary" Type="Object" System="MAIN">1 My Mimic</Document>

<Document Window="Left" Type="Object" System="MAIN">1 My Mimic</Document>

<Document Window="Right" Type="Object" System="MAIN">1 My Mimic</Document>

</InitialDocuments>

</Startup>


Screen shot showing difference between double-quote types



ClearSCADA 2017 R2 example

<Startup>

<WindowContainers>

<PrimaryWindowContainer Monitor="1" DisplayMode="FullScreen" AlarmBannerPersistSettings="true" AlarmBannerDisplayState="DockedBottom" />

<SecondaryWindowContainer Name="Right" Monitor="2" DisplayMode="Restored" AlarmBannerDisplayState="Dockedbottom" />

</WindowContainers>

<InitialDocuments>

<Document Window="Primary" Type="Object" System="MAIN">Monitor1_homepage</Document>

<Document Window="Right" Type="Object" System="MAIN">Monitor2_homepage</Document>

</InitialDocuments>

</Startup>


2) Once you have this file you'll need to create a shortcut on your desktop to the ViewX app.  Open Windows Explorer and navigate to:

C:\Program Files (x86)\Schneider Electric\ClearSCADA.

Locate SE.Scada.ViewX and drag it to the desktop to create a shortcut.





3) Now go into the properties of the shortcut and modify the 'Target' name to read as follows:

"C:\Program Files (x86)\Schneider Electric\ClearSCADA\SE.Scada.ViewX.exe" /Startup:c:\zebra\StartupConfiguration.xml

In this case I created a folder on the C:\ drive called 'zebra' where I placed the StartupConfiguration.xml file.  I found that if the string length of the 'Target' field was too long then the shortcut would not work.



If you double-click on the shortcut two ViewX containers should open; one on the primary monitor and one on the secondary monitor.

Released for: Schneider Electric Canada