Echelon LonMaker User Manual

Page 293

LonMaker User’s Guide

277

When the LonMaker tool imports a L

ORKS

network XML file, it attempts to match each object in

the XML file with an object in the LNS database and LonMaker drawing. The LonMaker tool matches
objects based on Neuron ID, name, or handle (in that order). For each matching object, the LonMaker
tool updates the attributes of the object based on any changes in the XML file. For each object that
cannot be matched, the LonMaker tool creates a new matching object in the LNS network database and
the LonMaker drawing. As a result, it is possible to create a new network from a L

ORKS

network

XML file by starting with a new LonMaker drawing and importing the XML file. It is also possible to
export a LonMaker XML file from an existing network, make changes in the XML file, and then
re-import the XML file to make the changes.

To manually import an XML file, follow these steps:

1. Open

the

File menu, point to LonMaker Documents, and then click Import from XML. The

XML Import Options dialog box appears.

2. Set the following options:

Import to Subsystem

Select the root subsystem for the XML file. There are two choices:

• As Defined in XML File. Imports the XML file into the

subsystem specified in the XML file.

• Select Subsystem. Imports the XML file into the subsystem

you specify. By default, the top-level root subsystem will be
selected. To change the subsystem, click Browse.

Input File Name

Specifies the name of the XML file to import.

Log File Name

Specifies the name of the output XML log file that is generated
during the XML import. This log lists the objects created, modified,
or deleted, and any errors encountered. The default name is
C:\XML\network\Export[ _version ]Log.xml.

If this field is clear, an XML log file is not created.

3. Click

OK. The LonMaker XML Import Status window displaying the report status appears,

and the LonMaker tool imports the XML file. You can click Cancel to stop the XML import.
When “Import complete” appears, click OK to close the window.