Rule-based File for Security Overlay Settings

You can create a rule-based file to define DMU security overlay settings.

When you choose select the Rule Based option in the Overlay Settings, an xml file is used to compute the overlay text No xml file is provided by default, you must write your own xml file.

The product structure is parsed to find the highest value of the parameter defined in the xml file. The text associated to this highest value is displayed as the Security Overlay.

Dtd file according to which the xml file is constructed

<?xml version="1.0" encoding="UTF-8"?> 
<!-- COPYRIGHT DASSAULT SYSTEMES 2004 - > 
<!ELEMENT MappingDescription (InParameterValue+)> 
<!ATTLIST MappingDescription  
ParameterName CDATA #REQUIRED 
ParameterType (STRING | INT | DOUBLE | BOOLEAN) #REQUIRED 
AppliName CDATA #REQUIRED 
>
<!ELEMENT InParameterValue (OutAppliValue+)> 
<!ATTLIST InParameterValue 
PValue CDATA #REQUIRED 
>
<!ELEMENT OutAppliValue EMPTY> 
<!ATTLIST OutAppliValue 
APName CDATA #REQUIRED 
APType (STRING | INT | DOUBLE | BOOLEAN) #REQUIRED 
APValue CDATA #REQUIRED 
>

Remarks:


  • for APName, only one value is allowed: "OverlayText"
  • for AppliName, only one value is allowed: "Security Overlay"
  • for APType, only one value is allowed: "STRING"

Example of xml file used as rule-based file for Security Overlay

<?xml version="1.0" encoding="UTF-8"?> 
<!DOCTYPE MappingDescription SYSTEM "DMUAttMapping.dtd"> 
<!-- COPYRIGHT DASSAULT SYSTEMES 2004 - >  
		 
<MappingDescription ParameterName="ConfLevel" ParameterType="INT" AppliName="Security 
Overlay">
<InParameterValue PValue="2"> 
<OutAppliValue APName="OverlayText" APType="STRING" APValue="Public 
Data" /> 
</InParameterValue>
<InParameterValue PValue="3"> 
<OutAppliValue APName="OverlayText" APType="STRING" APValue="Confidential 
Data" /> 
</InParameterValue>
<InParameterValue PValue="4"> 
<OutAppliValue APName="OverlayText" APType="STRING" APValue="High Confidential 
Data" /> 
</InParameterValue>
<InParameterValue PValue="5"> 
<OutAppliValue APName="OverlayText" APType="STRING" APValue="Top Secret 
Data" /> 
</InParameterValue>
</MappingDescription>

In the above example:

  • the parameter searched for in the product structure will be ParameterName="ConfLevel"
  • the input parameters and their corresponding output values are:
    Input Output Value
    <InParameterValue PValue="2"> APValue="Public Data" />
    <InParameterValue PValue="3"> APValue="Confidential Data" />
    <InParameterValue PValue="4"> APValue="High Confidential Data" />
    <InParameterValue PValue="5"> APValue="Top Secret Data" />

If the highest value of "ConfLevel" found in the product structure is "4", the displayed Security Overlay will be "High Confidential Data".