Get DGN Info

Reads information from a Bentley MicroStation DGN file — text, title‑block cells and their tag values, reference attachments, levels, and drawing extents. No MicroStation installation or licence is required; the file is read directly, so this task can run in parallel across many drawings at once.

Purpose

Use this task when a workflow needs to inspect a DGN before acting on it — for example, to read title‑block metadata (drawing number, revision, status) from a cell, to confirm a border reference is attached and resolvable before publishing, to enumerate levels, or to obtain the drawing extents used when exporting to PDF. It pairs naturally with the DGN Export task: run Get DGN Info first to make decisions, then export.

Inputs

Field	Type	Required	Description
File Path	Text	Yes	Full path to the DGN file to analyse.

Outputs

Name	Description
Texts	All visible text strings found in the drawing.
TextCount	Number of text strings.
Cells	Cell placements (e.g. title blocks), each with its name, level, position and tag values.
CellCount	Number of cell placements.
AllTags	A flattened list of every tag name/value pair across all cells — useful for reading title‑block metadata directly.
AllTagCount	Total number of tag values.
Refs	Reference (external file) attachments, including the stored file name, path, and clip boundary information.
RefCount	Number of reference attachments.
MissingRefs	Reference attachments that have no stored path or file name.
HasMissingRefs	True if any reference has no stored path or file name.
Levels	Level definitions found in the file, with their IDs and names.
LevelCount	Number of levels.
DesignRange	The drawing extents (overall geometry bounds) of the main file, in drawing units.
DesignRangeValid	True if a design range could be computed (the file contains geometry).
ReferenceRanges	For each reference attachment, the extents of the referenced border file (resolved one level), with whether the file was found on disk.
ReferenceRangeCount	Number of reference ranges reported.
MissingReferenceFiles	Reference attachments that were listed in the drawing but could not be located on disk.
HasMissingReferenceFiles	True if any referenced file could not be located on disk.

Notes

• Title‑block metadata is most easily read from AllTags, or from a specific cell in Cells. Tag values typically hold fields such as drawing number, revision and approval status.
• Reference borders (an external DGN attached as the sheet border) are reported in Refs and ReferenceRanges. The reference range is the border file's own extents, which the DGN Export task uses to clip each sheet.
• Missing references (HasMissingRefs / HasMissingReferenceFiles) let a workflow stop early, or notify, when a drawing depends on files that are not present.