Hole Management Utility
- Last UpdatedAug 14, 2025
- 5 minute read
The Hole Management Utility which creates and manages penetrations is available only in the Pipework and HVAC Designer applications, on the Piping or HVAC tab, in the Penetrate group, click Pipe, select Penetration Utility from the drop-down list to display the Managed Hole Utility window.

Create Holes
In the Clearance text field, enter how much clearance to apply to the penetrating item. The clearance is not applied if the software detects a clash with a pipework or HVAC component that has hole size properties.
Note:
The clearance can be controlled by the component that passes through the panel if
the penetrating component has a Property AHDI (for circular) or AHX, AHY (for non-circular)
then these property values controls the hole size. Refer to Configuration of Hole Management Data for further information.
Select the Insulation check box to apply insulation to the penetrating item.
An example of the properties created in the catalog:
NEW DATA /HVACPeneStrt1-Rext-RPlate-DETAIL-DATA-AHX
DESC 'Penetration Clearance X'
DKEY AHX
PTYP DIST
PPRO ( ATTRIB DDESP[2 ] + 100 mm )
DTIT 'Penetration Clearance X'
OLD /HVACPeneStrt1-Rext-RPlate-DETAIL-DATA-AHX
END
NEW DATA /HVACPeneStrt1-Rext-RPlate-DETAIL-DATA-AHY
DESC 'Penetration Clearance Y'
DKEY AHY
PTYP DIST
PPRO ( ATTRIB DDESP[3 ] + 100 mm )
DTIT 'Penetration Clearance Y'

Click Auto Penetrate CE to automatically create holes in the selected Current Element.
The clash analysis by the software can take a few minutes, a progress message and bar is displayed. Once the analysis has taken place, the Hole Association Manager window displays the details of the newly created virtual holes. Refer to Hole Management for further information.
Note: The Hole Association Manager window is not displayed if no virtual holes are created.
If more than 30 virtual holes have been created a confirmation message to display the Hole Association Manager window is displayed.
To create holes individually click Create Hole, you are prompted to pick a panel, pipe or HVAC branch that penetrates the selected panel, section or wall element. The creation of the hole is identical to the automatic hole creation.
Merge Holes
Merged holes are individual holes merged together into a single hole generated by the software.
To merge holes, from the Merge Holes part of the Managed Hole Utility window, click Pick Holes, you are prompted to pick a Managed Hole fitting to be combined into a single merged hole.
Note: A minimum of two holes must be picked.

Click Merge Holes, the software creates a merged hole containing the selected penetrations.

Modify Holes
Created holes can be modified, managed or deleted.
To modify a created hole, from the Modify Holes part of the Management Hole Utility window, click Modify CE to display the Hole Management Definition window, modify the created hole as required, the Free Hole Boundary Editor can also be started from this window.
Click Manage Holes to display the Hole Association Manager window. Refer to Hole Management for further information.
Delete Holes
To delete a managed hole, you are prompted to pick the hole to be deleted. If the hole has no status it is then deleted, if the hole is Requested, you are prompted to confirm the deletion of the hole.
Note: If the hole is Approved, the deletion is not permitted.
Utilities
All panels within the volume of the selected pipe or HVAC can be added to the 3D view. To do this, from the Utilities part of the Managed Hole Utility window, click Add Structure.
To view all pipe or HVAC elements within the volume of the selected structural panels, from the Utilities part of the Managed Hole Utility window, click Add Pipe/HVAC.
To generate and define a report on selected holes, click Hole Report. The report can then be printed or exported to Excel.

The Hole Association Filter pane searches for Managed Holes and displays the search results in the Hole Report. The filter criteria specify which Managed Holes is selected:
Note: Results are displayed in groups of 500.
|
Current Element |
Displays any holes associated with the currently selected element only. |
|
Graphical Selection |
Applies filtering to all managed holes associated with elements in the current graphical selection. |
|
All Managed Holes |
Applies filtering to all managed holes in the MDB. |
|
Discipline |
Specify holes for all disciplines or for a single discipline using the drop-down menu. |
|
Status |
Specify holes at any Status or specify holes at a single Status option using the drop-down menu. |
|
Valid |
Select only holes that pass or fail the validation tests, or select all holes regardless of validity. Note: Having any option other than Not Checked selected may significantly slow down the report generation as all the validation tests is run for every selected hole. |
|
Invalid |
Include hole associations that have any invalid references or invalid data. |
|
Apply Filter |
Refreshes the Hole Report according to the element and filtering options selected. Note: It is necessary to select Headings required on the report before you click Apply Filter because heading data is collected when filters are applied. |
In the Report Headings pane select headings using the check boxes that are required on the report from the three categories, Hole, Penetrated structural item and Penetrating items.
To select all headings click Select All Headings or to remove all headings click Remove Headings.
Click Preview to display Managed Hole Report window.
The Managed Hole Report window displays the report generated by the specified selection criteria and report headings.

Use the grid column functions to sort and filter columns before printing the report or exporting it to Excel. Select Print Preview to view the report or select Export to Excel to export the report to Excel.
Right-click the Hole Associations list to display the following pop-up menu:
|
Navigate to |
To the Hole Association, the penetrated item or the penetrating item (single selection only). |
|
Add to 3D view |
Adds the selected holes and associated items. |
|
Remove from 3D view |
Removes the selected holes and associated items. |
|
Focus in Hole |
Zooms to centre the 3D view on the selected hole and zoom in to the hole. Clipping is applied if it is enabled (single selection only). |
|
Export list to Excel |
Exports the report grid to Excel. |
|
Print list |
Displays a standard grid print preview for the report grid. |