Source Control

Get track of all object changes in your Microsoft NAV/BC installation


Get started with Source Control

Let’s take you through 10 easy steps to get started.


Part 1 - setup

Step 1

Install the Source Control Connector

The Source Control Connector is an independent application that connects to our local NAV/BC database with your snapshot in the cloud. It constantly monitors the objects and uploads all changes to the snapshot automatically.

NAVToolbox login

Step 2

Create a user

Create a user on NAVToolbox.com, or directly on the Source Control panel

A user is required in order to access Object Analyzer, to setup your snapshots and monitor your changed objects.

  • Be sure to confirm your email in your inbox, when creating a new user to gain access
  • Stay logged in and keep the tab open for later

Step 3

Open Source Control

After the installation of the Source Control Connector, you need to login.

You can use the same user as your login on Object Analyzer, but we recommend having a separate user for your connector for all your snapshots, and for groups of snapshots.

Be sure to have added the website, https://*auth0.com as one of your trusted websites before attempting to login. Otherwise the connection will fail. 

Open your default browser (in most cases Internet Explorer) > choose settings > security > trusted websites. Add https://*auth0.com as one of your trusted websites. 

Step 4

Set up the connection from NAV/BC to Object Analyzer

It is now time to set up a connection that points to your local NAV/BC database that you want to track. You can get the required information from opening you NAV development client and check the SQL database server and database name. Copy it to the fields in Source Control, so the application knows, which database to connect to.

Step 5

Find the path of the Finsql file

Find the finsql file path of the database you want to analyse with Source Control.

Choose the pathway in Source Control.

Optional: Choose how often you want Source Control to check for updates. The standard update frequency is set to 2 minutes. The update frequency will determine, how often the application automatically checks for changes made to objects in your system. 

Save your configurations.

Part 2 - Analyze with snapshots

Step 1

Create your snapshot in Object Analyzer

Now that you’re all set, you can create your first snapshot in Object Analyzer. 

A snapshot contains all the data of objects in NAV from the particular moment, it was created. Pressing the “create Snapshot” button will take you to Object Analyzer.

(You can skip to step 4, if you have already created a snapshot)

Step 2

Finding the Snapshot function in Object Analyzer

In Object Analyzer choose snapshots at the top of the interface.

On the next page press “create snapshot” 

Step 3

Snapshot information

Be sure to have marked the field “live snapshot” at the bottom in order to use the snapshot function with Source Control.

It is important to note that you must choose the right date and time format of your objects in NAV. Otherwise the connection won’t work. 

After filling out the information, press “create” at the bottom right. You will then be redirected to the next page, where it should say “This snapshot is ready to be linked with Source Control to generate the objects for this snapshot.” at the bottom.

Step 4

Choose the snapshot in Source Control

Now that we have created a snapshot in Object Analyzer, choose the name of the snapshot in Source Control. 

Press the “Start Source Control” button and you’re set. 

A dialogue box will pop up to ask you to confirm your choice. 

Press “Yes” to continue.

Step 5

Running Source Control

The application will now go through all objects based on the snapshot. 

Depending of the number of objects, it may take a while for the Source Control connector to process them. It will give you an estimate of, how long it will take to analyze all objects. You can view which is being processed in the activity log. 

When it has been processed, you can go back to your snapshot in Object Analyzer and view all the snapshot details. 

The overview will show:

  • All objects listed
  • Object changes
  • Modified objects
  • Code comparison
  • Missing documentation
  • Whether the version list has been updated or not

Get more out of Source Control

The “Healthy change” stage check provided under the Modified Object view will show, if you need to make changes to an object in NAV/BC.

Info that snapshots also provide

Always be sure to start the Source Control Connector BEFORE making any changes to objects in your version of NAV/BC. Otherwise it won’t track and show the changes made.  

See for yourself how Source Control works

Learn more about Object Analyzer

The efficient  and powerful tool provides many functions and features such as Hotfix Search and comparing CUs that can be useful to your organization. 

Read more about Object Analyzer’s features and functions.

Use Object Analyzer’s code compare function with Source Control.

Join a webinar about Source Control

Learn more about Source Control by joining one of our exclusive webinars. Our expert, Jesper Kenborg, will take you through the basics and how it can benefit your business longterm.

Our webinars are the best way to see what Source Control and Object Analyzer are capable off.

Want to book a meeting?

Or do you have any questions? Feel free to contact us!