Exposure to End-User
When updaters work as they should, they are transparent to the user. In some special cases though, Revit will display a warning to the user concerning a 3rd party updater. Such messages will use the value of the GetUpdaterName() method to refer to the updater.
Updater not installed
If a document is modified by a non-optional updater and later loaded when that updater is not installed, a task dialog similar to the following is displayed:
Figure 135: Missing Third Party Updater Warning
Updater performs invalid operation
If an updater has an error, such as an unhandled exception, a message similar to the following is displayed giving the user the option to disable the updater:
Figure 136: Updater performed an invalid operation
If the user selects Cancel, the entire transaction is rolled back. In the Wall Updater example from earlier in this chapter, the newly added wall is removed. If the user selects Disable Updater, the updater is no longer called, but the transaction is not rolled back.
Infinite loop
In the event that an updater falls into an infinite loop, Revit will notify the user and disable the updater for the duration of the Revit session.
Two updaters attempt to edit same element
If an updater attempts to edit the same parameter of an element that was updated by another updater in the same transaction, or if an updater attempts to edit the geometry of an element in a way that conflicts with a change made by another updater, the updater is canceled, an error message is displayed and the user is given the option to disable the updater.
Central document modified by updater not present locally
If the user reloads latest or saves to central with a central file that was modified by an updater that is not installed locally, a task dialog is presented giving them the option to continue or cancel the synchronization. The warning indicates that proceeding may cause problems with the central model when it is used with the third party updater at a later time.