Checking and Amending the XML file Generated in Step 1

Schematic Model Manager User Guide

Appendices : Appendix H: Units Upgrade 12.0.SP6 to 12.1 : Checking and Amending the XML file Generated in Step 1

On successful completion of Step 1 a message box will be shown stating the location of the log file, which contains details of the analysis carried out. In the same folder, \Schematic\Units Upgrade under the project folder, will be an XML file called SMMUnitsUpgradeList.xml, which lists the upgrade candidate information.

The SMMUnitsUpgradeList.xml file lists the attributes in the database which have been identified as upgrade candidates. The file contains <UpgradeElement> nodes, each of which represents an Attribute for a Element which has been identified for upgrade.

The following details are given for each <UpgradeElement> node:


<UpgradeElement> node attribute	Description
ElementName	The Name attribute for the Element.
ElementRefNo	The Reference Number for the Element.
SCDIAGName	The Name attribute of the SCDIAGRAM element which this element was last imported as part of.
UdaName	The UDA which has been identified as having units associated with it and an upgrade candidate.
AttributeType	The dimension type for the UDA. This information is gathered from the Attribute Mappings file.
SMMUnit	The unit which is associated with this UDA (this will be identified using the pmgunt UDAs on the SCDIAGRAM identified by SCDIAGName).
UdaValue	The current UDA value.
DabaconUnit	The 12.1 unit which is set to be used for this dimension type.
DabaconUnitCorrespondingToSMM	The 12.1 unit equivalent of the Unit in SMMUnit.
IsUpgradeRequired	The flag which is used to show whether this UDA on this Element is to be upgraded or not. This will show "true" by default as all candidates will be upgraded by default but can be changed to "false".

Below is an example file showing four Attributes, :Pmgdpremin, :Pmgdpremax, :Pmgdtmpmin, :Pmgdtmpmax, that have been identified for upgrade on the /R9002 Element.

<UpgradeElements IsUUNIAttrUpdated="false" IsUUNIApiCalled="false">

<UpgradeElementCollection>

     <UpgradeElement ElementName="/R9002" ElementRefNo="=16390/7277" SCDIAGName="/905675" UdaName=":Pmgdpremin" AttributeType="pressure" SMMUnit="Bar" UdaValue="2" DabaconUnit="pascal" DabaconUnitCorrespondingToSMM="bar" IsUpgradeRequired="true" />

     <UpgradeElement ElementName="/R9002" ElementRefNo="=16390/7277" SCDIAGName="/905675" UdaName=":Pmgdpremax" AttributeType="pressure" SMMUnit="Bar" UdaValue="40" DabaconUnit="pascal" DabaconUnitCorrespondingToSMM="bar" IsUpgradeRequired="true" />

     <UpgradeElement ElementName="/R9002" ElementRefNo="=16390/7277" SCDIAGName="/905675" UdaName=":Pmgdtmpmin" AttributeType="temperature" SMMUnit="DegreeCelsius" UdaValue="11" DabaconUnit="kelvin" DabaconUnitCorrespondingToSMM="degC" IsUpgradeRequired="true" />

     <UpgradeElement ElementName="/R9002" ElementRefNo="=16390/7277" SCDIAGName="/905675" UdaName=":Pmgdtmpmax" AttributeType="temperature" SMMUnit="DegreeCelsius" UdaValue="22" DabaconUnit="kelvin" DabaconUnitCorrespondingToSMM="degC" IsUpgradeRequired="true" />

</UpgradeElementCollection>

</UpgradeElements>

In this example the first <UpgradeElement> which is the :Pmgdpremin UDA on /R9002 has been identified as having the value 2 and the unit Bar, currently. During Step 2 of the upgrade the :Pmgdpremin UDA definition will have the UUNI (dimension information) set to Pressure and the values will then have the unit Pascal, so the value for this attribute on /R9002 will be incorrect. During Step 3 of the upgrade process the value for this UDA will be converted to show 200000pascal.

The XML file can be edited and overwritten in the same location for use in Step 3 of the process. Setting the IsUpgradeRequired to false or removing the <UpgradeElement> node will eliminate that Attribute from the upgrade and the value will not be converted in Step 3.