Extract MicroStation 2D Files
- Last UpdatedJul 17, 2026
- 4 minute read
The Gateway extracts files from MicroStation 2D data sources such as .DGN files.
Note: MicroStation drawings that refer to PDF, .DWG and/or Excel files are processed without including the referenced files.
To configure extraction of the MicroStation 2D files:
-
Click Extract from the left panel.
-
Select the Input Source from the drop-down list: File System or S3.

For FileSystem as Input Source:
-
Define the Input Path for the location of the input (DGN) files, by typing directly, or use the Browse File Path to select a single file or Browse Folder Path to select a folder of files.
-
Select Remove Construction Elements checkbox to exclude the construction elements from the output SVG file. If the checkbox is cleared, construction elements are included in the output SVG file. By default, checkbox is cleared.
-
Select Remove Hidden Layers checkbox to produce SVG files without including items and their extents from layers that are set as hidden in the source drawing.
-
Select Remove Low Priority Lines checkbox to filter out graphic elements during extraction based on their element priority value. When selected, any graphic element whose priority is at or below the configured Priority value is excluded from the output SVG.
-
Define the Layout Selection details, Visual Styles, and Fonts and Support Folders, as mentioned below.
-
Select Save Settings.
For S3 as Input Source:
To configure the extractor for S3 as input source:
-
Define the elements in S3 credential details section. For more information, see Accessing an AWS S3 Bucket.

-
To test connection to S3, select Test Connection. The result of the test is displayed in the bottom-left status bar.
-
Define the Layout Selection details, Visual Styles, and Fonts and Support Folders, as mentioned below.
-
Select Save Settings.
Review from here: https://dev.azure.com/AVEVA-VSTS/Interoperability/_workitems/edit/4405492/
Note: The input file can sometimes be designed to reference data existing in other files. These references are defined with either relative or absolute paths. In both cases, before starting the processing, ensure that all referenced files are placed in the relevant locations so that the Gateway can include them when processing the input file.
Limitation for S3 and AVEVA Cloud Services (ACS):
When processing an input file stored in either S3 or ACS, the Gateway first downloads a copy of the file to the local file system. If the file contains links to referenced files, those referenced files won't be available for processing. To ensure that the input file is processed successfully, store the input file and all referenced files locally, and configure the Gateway to use the File System.
Visual Styles/Hatches
High-density hatches can be rendered in the SVG using a solid fill type to reduce processing and SVG rendering times.
MicroStation supports multiple pattern styles. Some high-density patterns do not render efficiently in the SVG format and can increase the SVG file size. If the density is so high that it appears to be a fill pattern when viewed at normal resolutions, it is recommended to map the pattern to an equivalent-looking solid fill pattern in the SVG.
Note: This mapping is part of the extraction process and is applied prior to any color presentation mapping. Therefore, the color of the output solid is the same as the input pattern, but it can be modified by a separate color presentation mapping in the Transformation configuration.
The 'Hatches' node must be updated manually in the configuration file because it is not available in the user interface. Navigate to the 'General' panel to edit the Extract Configuration file:

Example Extractor Configuration file:
<VisualStyles>
<Hatches>
<Hatch inputFillPattern="DOTS" outputFillPattern="SOLID"/>
</Hatches>
</VisualStyles>
This converts the input DOTS pattern being to a solid pattern in the SVG.
Note: The MicroStation extractor cannot read hatch densities from .dgn files. Therefore, you cannot use the maxScale parameter to apply hatch mapping only to high-density patterns.


Note: For more information about limitations of a MicroStation 2D drawing, see Appendix I: Known Limitations .