IModelDb Namespace
Class
| Name | Description |
|---|---|
| IModelDb.Elements | The collection of elements in an IModelDb. |
| IModelDb.Models | The collection of models in an IModelDb. |
| IModelDb.Views | The collection of views in an IModelDb. |
Defined in
- backend/src/IModelDb.ts Line 1335
IModelDb Class
An iModel database file. The database file can either be a briefcase or a snapshot.
see About IModelDb
Extends
Extended by
Methods
| Name | Description | |
|---|---|---|
| abandonChanges(): void | Abandon pending changes in this iModel. | |
| acquireSchemaLock(): Promise<void> | Acquire the exclusive schema lock on this iModel. | |
| addNewFont(name: string, type?: FontType): number | Add a new font name/type to the FontMap for this iModel and return its FontId. | Beta |
| clearCaches(): void | Clear all in-memory caches held in this IModelDb. | |
| close(): void | Close this IModel, if it is currently open. | |
| computeProjectExtents(options?: ComputeProjectExtentsOptions): ComputedProjectExtents | Compute an appropriate project extents for this iModel based on the ranges of all spatial elements. | |
| constructEntity<T extends Entity<T>>(props: EntityProps): T | Construct an entity (Element or Model) from an iModel. | |
| containsClass(classFullName: string): boolean | Query if this iModel contains the definition of the specified class. | |
| createQueryReader(ecsql: string, params?: QueryBinder, config?: QueryOptions): ECSqlReader | Allow to execute query and read results along with meta data. | Beta |
| deleteFileProperty(prop: FilePropertyProps): void | delete a "file property" from this iModel | |
| deleteSettingDictionary(name: string): void | Delete a SettingDictionary, previously added with IModelDb.saveSettingDictionary, from this iModel. | Beta |
| exportGraphics(exportProps: ExportGraphicsOptions): DbResult | Export meshes suitable for graphics APIs from arbitrary geometry in elements in this IModelDb. | |
| exportPartGraphics(exportProps: ExportPartGraphicsOptions): DbResult | Exports meshes suitable for graphics APIs from a specified GeometryPart | |
| generateElementGraphics(request: ElementGraphicsRequestProps): Promise<undefined | Uint8Array> | Generate graphics for an element or geometry stream. | |
| getBriefcaseId(): number | Get the briefcase Id of this iModel | |
| getGeoCoordinatesFromIModelCoordinates(props: GeoCoordinatesRequestProps): Promise<GeoCoordinatesResponseProps> | Get the GeoCoordinate (longitude, latitude, elevation) corresponding to each IModel Coordinate point in the input | |
| getGeometryContainment(props: GeometryContainmentRequestProps): Promise<GeometryContainmentResponseProps> | Get the clip containment status for the supplied elements. | |
| getIModelCoordinatesFromGeoCoordinates(props: IModelCoordinatesRequestProps): Promise<IModelCoordinatesResponseProps> | Get the IModel coordinate corresponding to each GeoCoordinate point in the input | |
| getJsClass<T extends undefined>(classFullName: string): T | Get the JavaScript class that handles a given entity class. | |
| getMassProperties(props: MassPropertiesRequestProps): Promise<MassPropertiesResponseProps> | Get the mass properties for the supplied elements. | |
| getMetaData(classFullName: string): EntityMetaData | Get metadata for a class. | |
| getSchemaProps(name: string): ECSchemaProps | Returns the full schema for the input name. | |
| importSchemas(schemaFileNames: string[], options?: SchemaImportOptions): Promise<void> | Import an ECSchema. | |
| isBriefcaseDb(): this is BriefcaseDb | Type guard for instanceof BriefcaseDb | |
| isSnapshotDb(): this is SnapshotDb | Type guard for instanceof SnapshotDb | |
| performCheckpoint(): void | Save all changes and perform a checkpoint on this IModelDb. | |
| prepareStatement(sql: string, logErrors: boolean = true): ECSqlStatement | Prepare an ECSQL statement. | |
| query(ecsql: string, params?: QueryBinder, options?: QueryOptions): AsyncIterableIterator<any> | Execute a query and stream its results | Deprecated |
| queryEntityIds(params: EntityQueryParams): Id64Set | Query for a set of entity ids, given an EntityQueryParams | |
| queryFilePropertyBlob(prop: FilePropertyProps): undefined | Uint8Array | Query a "file property" from this iModel, as a blob. | |
| queryFilePropertyString(prop: FilePropertyProps): undefined | string | Query a "file property" from this iModel, as a string. | |
| queryNextAvailableFileProperty(prop: FilePropertyProps): number | Query for the next available major id for a "file property" from this iModel. | |
| queryRowCount(ecsql: string, params?: QueryBinder): Promise<number> | Compute number of rows that would be returned by the ECSQL. | Deprecated |
| querySchemaVersion(schemaName: string): undefined | string | Query for a schema of the specified name in this iModel. | |
| restartQuery(token: string, ecsql: string, params?: QueryBinder, options?: QueryOptions): AsyncIterableIterator<any> | Cancel any previous query with same token and run execute the current specified query. | Deprecated |
| saveChanges(description?: string): void | Commit pending changes to this iModel. | |
| saveFileProperty(prop: FilePropertyProps, strValue: undefined | string, blobVal?: Uint8Array): void | Save a "file property" to this iModel | |
| saveSettingDictionary(name: string, dict: SettingObject): void | Save a SettingDictionary in this iModel that will be loaded into workspace.settings every time this iModel is opened in future sessions. |
Beta |
| tryPrepareStatement(sql: string): undefined | ECSqlStatement | Prepare an ECSQL statement. | |
| updateEcefLocation(ecef: EcefLocation): void | Update the EcefLocation of this iModel. | |
| updateIModelProps(): void | Update the IModelProps of this iModel in the database. | |
| updateProjectExtents(newExtents: Range3d): void | Update the project extents for this iModel. | |
| withPreparedSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T, logErrors: boolean = true): T | Use a prepared SQL statement, potentially from the statement cache. | |
| withPreparedStatement<T>(ecsql: string, callback: (stmt: ECSqlStatement) => T, logErrors: boolean = true): T | Use a prepared ECSQL statement, potentially from the statement cache. | |
| withSqliteStatement<T>(sql: string, callback: (stmt: SqliteStatement) => T, logErrors: boolean = true): T | Prepared and execute a callback on a SQL statement. | |
| withStatement<T>(ecsql: string, callback: (stmt: ECSqlStatement) => T, logErrors: boolean = true): T | Prepared and execute a callback on an ECSQL statement. | |
| findByFilename(fileName: string): undefined | IModelDb Static | Find an opened instance of any subclass of IModelDb, by filename | |
| findByKey(key: string): IModelDb Static | Find an open IModelDb by its key. | |
| forEachMetaData(iModel: IModelDb, classFullName: string, wantSuper: boolean, func: PropertyCallback, includeCustom: boolean = true): void Static | Invoke a callback on each property of the specified class, optionally including superclass properties. | |
| tryFindByKey(key: string): undefined | IModelDb Static | Attempt to find an open IModelDb by key. | |
| validateSchemas(filePath: string, forReadWrite: boolean): SchemaState Static | Determines if the schemas in the Db must or can be upgraded by comparing them with those included in the |
Inherited methods
| Name | Inherited from | Description |
|---|---|---|
| cartographicToSpatialFromEcef(cartographic: Cartographic, result?: Point3d): Point3d | IModel | Convert a Cartographic to a point in this iModel's Spatial coordinates using its ecefLocation. |
| ecefToSpatial(ecef: Readonly<WritableXYAndZ>, result?: Point3d): Point3d | IModel | Convert a point in ECEF coordinates to a point in this iModel's Spatial coordinates using its ecefLocation. |
| getEcefTransform(): Transform | IModel | Get the Transform from this iModel's Spatial coordinates to ECEF coordinates using its ecefLocation. |
| getRpcProps(): IModelRpcProps | IModel | Return a token for RPC operations. |
| setEcefLocation(ecef: EcefLocationProps): void | IModel | Set the EcefLocation for this iModel. |
| setGeographicCoordinateSystem(geoCRS: GeographicCRSProps): void | IModel | Sets the geographic coordinate reference system from GeographicCRSProps. |
| spatialToCartographicFromEcef(spatial: Readonly<WritableXYAndZ>, result?: Cartographic): Cartographic | IModel | Convert a point in this iModel's Spatial coordinates to a Cartographic using its ecefLocation. |
| spatialToEcef(spatial: Readonly<WritableXYAndZ>, result?: Point3d): Point3d | IModel | Convert a point in this iModel's Spatial coordinates to an ECEF point using its ecefLocation. |
| getDefaultSubCategoryId(categoryId: string): string Static | IModel | Get the default subCategoryId for the supplied categoryId |
Properties
| Name | Type | Description | |
|---|---|---|---|
| _fontMap Protected | undefined | FontMap | ||
| codeSpecs Accessor ReadOnly | CodeSpecs | Get the CodeSpecs in this IModel. | |
| defaultLimit StaticReadonly | "1000" | ||
| elements Readonly | IModelDb.Elements | ||
| fontMap Accessor ReadOnly | FontMap | ||
| holdsSchemaLock Accessor ReadOnly | boolean | determine whether the schema lock is currently held for this iModel. | |
| iModelId Accessor ReadOnly | string | The Guid that identifies this iModel. | |
| isBriefcase Accessor ReadOnly | boolean | Returns true if this is a BriefcaseDb | |
| isReadonly Accessor ReadOnly | boolean | Check if this iModel has been opened read-only or not. | |
| isSnapshot Accessor ReadOnly | boolean | Returns true if this is a SnapshotDb | |
| locks Accessor ReadOnly | LockControl | Get the LockControl for this iModel. | |
| maxLimit StaticReadonly | "10000" | ||
| models Readonly | IModelDb.Models | ||
| onBeforeClose Readonly | BeEvent<() => void> | Event called when the iModel is about to be closed. | |
| onChangesetApplied Readonly | BeEvent<() => void> | Event called after a changeset is applied to this IModelDb. | |
| pathName Accessor ReadOnly | string | Get the full path fileName of this iModelDb | |
| relationships Accessor ReadOnly | Relationships | Get the linkTableRelationships for this IModel | |
| tiles Readonly | IModelDb.Tiles | ||
| views Readonly | IModelDb.Views | ||
| workspace Accessor ReadOnly | Workspace | Get the Workspace for this iModel. |
Inherited properties
| Name | Type | Inherited from | Description |
|---|---|---|---|
| _openMode Protected | OpenMode | IModel | |
| changeset | ChangesetIdWithIndex | IModel | |
| dictionaryId StaticReadonly | string | IModel | The Id of the dictionary model. |
| ecefLocation Accessor | undefined | EcefLocation | IModel | The EcefLocation of the iModel in Earth Centered Earth Fixed coordinates. If the iModel property geographicCoordinateSystem is not defined then the ecefLocation provides a geolocation by defining a 3D coordinate system relative to the Earth model WGS84. Refer to additional documentation for details. If the geographicCoordinateSystem property is defined then the ecefLocation must be used with care. When the geographicCoordinateSystem is defined it indicates the iModel cartesian space is the result of a cartographic projection. This implies a flattening of the Earth surface process that results in scale, angular or area distortion. The ecefLocation is then an approximation calculated at the center of the project extent. If the project is more than 2 kilometer in size, the ecefLocation may represent a poor approximation of the effective cartographic projection used and a linear transformation should then be calculated at the exact origin of the data it must position. |
| geographicCoordinateSystem Accessor | undefined | GeographicCRS | IModel | The geographic coordinate reference system of the iModel. |
| globalOrigin Accessor | Point3d | IModel | An offset to be applied to all spatial coordinates. |
| isGeoLocated Accessor ReadOnly | boolean | IModel | True if this iModel has an EcefLocation. |
| iTwinId Accessor ReadOnly | undefined | string | IModel | The Guid that identifies the iTwin that owns this iModel. |
| key Accessor ReadOnly | string | IModel | Get the key that was used to open this iModel. This is the value used for Rpc and Ipc communications. |
| name Accessor | string | IModel | Name of the iModel |
| onEcefLocationChanged Readonly | BeEvent<(previousLocation: undefined | EcefLocation) => void> | IModel | Event raised after ecefLocation changes. |
| onGeographicCoordinateSystemChanged Readonly | BeEvent<(previousGCS: undefined | GeographicCRS) => void> | IModel | Event raised after geographicCoordinateSystem changes. |
| onGlobalOriginChanged Readonly | BeEvent<(previousOrigin: Point3d) => void> | IModel | Event raised after globalOrigin changes. |
| onNameChanged Readonly | BeEvent<(previousName: string) => void> | IModel | Event raised after name changes. |
| onProjectExtentsChanged Readonly | BeEvent<(previousExtents: Range3d) => void> | IModel | Event raised after projectExtents changes. |
| onRootSubjectChanged Readonly | BeEvent<(previousSubject: RootSubjectProps) => void> | IModel | Event raised after rootSubject changes. |
| openMode Accessor ReadOnly | OpenMode | IModel | The OpenMode used for this IModel. |
| projectExtents Accessor | Range3d | IModel | The volume, in spatial coordinates, inside which the entire project is contained. |
| repositoryModelId StaticReadonly | string | IModel | The Id of the repository model. |
| rootSubject Accessor | RootSubjectProps | IModel | The name and description of the root subject of this iModel |
| rootSubjectId StaticReadonly | string | IModel | The Id of the root subject element. |
Defined in
- backend/src/IModelDb.ts Line 215
Last Updated: 30 November, 2023