danglingReferencesBehavior

danglingReferencesBehavior: "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"
@beta

Defined in

Last Updated: 06 November, 2024