Skip to main content
Skip table of contents

Synchronizing ArchiCAD Objects with Occurrences

The dRofus Addon allows to synchronize data between parameters of ArchiCAD Objects and attributes of dRofus Item Occurrences.

For this to occur, the ArchiCAD Objects need to be linked to dRofus Items. (Refer to Linking ArchiCAD Objects to Items in dRofus.)

Also, the ArchiCAD Zones (in which Objects have been placed) need to be linked with dRofus Rooms (in which Items have been planned). (Refer to Linking ArchiCAD Zones.)

To synchronize data between ArchiCAD Objects and dRofus Item Occurrences, select Sync Instance Data with dRofus within the dRofus Menu:


The Synchronize Item occurrences dialog panel shows how the Objects placed in Zones in ArchiCAD compare against Items planned in Rooms in dRofus, and what would happen if synchronization was carried out for the chosen Objects.

A more detailed overview of the Objects in Zones vs Items in Room can be viewed within the Link status dialog, which can be accessed by clicking on the 

 button. (Refer to Linked ArchiCAD Objects in Zones Status.)

In addition to synchronizing the data, the above dialog can also assist in reconciling the count of placed Objects in Zones vs. planned Items in Rooms by creating, deleting and updating occurrences in dRofus. This is enabled by checking the box next to Create/Delete/Update occurrences in dRofus. An Item Occurrence (with quantity that is greater than 1) planned in dRofus can be split into multiple Occurrences where it matches multiple Objects placed in ArchiCAD. This may be required where the values differ between occurrences of the same Item.


There are two doors designed to be in the same Room, and there is an Occurrence of the door type planned in dRofus with quantity 2. The Occurrence planned in dRofus matches the door objects designed in the model. The door objects have a "Door Number" property containing a unique number for each door. If you want to synchronize the door numbers to dRofus, the option against Create/Delete/Update occurrences in dRofus will need to be checked prior to synchronization. The planned Occurrence (with 2 as quantity) will then be split into 2 Occurrences (each one with 1 as quantity), and each Occurrence can then inherit different values as the door number.

It is also possible to synchronize data such that it is only one-way to the model (i.e., without changing data within dRofus). This can be disabled by unchecking the box next to Update instance data of occurrences planned in dRofus.

Clicking on "Options..." will open the following dialog:

  1. Hide Sub Items: Allows you to choose whether or not to show Sub-Items within the list.
  2. Hide Items not marked 'To be modeled': Allows you to choose whether or not to show Items that are not marked 'To be modeled' within dRofus.
  3. Using Room Configuration: Shows the active Room Configuration. You can swap to another configuration by first clicking on the active configuration and then selecting another preferred configuration.
  4. Using Item Configuration: Shows the active Item Type Configuration. You can swap to another configuration by first clicking on the active configuration and then selecting another preferred configuration.
  5. Using Instance Configuration: Shows the active Item Occurrence Configuration. You can swap to another configuration by first clicking on the active configuration and then selecting another preferred configuration.
  6. Synchronize instances not linked explicitly: Allows you to synchronizing Objects and Occurrences that are not linked to each other, but matches based on the type, parameters and planned quantity.
  7. Synchronize instances matched with ambiguity: exists because there can be a situation when a room contains multiple occurrences of the same type and it is not clear what object should be synchronized to what occurrence. We call these occurrences and objects as "matched with ambiguity". By default they are not synchronized. But if you turn the 4th option on, these objects will be matched to occurrences randomly and will be synchronized. It may be useful when you synchronize the model for the first time and there are no differences between occurrences of the same type. You should still use this option carefully, because it can interfere with the relationships between planned and designed data.
  8. Item Responsibility filter: Allows you to choose which dRofus Item Responsibility to include within the Items in Room list.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.