danglingPredecessorsBehavior
Deprecated in 3.x. use IModelTransformOptions.danglingReferencesBehavior instead, the use of the term predecessors was confusing and became inaccurate when the transformer could handle cycles
danglingPredecessorsBehavior: "reject" | "ignore"
The behavior to use when an element reference (id) is found stored as a reference on an element in the source, but the referenced element does not actually exist in the source. It is possible to craft an iModel with dangling references/invalidated relationships by, e.g., deleting certain elements without fixing up references.
@note "reject" will throw an error and reject the transformation upon finding this case.
@note "ignore" passes the issue down to consuming applications, iModels that have invalid element references like this can cause errors, and you should consider adding custom logic in your transformer to remove the reference depending on your use case.
@default "reject"
Defined in
Last Updated: 12 February, 2024