Extract MicroStation 2D Files

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:

1. Click Extract from the left panel.

2. Select the Input Source from the drop-down list: File System or S3.

   

For FileSystem as Input Source:

3. 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.

4. 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.

5. 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.

6. 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. 

7. Define the Layout Selection details, Visual Styles, and Fonts and Support Folders, as mentioned below.

8. Select Save Settings.

For S3 as Input Source:

To configure the extractor for S3 as input source:

9. Define the elements in S3 credential details section. For more information, see Access an AWS S3 Bucket.

   

10. To test connection to S3, select Test Connection. The result of the test is displayed in the bottom-left status bar.

11. Define the Layout Selection details, Visual Styles, and Fonts and Support Folders, as mentioned below.

12. Select Save Settings.

Fonts and Support Folders

As it is common to locate all font files in a common system folder, you can set this location in a System Environment Variable in the User variables section.

The Gateway reads any location (or locations) saved in a system environment variable named ODA_DG along with the locations defined in the project configuration.

Separate multiple folder paths by a semicolon (;), as shown in the following image:

You can also define multiple support folders in the project. The following image shows multiple support folders marked as Project Setting in the Source column. Folders that are defined via the System User Variable are marked as Environment Variable.

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

MicroStation supports multiple pattern styles that do not render efficiently in the SVG format. These can be controlled by extraction configuration to reduce processing and SVG rendering time:

• Specified hatches can be exported with solid fill type.

• Cells can be replace with raster image.

The 'Hatches' and 'Cells' must be updated manually in the configuration file because they are not available on 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>

<Cells>

<Cell name="companyLogo1" imageLocation="c:\logo1.png"/>

<Cell name="companyLogo2" imageLocation="c:\logo2.png"/>

</Cells>

</VisualStyles>

Hatches

High-density hatches can be rendered in SVG using a solid fill to reduce processing time and improve SVG rendering performance.

MicroStation supports multiple pattern styles. Some high-density patterns do not render efficiently in SVG and can significantly increase SVG file size. If a pattern is so dense that it appears as a fill when viewed at normal resolutions, map the pattern to an equivalent-looking solid fill in the SVG.

Note: This mapping is applied during extraction, before any color presentation mapping. As a result, the output solid initially uses the same color as the input pattern, but you can change it using a separate color presentation mapping in the Transformation configuration.

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 .