V3 Menu file XML structure
The following tables outline the attributes of each XML element that make up the configuration file.
Structure of the CCLAS attribute
Child elements: Group, Recents
| Attribute | Type | Description |
|---|---|---|
| caption | String | Caption displayed for the group in the V3 menu application. |
| MaxRecents | Numeric (Integer) | Maximum number of recent items shown on the Home screen. |
Structure of the Group attribute (including the Recents group)
Child elements: Item
| Attribute | Type | Description |
|---|---|---|
| name | String | Name of the group. |
| caption | String | Caption displayed for the group in the V3 menu application. |
| help | String | A description of the group. This is also displayed in the application. |
| iconsource | String | The URL of the file containing the icon representing the group in the V3 menu application. This can be an Exe file that has images, or an image file. |
| iconposition | Numeric (Integer) | Where the iconsource contains multiple icons, this is the numeric index of the icon to be shown. The default is 0. |
| isFavourite | Boolean |
Indicates whether the group is a favourite on the Home screen. True indicates the group is a favourite, false indicates the group is not a favourite. Note: Adding a group as a favourite does not mean that all of the group's items are favourites - they must be marked as a favourite to be included here. It indicates that the group contains items that are added as favourites. |
Structure of the Item attribute
| Attribute | Type | Description |
|---|---|---|
| name | String | Name of the item. |
| caption | String | Caption displayed for the item in the V3 menu application. |
| help | String | A description of the item. This is also displayed in the application. |
| executable | String | The associated application, typically the path to an executable or script file, or a target URL. |
| startdirectory | String | The folder in which the application is to start. |
| parameter | String | The command line arguments. |
| iconsource | String | The URL of the file containing the icon representing the item in the V3 menu application. This can be an Exe file that has images, or an image file. |
| iconposition | Numeric (Integer) | Where the iconsource contains multiple icons, this is the numeric index of the icon to be shown. The default is 0. |
| show | Numeric (Integer) | A value indicating how the application is shown upon start up: 0=Normal, 1=Hidden, 2-Minimised, 3=Maximised. |
| isFavourite | Boolean |
Indicates whether the icon is a favourite on the Home screen. True indicates the icon is a favourite, false indicates the icon is not a favourite. |
Example menu file for CCLAS EL version 3
This is an example xml file that configures the menu of CCLAS EL version 3.
Example CCLAS.MNU.XML
<?xml version="1.0" encoding="utf-8"?>
<CCLAS xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" caption="CCLAS Gold Demo" MaxRecents="10">
<Group name="GROUP CONFIG" caption="Configuration" help="Configuration programs" iconsource="%IconDirectory%CCLAS\Configuration_White.png" iconposition="0" isFavourite="true">
<Item name="LICENCE" caption="Licence" help="Licence Program" iconsource="%IconDirectory%CCLAS\Licence.png" iconposition="0" isFavourite="true" executable="%EXE3Directory%LICENCE\licenceapp.exe" startdirectory="%bindirectory%" parameter="" show="0" />
<Item name="STAFF" caption="Staff" help="Staff Program" iconsource="%IconDirectory%CCLAS\Staff.png" iconposition="0" isFavourite="true" executable="%EXEDirectory%STAFF.exe" startdirectory="" parameter="" show="0" />
</Group>
<Group name="GROUP PROCESSING" caption="Processing" help="Processing programs" iconsource="%IconDirectory%CCLAS\Processing_White.png" iconposition="0" isFavourite="true">
<Item name="JOBS" caption="Jobs" help="Jobs entry" iconsource="%IconDirectory%CCLAS\Jobs.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%PROFILE.EXE" startdirectory="%CollDirectory%" parameter="" show="0" />
<Item name="Geology Registration" caption="Geology
Registration" help="" iconsource="%IconDirectory%CCLAS\Geology Reg.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%Dashboard.exe" startdirectory="" parameter="%ConfigDirectory%GeologyRegistration.VBS" show="0" />
<Item name="Stream Registration" caption="Stream
Registration" help="" iconsource="%IconDirectory%CCLAS\Stream Registration.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%Dashboard.exe" startdirectory="" parameter="%ConfigDirectory%StreamRegistration.SCR" show="1" />
</Group>
<Group name="GROUP QUALITY" caption="Quality Control" iconsource="%IconDirectory%CCLAS\Quality Control_White.png" iconposition="0" isFavourite="true">
<Item name="SPC" caption="SPC" iconsource="Z:\CCDEMO_VELOX_SANDPIT\Icons\CCLAS\SPC.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%STATPC.EXE" show="0" />
<Item name="AUDITJOB" caption="Job Audit" help="Job Audit" iconsource="%IconDirectory%CCLAS\Job Audit.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%AUDITJOB.EXE" startdirectory="%CollDirectory%" parameter="" show="0" />
</Group>
<Group name="GROUP MANAGEMENT" caption="Management" iconsource="%IconDirectory%CCLAS\Management_White.png" iconposition="0" isFavourite="true">
<Item name="SAMTRACK" caption="Sample Tracking" help="" iconsource="%IconDirectory%CCLAS\Sample Tracking.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%SAMPLETRACK.EXE" startdirectory="" parameter="" show="0" />
<Item name="CONSUME" caption="Consumables" help="Consumables" iconsource="%IconDirectory%CCLAS\Consumables.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%Consumables.exe" startdirectory="" parameter="" show="0" />
<Item name="LABMAINT" caption="Lab Maintenance" help="Lab Maintence" iconsource="%IconDirectory%CCLAS\Lab Maintenance.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%LabMaintenance.exe" startdirectory="" parameter="" show="0" />
<Item name="STATUS" caption="Status Report" help="Status reports" iconsource="%IconDirectory%CCLAS\Status Report.png" iconposition="0" isFavourite="false" executable="%ExeDirectory%STATREP.EXE" startdirectory="%CollDirectory%" parameter="" show="0" />
</Group>
<Group name="GROUP AUTOMATION" caption="Automation" iconsource="%IconDirectory%CCLAS\Automation_White.png" iconposition="0" isFavourite="true">
<Item name="TASKSCHEDULER" caption="Task Scheduler" help="Task scheduler" iconsource="%IconDirectory%CCLAS\Taskman.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%TaskSchd.exe" startdirectory="%CollDirectory%" parameter="" show="0" />
<Item name="ONLINE" caption="On-line" help="Single sample analysis" iconsource="%IconDirectory%CCLAS\Samana.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%SAMANA.EXE" startdirectory="%CollDirectory%" parameter="" show="0" />
</Group>
<Group name="GROUP UTILITY" caption="Utility" iconsource="%IconDirectory%CCLAS\Utility_White.png" iconposition="0" isFavourite="true">
<Item name="Tools" caption="Tools" help="CCLAS Tools" iconsource="%IconDirectory%CCLAS\Tools.png" iconposition="0" isFavourite="false" executable="%ExeDirectory%GenUtil.exe" startdirectory="%CollDirectory%" parameter="" show="0" />
<Item name="Dashboard" caption="Dashboard" help="Screen Developer" iconsource="%IconDirectory%CCLAS\Dashboard.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%Dashboard.exe" startdirectory="%ExeDirectory%" parameter="" show="0" />
<Item name="Stream Maintenance" caption="Stream
Configuration" help="" iconsource="%IconDirectory%CCLAS\Stream Maintenance.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%Dashboard.exe" startdirectory="" parameter="%ConfigDirectory%StreamMaintenance.vbs" show="0" />
<Item name="Archive/Retrieve" caption="Archive/Retrieve" help="" iconsource="%IconDirectory%CCLAS\Archive_Retrieve.png" iconposition="0" isFavourite="true" executable="%ExeDirectory%Dashboard.exe" startdirectory="" parameter="%ConfigDirectory%ArchiveRetrieve.VBS" show="0" />
</Group>
<Recents name="RECENTS" caption="Recents" help="Recently run items" iconposition="0" isFavourite="true">
<Item name="STAFF" caption="Staff -QA" iconposition="0" isFavourite="false" executable="STAFF" show="0" />
<Item name="STAFF_ROLE" caption="STAFF ROLE" iconposition="0" isFavourite="false" executable="STAFF_ROLE" show="0" />
<Item name="GROUPING" caption="STAFF GROUP" iconposition="0" isFavourite="false" executable="GROUPING" show="0" />
</Recents>
</CCLAS>Note: This is a trimmed down version of the menu.
