Panel Name

unLaserConfigFile.pnl

Introduction

This panel is used to perform some validation actions for the xml configuration file. The actions can be performed either for the general syntax of the xml file or for validating against the specified XML schema.

Instructions
The following actions can be performed for a single configuration file:
  • Edit XML File: The user can edit each node/attribute of the XML by double-click the specified element on the tree
  • Check For Errors: Validation of the XML syntax and against the XML schema.
  • Reporting on Log Files : In case of validation error, details will be printed in the logfile.
  • Error handling: In case of error, the item and its parent item colour will change to red and a help message will shown at the bottom right of the panel.

Dollar Parameters
Name Description  
$ConfigPath Path of the configuration file. Required
$Datapoint Datapoint of the selected Laser Manager. Required

 


Figure 1. Laser Configuration file check panel.

 

 

XML configuration file syntax
Example
<laserXSD:configFile xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:laserXSD="http://en-dep.web.cern.ch/en-dep/structure/ICE/"> <Datapoint Dpe="Dpe.bool" Alias="boolAlias" Type="BOOLEAN" Name="ItemName" T_mode="false"> <Range Num="0" Description="OK_RANGE" FF="FF_BOOLEAN" FM="FM_BOOLEAN" FC="1" State="TERMINATE" /> <Range Num="1" Description="NOTOK" FF="FF_BOOLEAN" FM="FM_BOOLEAN" FC="1" State="ACTIVE" /> </Datapoint> <Datapoint Dpe="Dpe.int1" Alias="intAlias1" Type="INTEGER" Name="ItemNameint1" T_mode="false" > <Range Num="1" Description="OK_RANGE" FF="FF_INTEGER" FM="FM_INTEGER" FC="2" /> <Range Num="2" Description="NOTOK" FF="FF_INTEGER" FM="FM_INTEGER" FC="2"/> </Datapoint> <Datapoint Dpe="Dpe.int2" Alias="intAlias2" Type="INTEGER" Name="ItemNameint2" T_mode="false" > <Range Num="1" Description="OK_RANGE" FF="FF_INTEGER" FM="FM_INTEGER" FC="2" State="TERMINATE" Limit="&gt;=0"/> <Range Num="2" Description="NOTOK" FF="FF_INTEGER" FM="FM_INTEGER" FC="2" State="ACTIVE" Limit="&lt;0"/> </Datapoint> </laserXSD:configFile>
Restrictions
    Basic rules of the xml schema, for more information please refer to the schema documentation.

     

  • File root node name required (<laserXSD:configFile>) with its attributes xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:laserXSD="http://en-dep.web.cern.ch/en-dep/structure/ICE/"
  • Empty attributes are not allowed, ( e.g avoid Type="" or Name="")
  • Attributes are case sensitive (e.g num attribute will not parsed, use Num instead)
  • The attributes of the <Datapoint> element, Dpe & Type required, Alias, Name and T_mode are optional.
  • The attributes of the <Range> element, Num, FF, FM, & FC required, Description is optional and State and Limit attributes are situational (for analog alarms (e.g integer type) without _alert_hdl config set).
  • For the Limits attribute the user can specify one of the following characters: (Warning! > (greater than) and < (less than) are illegal in XML)
    • "&gt;=INTEGER", greater than or equal to (e.g use Limit="&gt;=10" for greater than or equal to ten)
    • "&lt;=INTEGER", less than or equal to (e.g use Limit="&lt;=0" for less than or equal to zero )
    • "&gt;INTEGER", greater than (e.g use Limit="&gt;8" for greater than eight )
    • "&lt;INTEGER", less than (e.g use Limit="&lt;-1" for less than minus one)
    • "==INTEGER", equals (e.g use Limit="==11" for equals to eleven)
    • "!=INTEGER", not equal to (e.g use Limit="!=7" for not equal to seven)