insert Method
insert(txn) @beta
Insert this Element into the iModel using the supplied EditTxn.
insert(txn: EditTxn): string
@see IModelDb.Elements.insertElement
@note For convenience, the value of this.id is updated to reflect the resultant element's id.
However when this.federationGuid is not present or undefined, a new Guid will be generated and stored on the resultant element. But
the value of this.federationGuid is not updated. Generally, it is best to re-read the element after inserting (e.g. via IModelDb.Elements.getElement)
if you intend to continue working with it. That will ensure its values reflect the persistent state.
| Parameter | Type | Description |
|---|---|---|
| txn | EditTxn |
Returns - string
insert()
Deprecated Use Element.insert(txn) instead.
Insert this Element into the iModel.
insert(): string
Returns - string
Defined in
- backend/src/Element.ts Line 669
Last Updated: 28 April, 2026
Found something wrong, missing, or unclear on this page? Raise an issue in our repo.