Questions about this article, topic, or product? Click here. 

Creating a connection

You can get to the iTwin Synchronizer portal from iModel Manager. In iModel context menu choose Connections action.

Setting up a connection

Follow these steps to create a connection:
  1. Find required iModel in iModel Manager page
  2. Choose Connections in a context menu
  3. Click Create connection button, if there are no connections for selected iModel
       Or
    Click + New button, if there are already other connections created
    NOTE: you will be presented with a step-based wizard. 
  4. Choose a data source where you store your design files.
    You can find the list of available data sources and how to integrate with them on the Integrations page.

Setting up a data mapping

To correctly synchronize changes from the data source, you need to perform data mapping. Follow these steps to map your design files with an iModel:
  1. Select composite models - the data you want to be synchronized with an iModel. 
    Bulb NOTE: You should select only the discipline composite files when creating a connection.  All of the reference files will be automatically added to the synchronization. For a data source specific limitations check the Integrations page.

  2. Define the geocoordinate system. Pick a file from a previous step from which we will extract a geographic coordinate system to be used in an iModel.
    If you totally skip it, we will use the first found file which geolocation data for an iModel during synchronization, or if none exists iModel will not have any geocoordinate system defined.
    Bulb NOTE: This step requires to pick a file only for the first iModel connection. For the sequential connections, the same file will be used, so this step will be skipped.


  3. Based on your mapped files define which iModel connector needs to be used. In this step, you can also check which files and their references will be mapped to an iModel.
    Check supported iModel connectors here: https://communities.bentley.com/products/digital-twin-cloud-services/itwin-services/w/synchronization-wiki/47595/supported-applications-and-file-formats 
    BulbNOTE: You can use only one iModel connector type in a connection for all the mapped files.  If your files need to be processed by different connector type, please split them into separate connections and associate appropriately. For instance, .rvt and .dwg files should not be mapped together using the Revit connector type as it might lead to missing graphics or properties. Instead, you should create one connection for .rvt (Revit connector) and one for .dwg (AutoCAD connector).

NOTE: Depending on the connection and number of references the files may take some time to populate and is not necessary for it to load to move on to the final step. Once the Connector type is selected "Next" can be used to move on to "Configure Connection".



Scheduling a synchronization

You can schedule automatic synchronization runs during connection setup. There are different options to choose from:

  • Every 4 hours. This is the shortest available schedule.
  • Daily. You can set any particular time during the day
  • Weekly. You can set the day and time.

If you do not want the scheduled synchronization runs, choose Never. 

You can always synchronize the connection manually, even if you have created a schedule.

Recommended
Related
Communities
Support and Services
Training and Learning
Social Media