Get started with Source Control
Version Control system for Microsoft Dynamics NAV & Business Central on-prem
The 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 setting up the connection to your database.
Watch the video guide, or follow each step below to get started with the configuration
Table of Contents
Please note that creating a new user in an incognito browser does not work.
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.
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.
- Download the zip-file.
- Extract the file to a folder of your choice. The connector must be on the same server/PC as your Dynamics installation
- 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.
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.
Creating your first snapshot for Source Control
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.
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)
On the next page press “create snapshot”
Filling in the snapshot information for Source Control
At the “Create Snapshot” screen you only have to fill out fields marked with a *. Ignore the optional fields for now.
- Choose your product version of Dynamics NAV / BC
- Select the correct country version
- Type in a custom name for your snapshot, so you can find it later.
- Choose the availability type (all, group or user level).
- When all mandatory fields are filled out, press the green “create” button in the bottom right corner and proceed.
Depending of your subscription, plan you might be charged a fee for creating the snapshot.
The field “Auto Updated Snapshot” will automatically be marked at the bottom in order to use the snapshot function with Source Control.
Important info about the Object Settings
Please ensure that the date and time format is the exact same as the server you are running Source Control on, when choosing the object settings. You can double check the exact date and time format in the NAV Development Environment. Symbols such as – . and / have to be the exact same. They cannot be exchanged with each other and have to be equivalent to the ones shown in your Development Environment.
The object settings CANNOT be edited AFTER the snapshot has been created. If you want to change the date and time format later, you will have to create a new snapshot.
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 should be listed.
Setting up the Source Control connector
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 equivalent fields on the Source Control Connector, so the application knows, which database to connect to.
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:
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.
Remember to press the “Save” button at the bottom of the connector.
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
Watch a webinar about
Learn more about Source Control by watching a previously recorded webinar. Our expert, Jesper Kenborg, will take you through the basics and how tracking object modifications can benefit your organization.
Our webinars are the best way to see what Source Control and Object Analyzer are capable off.