DIQ_DrawingRevision

Last updated 20/07/2026

Overview

The

DIQ_DrawingRevision

type represents a specific revision of a drawing file associated with a project revision in DimensionIQ.

It contains the drawing metadata, source information, file data, and validation information required for DimensionIQ to load, process, display, and maintain a drawing within a project.

DIQ_DrawingRevision

objects are created and maintained by DimensionIQ. The values contained within the object are generated and managed by DimensionIQ and should be treated as read-only by the host application.

The host application is responsible for persisting

DIQ_DrawingRevision

records within its preferred storage system, including the supplied drawing stream data. This may include a database, file storage, object storage service, or another persistence mechanism selected by the host application.

When DimensionIQ creates or updates a drawing revision, the complete

DIQ_DrawingRevision

object should be stored or updated using the values supplied by DimensionIQ.

The host application may use the persisted drawing revision data for workflows such as drawing management, revision tracking, reporting, audit history, and integration with other project systems.

Properties

Property	Type	Required	Description
key	string	Yes	Unique identifier for the drawing revision, used for referencing and persistence
drawingFolderKey	string	Yes	Identifies the parent drawing folder this belonged to
revisionKey	string	Yes	References the DIQ_Revision that this drawing is associated with
name	string	Yes	Display name of the drawing revision shown in the UI
filename	string	Yes	Original filename of the drawing file
loaderType	string	Yes	Identifies the loader responsible for interpreting the drawing (eg, PDF loader, CAD loader)
loaderVersion	string	Yes	Specifies the loader version used to process the drawing
drawingType	string	Yes	An internal type identifier for the drawing
storageKey	string	Yes	Foreign key into DIQ_Storage.key
checksum	string	Yes	Integrity checksum used to validate the storage content
notes	string	No	Optional descriptive notes related to this drawing revision

Implementation Guidelines

Data Persistence

DIQ_DrawingRevision

objects should be persisted by the host application exactly as provided by DimensionIQ.

The host application is responsible for selecting and maintaining its own storage mechanism for both the drawing metadata and the supplied drawing stream data. This may include storing the complete object together or separating metadata and file content according to the host application's storage architecture.

The host application should not create, modify, or process

DIQ_DrawingRevision

values. DimensionIQ is responsible for generating the drawing data, loader information, and validation values required for the drawing to function correctly.

When a new

DIQ_DrawingRevision

is received from DimensionIQ, the host application should persist the object. When an updated object is received, the existing stored record should be updated using the values supplied by DimensionIQ.

Revision Relationships

The

revisionKey

property identifies the project revision associated with the drawing.

The

drawingFolderKey

property identifies the folder used to organize the drawing within the project structure.

These relationships should be stored exactly as provided by DimensionIQ to allow the drawing revision to be correctly associated with its project context.

Loader Information

The

loaderType

,

loaderVersion

, and

drawingType

properties identify the drawing processing requirements used by DimensionIQ.

These values should be persisted without modification as they provide the information required to correctly interpret the associated drawing stream.

The host application should not attempt to replace or alter loader information supplied by DimensionIQ.

Drawing Metadata Usage

Properties such as

name

,

filename

, and

notes

may be consumed by the host application for its own workflows.

These values can be used for drawing management, revision history, reporting, filtering, search, and integration with other project-related systems.

Read-Only Behavior

All

DIQ_DrawingRevision

properties should be considered read-only from the perspective of the host application.

The host application may store and consume the drawing revision data but should not modify identifiers, drawing content, loader information, checksums, or DimensionIQ managed metadata.

Any changes to a drawing revision should be performed through DimensionIQ, which will provide the updated

DIQ_DrawingRevision

object to the host application for persistence.