Owner manual

OpenLNS Programmer's Reference 944
UpgradeInfo
Each time you call the Upgrade method to upgrade an AppDevice object’s external interface
file, an UpgradeStatus object is returned. The UpgradeStatus object contains properties
describing the results of the upgrade. This includes the UpgradeInfos property, which
contains a collection of UpgradeInfo objects. Each UpgradeInfo object represents a
component of the old external interface file, which could be a LonMarkObject, a network
variable, a configuration property, a static or dynamic message tag, a monitor set, or a
monitor point. To determine the external interface component to which an UpgradeInfo
object applies, read the Class and FromIndex properties of this object.
The other properties of the UpgradeInfo object contain information describing how the
component it represents was affected by the upgrade.
• The FromIndex and FromOwnerIndex properties indicate the device index value
assigned to the component in the old external interface file, and the ToIndex and
ToOwnerIndex properties indicate the device index value assigned to the component in
the upgraded external interface file.
• The Status property indicates whether or not the component was retained by the new
external interface.
• The Reason property indicates why the component was retained or removed from the
new external interface.
The following table summarizes the UpgradeInfo object.
Description
Describes the results of a device XIF upgrade.
Added to API
LNS Release 3.0.
Accessed Through
UpgradeInfos object.
Default Property
None.
Methods
None.
Properties
• Class
• ClassId
• FromIndex
• FromOwnerIndex Parent
• Reason
• Status
• ToIndex
• ToOwnerIndex
Methods
The UpgradeInfo object does not contain any methods.
Properties
The UpgradeInfo object contains the following properties:
• Class
• ClassId
• FromIndex
• FromOwnerIndex Parent