Tuesday, July 9, 2013

Navisworks Database Link - Primer


One of the things I like about my job is that is the clients I get to interact with. Their needs and challenges are different which makes the job very interesting. Today one of my clients needed to connect database information with their Navisworks models. This is essentially a FM exercise as the data about the equipment is stored in the database and the geometry is in Navisworks. Fortunately, Navisworks provides the means and method to do this, if you can make heads or tails of the process. So lets go thru the process.

For this demo, I am going to use the Gatehouse sample file that ships with Navisworks 2014. You can find the files C:\Program Files\Autodesk\Navisworks Manage 2014\Samples\gatehouse\

The Process

In order to connect an external data source such as an Excel spreadsheet to a Navisworks model, we need to configure a DataTools within Navisworks. We will then be configuring the database connection.

When working with the DataTools in Navisworks, there are a few very important rules to keep in mind. If you are using a 32-bit workstation, then you need to utilize the 32-bit ODBC drivers. 64-bit workstations need to utilize 64-bit ODBC drivers.

The link to Navisworks is one way. Data can be linked and viewed inside of Navisworks, but the data can’t be updated within Navisworks.

My workstations are all Windows 7 64-bit workstations. My PC’s are using Microsoft Office 2007 or 2010 64-bit. My Mac running Windows 7 64-bit on parallels using OpenOffice. I have only been able to make the Navisworks database connection work using 64-bit database drivers. You can download them for free from: http://www.microsoft.com/downloads/details.aspx?familyid=C06B8369-60DD-4B64-A44B-84B371EDE16D&displaylang=en. Make sure that you have download and installed these drivers.

Data Source

The Gatehouse project includes a sample Excel spreadsheet. The first thing I did to the file was add three column headers to identify the “Name”, “Finish” and “Notes” columns (Figure 1). We are creating these labels to identify the columns.

Figure 1 - Data Source with column labels
Our next step is to open Navisworks and the Navisworks model that you want to connect your external data source to. In Navisworks, on the Home tab, Project panel, click on the File Options button (Figure 2). This will open the File Options dialog.


Figure 2 – Accessing the File Options
In the File Options dialog, we will start the process of configure our database connection (Figure 3). As shown in Figure 1, click the DataTools tab and then click the New button to create a new DataTools link to open the New Link dialog.


Figure 3 - File Options dialog for creating a new DataTools link
In the New Link dialog (Figure 4), we first want to name the new link connection we are creating. For this example, I am using the name “Gatehouse Example”. We then need to select the ODBC Driver Connection type. We are going to be working with a Microsoft Excel data source, so select the “Microsoft Excel Driver (*.xls, *.xlsx, )” driver.  Then click the Setup button to open the ODBC Microsoft Excel Setup dialog.



Figure 4 - New Database Connection Link dialog
In the ODBC Microsoft Excel Setup dialog (Figure 5), we will select the version of Excel data file and select the file we will be using. The sample data file that we are using is a Excel 97-2000 version so select “Excel 97-2000” from the Version: dropdown. Then click on the Select Workbook button to find and select the Excel data file. If you have the default installation of Navisworks 2014 and are using the Gatehouse example, you can find the file at: C:\Program Files\Autodesk\Navisworks Manage 2014\Samples\gatehouse\ After you have selected your excel file, click OK to close the ODBC Microsoft Excel Setup dialog.

If you are having issues with your Database Link connecting to Excel, be sure to check the Version of Excel database that you are using.


Figure 5 - ODBC Setup Dialog for Excel
We are now back to the Edit Link dialog box (Figure 6). If we look in the connection section portion of the dialog, under the ODBC Driver selection, you can see that the connection has been updated. We can now complete the SQL String and Fields section of the dialog.


Figure 6 - Edit Link

SQL String

The SQL string is used to specify how the database will be queried. I have found this part of configuring the database connection to be the most difficult. Fortunately, there are a lot of external resources available for creating SQL strings. My personal recommendation is to keep it as simple as possible.

The code that we will be creating for this example is:
SELECT * FROM [Gatehouse_Layerinfo$] WHERE "Name" = %prop("Item","Layer");

We start out our SQL String with SELECT * FROM The “*” is actually a field name, in this particular example, I am using the wildcard to query all the fields.

[Gatehouse_Layerinfo$] This is the Excel sheet tab name that we want to query in our Excel spreadsheet. The Excel sheet tab name must be spelled just as it is in Excel and should be followed with the “$”.

WHERE "Name" = %prop("Item","Layer"); This is where we are going to define what data we are going to bring from the Excel spreadsheet into Navisworks. For our example, we are going to conditional match the value Layer property data for each element that can be found in the Item tab and match that with a value in the Name colum of the Excel spreadsheet.

“Name” refers to column that we will be searching in the Excel file.
%prop is a SQL command that allow you to retrieve model data for conditional matching.
("Item","Layer"); “Item” refers to the Item tab in the Properties Window. “Layer” refers to the internal file property, in this example, the Layer (Figure 7).


Figure 7 – Navisworks Properties Window
In the SQL String section of the Edit Link dialog, enter the following string of text.

SELECT * FROM [Gatehouse_Layerinfo$] WHERE "Name" = %prop("Item","Layer");

The next step in the process is to specify what information we are going to display in the Properties window. In the Field section of the Edit Link dialog (Figure 8), we are going to specify what Field names to list and the display name to use. Using Figure 8 as a reference, add the Field and Display Names.

Note that we are having the Field Name “Name” display as “Layer” in Navisworks. The Name column in our Excel spreadsheet refers to an AutoCAD Layer and rather than changing the column name in Excel, we can have Navisworks use a different Display Name.

Figure 8 - Inserting the Field and Display Names
After you have entering the Field Names, click OK to close the Edit Link dialog box. Make sure that the “Gatehouse Example” DataTools Link that we just created is checked. This will enable it in our current session. Click OK to close the File Options dialog.


Figure 9 - DataTools
When you select an object in Navisworks, note that the Properties Window has a new tab called “Gatehouse Example”. That is the name of the DataTools link that we created. Figure 10 shows an example where we have selected a foundation. The Gatehouse Example tab in the Properties window provides us with the Layer, Finish and Note information from the Excel data file.


Figure 10 - Foundation Selected with External Data Displayed

If you have gotten this far and it is not working, a lot can go wrong. I think setting up the DataTool link can be as complicated and frustrating as using Timeliner. The first thing to check is the SQL String text. Then check to make sure that your using the correct version of Excel, which might be different than the selection, I made in Figure 5.

This Gatehouse example is not the most robust example around, but it is a great starting point. As many of you are aware, CAD and BIM applications are not great data entry applications, so having this type of data linking capabilities is very beneficial.









No comments:

Is anyone using Deep Space for analytics? https://www.deepspacesync.com/