Import Upgrade
- Last UpdatedNov 27, 2025
- 4 minute read
The Import Upgrade add-in provides you with a backward compatibility option for IFC models, by copying the GENPRIs and DDSEs and DDATs from the old elements (EQUI/VOLM/STRU/SUBE/SUBS/SVOLM) created using the old IFC imported model to the new SUBEs elements. These new elements represent the complete IFC model parts within AVEVA Unified Engineering.
Configuration
Use the functionality available from the Import Upgrade window to upgrade an old IFC model.
-
On the Interface tab in the Import group, select IFC then select Upgrade from the dropdown list, to display the Import Upgrade window.

-
Browse for the log file folder location to save the newly created log file to, the Create Log File check box is selected by default.

-
Specify the number of elements contained in each zone.
-
Select the Limit no of import elements per level check box (deselected by default).

Note:
A valid number of import elements per zone must be entered. The default number of import elements per zone is 100. A value of less than 25 or more than 1000 cannot be entered. -
To delete any EQUI/VOLM/STRU/SUBE/SVOLM elements generated by the old IFC import including GPSET secondary hierarchies (after the GENPRI and DDSE/DDAT's have been moved to the new hierarchy), do not deselect the Delete old elements after upgrade check box (default).

To retain the elements and hierarchies deselect the checkbox.
Note:
GENPRIs and DDSEs/DDATs from the old elements have already moved to new SUBEs, the outer skeleton (EQUI/VOLM/STRU/SUBE/SUBS/SVOLM) elements are not deleted, they are retained. The GPSETs hierarchy is not deleted. You have the flexibility to undo this which helps to retain the old IFC model structure. -
Select a GPSET element from the imported model hierarchy, click + to add the GPSET to the elements group.
Note:
The currently selected GPSET element and the related GPSETs (for example, Types, Systems and Layers) are added to the elements group based on their GPITEM/SITEM Owner (ZONE) Reference No. and description. -
If required select another GPSET element for upgrade.
Note:
A minimum of one up to four GPSETs elements can be added. All of these GPSETs must be from the same original import (unless they have been renamed, they will have the same first part of the GPSET name). Models from separate original IFC files must be upgraded separately.

-
Click Upgrade to begin the Import Upgrade process. A progress bar and any messages related to the upgrade are displayed during the upgrade process.

Note:
Once the upgrade has been completed, the upgraded model may take some time to be visible on the 3D canvas as the process of deleting the old hierarchy elements may still be in progress.Note:
Once a model has been successfully upgraded you can undo the process to revert back to the previous IFC model structure.If the upgrade process fails, the error details are added to the log file and are displayed in the Import Upgrade window.

If the GPSET type if IFCPROJECT is not added to the elements group a warning message is displayed as below.

-
Select Cancel to clear all entries in the element group and revert the settings.
Log File
Each time the Import Upgrade process is completed a new log file is created, named using the Imported model name and located in the log file folder. Each log file is populated with information regarding the upgrade process:
-
Any exceptions encountered during the upgrade process are recorded with full details to help with troubleshooting
-
All warning messages generated during the upgrade process are logged for review
-
Element copying details, for example, source and destination details when copying DDSEs and GENPRIs
-
Records the newly created zone name and reference number
-
Copy statistics, for example, a summary of how many elements were successfully copied relative to the total number of SP items available
-
If the bucket size is configured, the log includes the bucket element and reference number.
Note:
For large sized models the upgrade process may take some time and AVEVA recommends to allow the upgrade process to run until completion. Once a model has been successfully upgraded you can undo the process to revert back to the previous IFC model structure.