OBJECT ANALYZER

Get started with Source Control

Step by step guide to get started with tracking all object modifications in your Microsoft Dynamics NAV & Business Central installation. 

Learn how to set up the Source Control connector, create your first snapshot and connect to your database. 

Watch the video guide, or follow each step below for a more detailed guide. 

Get started with Source Control

Preparation of Source Control

NAVToolbox login

Notice

Please note that creating a new user in an incognito browser does not work. 

Step 1

Create a user

A user is required in order for the Source Control Connector to be able to communicate with Object Analyzer. 

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

Step 2

Download the Source Control Connector

The Source Control Connector is an independent application that connects to your NAV/BC database with your snapshot in Object Analyzer, hosted on Azure.

  1. Download the zip-file.
  2. Extract the file to a folder of your choice
  3. With the folder open, select the application file “NAVToolbox Source Control Connector” (.exe) and open the app. 

Notice: If Microsoft Defender prevents the app from starting, press “more info” > “Run anyway”. Let windows run the application. 

Step 3

Configuring Source Control

1. On the connector panel press “Log in”. A new window will appear in your browser.

 2. Confirm and proceed to the next screen. After getting the message “Congratulations, you’re all set” close the tab. You should now be logged in on the Source Control Connector. 

right-arrow

Extra notice:

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

You might also have to change your firewall settings, so port 443 is open and allows the website https://*navtoolbox.com through. 

Creating your first snapshot for Source Control

Step 4

Create a snapshot in Object Analyzer

Now it’s time to create a snapshot in Object Analyzer for the database you want to have Source Control. 

Pressing the “Create” button on the connector will take you directly to the “Create Snapshot” menu iObject Analyzer. If you end up on the dashboard page, press here.

Step 5

Finding the Snapshot function in Object Analyzer

In Object Analyzer navigate to “Snapshots” at the top of the interface.

(skip to step 6 if you’re already at the “create snapshot” page)

arrow-down green

On the next page press “create snapshot” 

Step 5

At “Create Snapshot” screen you only have to fill out fields marked with a *. Ignore the optional fields for now. 

Snapshot information

  1. Choose your product version of Dynamics NAV / BC
  2. Select the correct country version
  3. Type in a custom name for your snapshot, so you can recognize it later.
  4. Choose the availability type (all, group or user level).
  5. When all mandatory fields are filled out, press the green “create” button in the bottom right corner and proceed. You might be charged a fee depending of your plan. 

The field “Auto Updated Snapshot” will automatically be marked at the bottom in order to use the snapshot function with Source Control.

Notice:

Object Analyzer will attempt to use the correct date and time formats for your solution, but we recommend you check these exported formats manually to ensure they are correct prior to starting.

You will then be redirected to the next page, where the Snapshot Details are presented, which means that your snapshot has been created. 

5. Press on the “Base Objects” tab. A note will appear, “This snapshot is ready to be linked with Source Control to generate the objects for this snapshot”, meaning that you can return to the Source Control Connector.

 

6. On the Source Control Connector press “Refresh” and the name of your snapshot will appear on the list. 

Setting up the connector

Step 6

Set up the connection from NAV/BC to Object Analyzer

It is now time to set up a connection that points to the NAV/BC database you want to track. 

1. Select the snapshot you want to connect with. 

2. Enter your server and database name. 

You can get the required information from opening your NAV or BC development client. Check the SQL database server and database name under “information” or “open”. 

 

Copy it to the fields in the Source Control Connector, so the application knows, which database to connect to.

Step 7

Locate the Finsql file

Find the path to the finsql.exe file of the NAV/BC version that is connected to the database you want to enable Source Control on. 

Specify this path in Source Control.

 

The setup should now look similar to this:

Step 8

Scheduling and update frequency

Choose how often you want Source Control to check for updates. 

1. Mark the “Active” field. Two additional fields will become mandatory.

2. Choose a computer name. The name must match the local system. You can either choose to:

  • Press “Set on this computer”
  • Manually type in the name of the computer that Source Control runs on.


3. Select an update frequency. The update frequency will determine, how often the application automatically checks for changes made to objects in your selected database. You can either choose:

  • One of the default frequencies
  • Set your own update frequency. Read more by pressing the small “Help?” button and set your own update frquency. 

Save your configurations at the bottom of the connector. 

Step 9

Starting the connection

In order for Source Control to process your NAV Objects, the Local System needs permissions to the database that you want to connect to.
1. In the Microsoft SQL Server Management Studio navigate to your Database Security Folder > Security > Login > find the NT Authority\SYSTEM > open properties on this user.

2. In properties, navigate to User Mapping > find the relevant database you want to connect to, and give db_owner permission.

3. At the top of the connector at Windows Service press “Install”.

4. Now the service is ready. Press “Start” to start Source Control. 

The service should now automatically be running in the background and the status should indicate “running” at the top. The Source Control Connector is now properly set up. You can now continuously observe object modifications and changes in your snapshots in Object Analyzer. 

Warning for the first-time setup:

First time the Source Control Connector connects to a new snapshot, it must transfer all objects. If you make any changes to any objects in the progress, the snapshot will be corrupted, and you will have to delete it and start all over. 

So ensure no one makes changes to any objects during this process that will take approximate 30 minutes depending on your internet speed and the number of objects.  

You can view the progress of the snapshots in Object Analyzer

Get the most out of Source Control

Always be sure to start the Source Control Connector before making any changes to objects in your version of NAV/BC. Otherwise some changes to data may not be shown in Object Analyzer.

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

Info a snapshot also provides:

See for yourself how Source Control works

Join a LIVE 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 tracking object modifications can benefit your business.

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