Extract MicroStation 2D Files
- Last UpdatedMar 24, 2025
- 3 minute read
The Gateway extracts the files from MicroStation 2D data sources such as .DGN files.
Note: MicroStation drawings that refer to PDF and/or .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 type of Input Source from the drop-down box, that is, File System or S3.

For FileSystem as Input Source:
-
Define the Input Path for the location of the input files (DGN files), either 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 box to exclude the construction elements from the output SVG file. When this option is cleared, it enables export of the construction elements to SVG output file. The default value is cleared to include the construction elements in the SVG.
-
If you select Remove Hidden Layers option, SVG files are produced without including items and their extents from layers which are set as hidden in the source drawing.
-
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.
-
If you want 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.
Visual Styles/Hatches
High density hatches can be rendered in the SVG with a solid fill type to reduce the processing and SVG rendering times.
MicroStation supports multiple pattern styles. Some of these that have a high density pattern do not render efficiently in the SVG format and increases the size of the SVG file. If the density is so high that it appears to be a fill pattern when viewed at normal resolutions, then it is recommended to map them 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 can then be modified by a separate color presentation mapping in the Transformation configuration.
The 'Hatches' node must be updated manually in the configuration file as 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 results in the input DOTS pattern being converted to a solid pattern in the SVG.
Note: The MicroStation extractor is unable to read hatch densities from .dgn files, therefore, you can't use the maxScale parameter to apply the hatch mapping to only high density patterns.


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