API Reference › core-common› IModels

iModels

Types for working with iModels in both the frontend and backend.

Classes

Name Description  
BackendError  
BlobOptionsBuilder  
BlobReader  
ConflictingLocksError An error raised when there is a lock conflict detected.  
DbQueryError  
EcefLocation The position and orientation of an iModel on the earth in ECEF (Earth Centered Earth Fixed) coordinates  
ECSqlReader Execute ECSQL statements and read the results.  
IModel Represents an iModel in JavaScript.  
IModelError The error type thrown by this module.  
IModelVersion Option to specify the version of the iModel to be acquired and used  
NoContentError Intended for API "no content" semantics where the error case should not trigger application failure monitoring systems.  
PropertyMetaDataMap  
QueryBinder Bind values to an ECSQL query.  
QueryOptionsBuilder  
ServerError  
ServerTimeoutError  
Uint8Chunks  

Enumerations

Name Description  
BriefcaseIdValue Values of BriefcaseId that have special meaning.  
ChangesetType Value to indicate whether a changeset contains schema changes or not  
DomainOptions Option to control the validation and upgrade of domain schemas in the Db  
GeoCoordStatus This enumeration lists all possible status as returned from a coordinate conversion to or from a  
LockState The state of a lock.  
ProfileOptions Options that control whether a profile upgrade should be performed when opening a Db  
QueryRowFormat Specifies the format of the rows returned by the query and restartQuery methods of  
SchemaState The state of the schemas in the Db compared with what the current version of the software expects  
SyncMode Whether a briefcase is editable or may only accept incoming changesets from iModelHub  
TxnAction Describes the types of actions associated with Txns.  

Global Functions

Name Description  
mapToGeoServiceStatus Maps a GeoCoordStatus to the equivalent GeoServiceStatus.  

Interfaces

Name Description  
BaseReaderOptions Config for all request made to concurrent query engine.  
BlobOptions  
BriefcaseDownloader Manages the download of a briefcase  
BriefcaseProps Properties that specify a briefcase within the local briefcase cache.  
ChangesetFileProps Properties of a changeset file  
ChangesetIdWithIndex The Id and optionally the index of a changeset  
ChangesetIndexAndId Both the index and Id of a changeset  
ChangesetProps Properties of a changeset  
ChangesetRange A range of changesets  
ChannelControlError Errors originating from the ChannelControl interface.  
CloudContainerUri TODO documentation  
CloudSqliteError An error originating from the CloudSqlite API.  
ConflictingLock Detailed information about a particular object Lock that is causing the Lock update conflict.  
ConflictingLocks Interface that describes the contents of ConflictingLocksError without relying on that class, since  
CreateIModelProps The properties that can be supplied when creating a new iModel.  
CreateSnapshotIModelProps Options that can be supplied when creating snapshot iModels.  
DbRuntimeStats  
EcefLocationProps Properties that position an iModel on the earth via ECEF (Earth Centered Earth Fixed) coordinates  
FilePropertyProps  
GeoCoordinatesRequestProps Information required to request conversion of an array of iModel coordinates to Geographic Coordinates (longitude and latitude)  
GeoCoordinatesResponseProps Information returned from a request to convert an array of iModel coordinates to Geographic Coordinates (longitude and latitude)  
GeographicCRSInterpretRequestProps Information required to interpret or complete a Geographic CRS in the specified format.  
GeographicCRSInterpretResponseProps Information returned from a request to interpret or complete a Geographic CRS  
IModelCoordinatesRequestProps Information required to request conversion of an array of Geographic coordinates (Longitude/Latitude) to iModel coordinates  
IModelCoordinatesResponseProps  
IModelProps Properties of an iModel that are always held in memory whenever one is opened, both on the frontend and on the backend .  
IModelRpcOpenProps The properties to open a connection to an iModel for RPC operations.  
IModelRpcProps The properties that identify an opened iModel for RPC operations.  
LocalBriefcaseProps Properties of a local briefcase file, returned by BriefcaseManager.getCachedBriefcases and BriefcaseManager.downloadBriefcase  
OpenBriefcaseOptions Options to open a previously downloaded briefcase  
OpenBriefcaseProps Properties for opening a local briefcase file via BriefcaseDb.open  
OpenCheckpointArgs Arguments to open a Checkpoint directly from its cloud container  
OpenDbKey A key used to identify an opened IModelDb between the frontend and backend for Rpc and Ipc communications.  
OpenSqliteArgs Sqlite options.  
PointWithStatus A point converted to iModel coordinates to geographic coordinates or vice-versa by a GeoConverter.  
QueryLimit Specify limit or range of rows to return  
QueryOptions ECSql query config  
QueryPropertyMetaData  
QueryQuota Quota hint for the query.  
QueryRowProxy Methods and ways of accessing values from rows returned by ECSqlReader.  
QueryStats Performance-related statistics for ECSqlReader.  
RequestNewBriefcaseProps Properties for downloading a briefcase to a local file, from iModelHub.  
RootSubjectProps Properties of the Root Subject.  
SnapshotOpenOptions Options to open a SnapshotDb.  
SqliteError An error originating from the SQLiteDb API.  
UpgradeOptions Arguments to validate and update the profile and domain schemas when opening a Db  
ViewStoreError Errors thrown by the ViewStore API.  

Namespaces

Name Description  
ChannelControlError  
CloudSqliteError  
SqliteError  
ViewStoreError  
WorkspaceError Errors thrown by the Workspace APIs.  

Type Aliases

Name Description  
BlobRange  
BriefcaseId The Id assigned to a briefcase by iModelHub, or Unassigned .  
ChangesetId A string that identifies a changeset.  
ChangesetIndex The index of a changeset, assigned by iModelHub.  
ChangesetIndexOrId either changeset index, id, or both  
CreateEmptySnapshotIModelProps The options that can be specified when creating an empty snapshot iModel.  
IModelConnectionProps The properties returned by the backend when creating a new IModelConnection from the frontend, either with Rpc or with Ipc.  
IModelErrorNumber Numeric values for common errors produced by iTwin.js APIs, typically provided by IModelError.  
IModelVersionProps Properties for IModelVersion  
LocalDirName  
LocalFileName  
QueryValueType The format for rows returned by ECSqlReader.  
StandaloneOpenOptions Options to open a StandaloneDb via StandaloneDb.openFile from the backend,  

Last Updated: 16 April, 2025