ImportInstanceReport

Query nodes for extracting detailed information from ImportInstanceReport objects, including link status, host levels, owner views, and workset data.

The ImportInstanceReport nodes provide comprehensive access to CAD Link and Import properties in Revit projects. These query nodes enable you to interrogate ImportInstance data including whether instances are linked or imported, their host levels, owner views, qualified paths, link status from the Revit API, and workset assignments. Use these nodes in conjunction with ImportInstance.ReportInstances to audit and manage CAD data across your project.


ImportInstance

Returns the ImportInstance which the report has evaluated.

Inputs

importInstanceReportImportInstanceReport

Outputs

ImportInstanceImportInstance

Features

  • Returns the wrapped ImportInstance from the report

User Guide

ImportInstance example


IsLinked

A query node which returns true if the ImportInstance is linked or false if it is imported.

Inputs

importInstanceReportImportInstanceReport

Outputs

boolbool

Features

  • Returns true if the ImportInstance is linked otherwise returns false

User Guide

IsLinked example


LevelHost

A query node which returns the Level Element of the ImportInstance or null if the instance is not hosted to a level.

Inputs

importInstanceReportImportInstanceReport

Outputs

LevelLevel

Features

  • Returns the Level Element of the ImportInstance

User Guide

LevelHost example


A query node which returns the link status of the ImportInstance. The status is derived from the Revit API LinkedFileStatus enum values.

Inputs

importInstanceReportImportInstanceReport

Outputs

stringstring

Features

  • Returns the link status of the ImportInstance
  • Returns one of the following values: CanBeUpgraded, Imported, InClosedWorkset, Invalid, Loaded, LocallyUnloaded, NotFound, and Unloaded
  • If the link derives from BIM 360, returns one of the following values: Uninitialized, LinkLoaded, LinkNotFound, LinkNotOpenable, LinkOpenAsHost, SameModelAsHost, SameCentralModelAsHost, LinkNotLoadedOtherError, LinkMayBeUpgraded, ExternalServerMissing, LinkExists, CouldNotChangeViewReference, UsedExisting

User Guide

LinkStatus example


OwnerView

A query node which returns a View Element if the ImportInstance has an owner view, otherwise returns null.

Inputs

importInstanceReportImportInstanceReport

Outputs

ViewView

Features

  • Returns the owner view of the ImportInstance or null if it has no owner view

User Guide

OwnerView example


Path

Returns the path from the ImportInstance in the report if it is linked, otherwise returns an empty string if the instance is not linked, i.e. imported.

Inputs

importInstanceReportImportInstanceReport

Outputs

stringstring

Features

  • Returns the qualified path to the ImportInstance if it is linked or an empty string if it is not linked

User Guide

Path example


WorksetName

A query node which returns the workset name of the ImportInstance.

Inputs

importInstanceReportImportInstanceReport

Outputs

stringstring

Features

  • Returns the workset name of the ImportInstance

User Guide

WorksetName example