Migrate Custom Parameters to the Configuration Parameters Database

Prior to the release of Plant SCADA 2023, "custom parameters" were used to apply specific values to an equipment type. However, there was limitation of 256 characters on the database field that was used to store these parameters.

In Plant SCADA 2023, custom parameters were replaced with "configuration parameters". These parameters support the same functionality, but they are stored in a dedicated configuration parameter database that removes the 256 character limitation.

Equipment types that support the configuration parameters database can be identified by a "2.0" version tag in the source XML.

<template version="2.0" desc="Equipment template">

To migrate your equipment types (and any associated instances) to version 2.0:

1. From the Projects view in Plant SCADA Studio, select Migration Tool on the command bar.

   The Project Migration Tool will display with the active project selected.

2. In the list of migration options, confirm that Migrate equipment database, types and parameters is selected.

   If required, you can clear the check boxes for any other migration options.

3. Click Migrate.

   When the migration process is complete, an information dialog will appear listing the changes that have been made. This will include a tally for "Equipment types and instances upgraded".

4. Click OK.

The configuration parameters that were generated by the migration process will now be available to view in the Equipment | Configuration Parameters view in the System Model activity.

You can also initiate this process from Equipment Editor. If Plant SCADA detects a version 1 equipment type when you open the Equipment Editor, the following dialog will appear:

To migrate the version 1 equipment types, click Yes to open the Project Migration dialog and follow the steps above. To keep the existing version 1 templates, select No.

Note: If you are using equipment templates that were not created by Equipment Editor, you need to check the validity of these templates following the migration process. Before you launch runtime, perform an equipment update and review the configuration data associated with these templates (for example, the alarms and variable tags) to confirm that everything has migrated correctly.

See Also

Add Configuration Parameters to an Equipment Type

Define Equipment Configuration Parameters in Plant SCADA Studio