• InfoWorks WS Pro

Setting up a live data configuration

Set up a live data configuration by connecting to a database.


Tutorial resources

These downloadable resources will be used to complete this tutorial:

iwsp2023M10.zip

Step-by-step Guide

Setting up a live data configuration in InfoWorks WS Pro can sometimes be complicated, as the process can change, depending on the types of connections, and for what purpose.

Note: This example uses a relatively simple method involving a CSV database. This method would probably not be used in the real world, except for calibration purposes. However, it serves as an easily understandable example of the steps involved with connecting a live data configuration.

  1. Open a transportable database and import the file by copying and pasting it into the Database.
  2. Right-click the model group and select New > Live Data Configuration.

New > Live Data Configuration option.

  1. The New Name - Live Data Configuration dialog box opens. The name “Live Data Configuration” appears by default. Click OK.

The Live Data Configuration now appears under the model group.

  1. Double-click the Live Data Configuration to open a blank grid.

At the bottom of the window, there are several tabs, including Live Data Point, Zone, and Live Data Logon.

  1. Click the Live Data Logon tab to open it.

Live Data Configuration grid with tabbed options. Live Data Logon tab highlighted.

This is where you will tell the model where to look for the databases you want to connect to and enter any other relevant information.

It is best practice to work in the Live Data Logon tab first when connecting to a new database.

  1. Click the cell in the first row of the Connection Name column.
  2. Enter the name "Bridge".
  3. In the first row of the Database Type column, expand the drop-down on the right side of the cell.

There are several live data connection options, including JET, Oracle, and SQL Server.

  1. Click CSV.

Live Data Configuration window on the Live Data Logon tab. Database Type drop-down displaying available type, with CSV selected.

Note: If the database were in a different time zone than your own, then you would expand the drop-down under the Time Zone column and select the appropriate one. In this example, no time zone is selected.

  1. Click the cell in the row below CSV in the Database Type column, then scroll to the right.

Live Data Configuration window on the Live Data Logon tab. Filename / Folder column displays a red cell.

All cells in the first row are now grayed out except for the cell under the Filename / Folder column, which is red. A red cell indicates that there is required data that is missing and will change depending on the type of database you choose. For example, if you set the database type as an SQL Server, several additional cells highlight in red. Generally, more complex database types require more information.

  1. Change the database type back to CSV.
  2. In the first row under the Filename / Folder column, copy the file path Data > Live Data and paste it into the cell using CTRL+C and CTRL+V.
  3. Right-click the left margin of the first row and select Test connection....

In this example, a notification appears to tell you the connection test was successful.

  1. Click OK or close the notification.

In the event of a failed connection test, the notification would list the causes, such as an incorrect username or insufficient permission.