Checking and Amending the XML file Generated in Step 1
- Last UpdatedMar 28, 2024
- 2 minute read
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> |
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. |
|
DabaconUnitCorresponding |
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.