Issue
Prior to XBuilder 5.1.1, it was not possible to change the type of an Xenta Server in an XBuilder project once it had been created. Sometimes there is a need to move the project to a different type of Xenta Server without losing all the links and bindings within the project.
Environment
Xenta Server
XBuilder 5.1.0 or earlier
Xenta 511, 527, 555, 701, 711, 721, 731, 913
Cause
In XBuilder 5.1.0 or earlier, it is not possible to edit the Xenta Server type in the network pane of the XBuilder project
Resolution
- Open the Vista database containing the Xenta 555 project.
- Right-click on the 555 and select Edit from the dropdown menu.
- The XBuilder project opens. Keep this open for the following steps.
- In the Vista database create a new Xenta 731. The name is not important but it should be similar but not identical to the 555 it will replace.
Transferring the Lonworks network to the Xenta 731:
- In Vista, drag and drop the LON network from the 555 to the 731.
- Right-click on the 731 and select Edit from the dropdown menu.
- The 731 project opens in a new instance of XBuilder. Rename the default folder in the system pane to the same name as the top level folder in the 555 project.
- In the 731 project right-click on the LON object in the Network pane. Select 'Refresh network from TAC Vista'.
Transferring the Modbus network to the Xenta 731:
- In the 555 project, right-click a Modbus device and select 'Edit Device template'
- When the device editor opens, select File | Save as..
- Save the file in the default location with the default name.
- Repeat steps 2 to 3 for all Modbus devices in the network.
- In the 731 project recreate the Modbus network using the templates just saved.
Transferring the System objects to the Xenta 731:
- In the 555 project, right-click an object below the top level folder and select 'Copy'.
- Move focus to the 731 project, right-click on the top level folder and select 'Paste'.
- Repeat steps 1 and 2 for each object and folder below the top level in the 555 project. Selecting a folder also selects all the objects and folders beneath it. Although it is possible to copy the top level folder in the 555 project, it is not possible to paste it into the 731 project.
- Graphics bindings are retained and the reference paths are automatically updated with the new network tree i.e. 'TAC_Xenta_555' is replaced with 'TAC_Xenta_731'.
- Some object bindings will be broken e.g. Time objects. These must be rebound manually.
- When all objects have been copied across and rebound if necessary, close the 555 project.
Deleting the Xenta 555 and downloading the project to the Xenta 731:
- In the Vista database, delete the Xenta 555.
- Generate the 731 project. There will be a warning message offering to copy the original TGML files to the new default location. Select 'Yes'.
- The 731 project should now generate without errors.
- Download the project to the Xenta 731.
If the 555 only contains a Modbus network, a similar methodology will also work with standalone 555 and 731 projects.