ImportInstance

Comprehensive CAD Link and Import management nodes for Revit including layer control and reporting.

The ImportInstance nodes provide access to CAD Link and Import properties, enabling complete control over layer visibility, object styles, and detailed reporting. These nodes streamline CAD data management by exposing layer information, filtering active layers by content type, and providing audit capabilities for all CAD instances in a project — including external Revit files and Family documents.

LayerNames

Get the full list of layer names from a CAD Link or Import in a Revit project.

Download example graph

Inputs

importInstanceImportInstance

Outputs

layerNames[]string[]

Features

  • Outputs the complete list of layer names in a CAD Link or Import as strings

User Guide

LayerNamesInUse

Get the list of layer names from a CAD link or import that are in use and contain curves, points or text. Use the boolean lists as masks to filter specific layers to support workflows using either CADTextData.FromLayers, CAD.PointsFromCADLayers, or any of the Curves from CAD layers nodes.

Download example graph

Inputs

importInstanceImportInstance

Outputs

layerNames[]string[]
containsCurves[]bool[]
containsPoints[]bool[]
containsText[]bool[]

Features

  • Outputs the list of layer names in a CAD Link or Import as strings
  • Only the layers that contain curves, points or text are reported
  • Use the boolean lists to filter specific element types on layers

User Guide

ReportInstances

Generates a list of ImportInstanceReport's for all CAD Links and Imports in the active Revit document. The ImportInstanceReport instances provide detailed information on the ImportInstance link status, view host level, owner view, qualified path, and workset name.

To report the active Revit document, leave the filePath input unconnected or input a filePath to any external Revit file or Family silently to report external files.

The close input allows users to close any files opened using the filePath input, otherwise the node will automatically close any open external documents when you close your graph or close Dynamo. It has no effect if the node is reporting on the active document.

Download example graph

Inputs

filePathstringoptional
refreshbool
closebool

Outputs

ImportInstanceReport[]ImportInstanceReport[]

Features

  • Reports all CAD Links and Imports in a Revit document
  • External Revit and Family documents can be reported using the filePath input
  • Use the ImportInstanceReport query nodes to return the details about the ImportInstance including its link status and host level
  • Use the close input to close any files opened using the filePath input
  • Automatically closes any open external documents when the graph or Dynamo is closed

User Guide

SetLayerVisibility

Set the visibility of the layer from the input Import Instance by name. True will show the visibility of the layer in the given view, false will hide it. Note that any view overrides or view templates applied to the view will override this node. If you are using view templates, input the view template as the view (view templates are a type of view in Revit).

Download example graph

Inputs

importInstanceImportInstance
viewView
layerNamestring
visiblebool

Outputs

importInstanceImportInstance

Features

  • Set the visibility of a layer in a CAD instance
  • Returns the modified import instance

User Guide

SetLayerVisibility example

SetObjectStyle

Set the weight and colour of layers in a CAD Link or Import (its Revit Object Styles). Enter the required layers as strings – note that layer names are case-sensitive.

Download example graph

Inputs

importInstanceImportInstance
layerNamestring
projectionWeightint
colorColor

Outputs

reportstring

Features

  • Modify weight and color of CAD Link/Import layer Object Styles

User Guide