Access to Dynamicweb TFS

This guide describes how to get access to the Dynamicweb Team Foundation Server and get access to the source code of Dynamicweb, see work items (bugs and product backlogs), etc.

Before you can access the DW TFS server you must apply for Source Code access here.

You first need to create a VPN connection to the Dynamicweb network:

  • Create a new VPN connection to Dynamicweb network – Host name: vpn.dynamicweb.dk (Figure 2.1)
Figure 2.1 Creating a VPN connection
  • Go to Networking > TCP/IPv4 > Properties > Advanced (Figure 2.2):
Figure 2.2 Creating a VPN connection
  • Uncheck the “Use default gateway on remote network” (Figure 2.3)
Figure 2.3 Creating a VPN connection
  • On the security tab, enable these settings (Figure 3.1)
Figure 3.1 Creating a VPN connection

Next, connect to the Team Foundation Server.

This guide uses Visual Studio 2015. VS 2017 can also be used, but screens may be a little different.

To access the team foundation server

  • Connect to VPN
  • Open Visual Studio.
  • In File menu, choose “Open”, “Team Project” (Figure 4.1)
Figure 4.1 Connecting to TFS
  • The URL of the Team Foundation server is dev10.dynamic-systems.lan (Figure 4.2)
  • Click OK.
Figure 4.2 Connecting to TFS

This opens the “Connect to Team Foundation Server” dialog – select the “Dynamicweb” project collection

In this collection there are a number of Team Projects – depending on your permissions you can see more or less of these.

  • To get access to Dynamicweb 8 source code, check the “eCommerce” Team Project
  • To get access to Dynamicweb 9 source code, check the “Dynamicweb9” Team Project

Click the Connect button (Figure 4.3).

Figure 4.3 Connecting to TFS

In the team explorer pane (usually on the right next where the solution explorer is found), you have to select the right “Project” (Figure 5.1). If you have checked both the Dynamicweb 8 and Dynamicweb 9 projects you would have at least 2 projects to switch between in your Team Explorer – make sure you select the right one.

Figure 5.1 Connecting to TFS

To access the Dynamicweb 8 source code:

  • First make sure your Team Explorer is in the “eCommerce” project (Figure 6.1)
Figure 6.1 Verify you're in the right project
  • Click the Source Control Explorer link (Figure 6.2) – or go through View > Other Windows > Source control explorer
Figure 6.2 Click 'Source Control Explorer'
  • This will open the eCommerce folder window (Figure 6.3)
Figure 6.3 The eCommerce folder window
  • Expand the eCommerce folder, and choose the “Dynamicweb8.9.1” branch.
Figure 7.1 Select an appropriate branch

Then the source control need to be mapped:

  • Click the “Not mapped” text/link (Figure 8.1)
Figure 8.1 Click 'Not mapped'
  • This opens the Map dialog (Figure 8.2)
  • Somewhere on you computer, create a folder, i.e. C:\Dynamicweb
  • Click “Map”
Figure 8.2 Map to a local folder

Now it is time to check out some data. Right click the Dynamicweb8.9.1 branch and choose “Get Latest Version” (Figure 9.1). Visual Studio will now download the entire Dynamicweb source code and external dependencies. It will take some time.

Figure 9.1 Get Latest Version

You can see other branches in this project.

The one called “Dynamicweb” is what we call head and is the development of the next major/minor release (8.9.2 – in April 2017). The current release available for production solutions is 8.9.1* and can be found in the branch/folder called “Dynamicweb8.9.1” – which is the code released currently and the unreleased bug fixes for next hotfix and service release.

It is possible to checkout several branches where needed. It is recommended that you checkout the latest released branch.

When done, open the Dynamicweb.sln from the branch of Dynamicweb that was checked out.

That will give you the Dynamicweb solution. Right click the solution, and choose “Restore NuGet Packages” (Figure 9.2).

Figure 9.2 Restore NuGet

When packages are downloaded, right click the solution and choose “Rebuild solution”. Now there is a locally build solution with source code that can be used for debugging etc.

To run your local installation against the source code of Dynamicweb, change settings in the local IIS.

Choose the root of the Dynamicweb.Admin project as your websites home directory (Figure 9.3).

Map your /Files to your local file repository – see the installation guide on how to setup Dynamicweb.

Figure 9.3 ISS setup

To access the Dynamicweb 9 source code:

  • First make sure your Team Explorer is in the “Dynamicweb9” project (Figure 10.1)
Figure 10.1 Verify you're in the right project
  • Click the “Source Control Explorer” link (Figure 10.2) - or go through View > Other Windows > Source control explorer
Figure 10.2 Click 'Source Control Explorer'
  • This will open the Dynamicweb9 folder window (Figure 10.3)
Figure 10.3 The Dynamicweb9 folder window

Then the source control need to be mapped.

  • Click the “Not mapped” text/link (Figure 11.1)
Figure 11.1 Click 'Not mapped'
  • This opens the Map dialog (Figure 11.2)
  • Somewhere on you computer, create a folder, i.e. C:\Dynamicweb and choose that as the “Local folder”
  • Click “Map”.
Figure 11.2 Select a local folder to map to

Now it is time to check out some data. Right click the “Dynamicweb9” folder and choose “Get Latest Version” (Figure 12.1). Visual Studio will now download the entire Dynamicweb source code and external dependencies. It will take some time.

Figure 12.1 Get Latest Version

This checkout will give you all the projects and packages of Dynamicweb 9.

Dynamicweb 9 consists of 2 main solutions.

  1. DynamicwebPackageSolution.sln which contains the main application
  2. Dynamicweb.Providers.sln which contains all the add-ons and providers for Dynamicweb.

To locate the DynamicwebPackageSolution, go to that subfolder and find the .sln file.

You will notice that there are several DynamicwebPackageSolution*.sln files (Figure 12.2)

The one called DynamicwebPackageSolution.sln is the “Head” branch and the development of the next minor release (9.2, 9.3 ect.). The DynamicwebPackageSolution9.*.sln files are the service release and hotfix branches.

Figure 12.2 DW9 consists of two main solutions

Some of the projects are branched in a Head and a Service release version, i.e. these projects

  • 01 – Applications/Dynamicweb.Admin
  • 05 – Modules/Dynamicweb.Ecommerce
  • 06 – Dynamicweb Host/Dynamicweb

All other packages are not branched – meaning they are the same source used for both hotfixes/service releases and for the next minor Dynamicweb 9 release. The packages are released independent of the main branch.

Double click the DynamicwebPackageSolution.sln to open the Dynamicweb 9 solution (Figure 12.3)

Figure 12.3 Click the DynamicwebPackageSolution.sln

Right click the solution and choose “Restore NuGet Packages” (Figure 13.1)

Figure 13.1 Restore Nuget Packages

When packages are downloaded, right click the solution and choose “Rebuild solution”. You may have to run the build after the rebuild. You now have access to a locally built solution with source code, which can be used for debugging etc.

To run your local installation against the source code of Dynamicweb, change settings in the local IIS.

Choose the root of the Dynamicweb.Admin project as your websites home directory (Figure 13.2):

Figure 13.2 IIS Setup

It could be “C:\Data\Dynamicweb 9\01 - Applications\Dynamicweb.Admin\Head\Dynamicweb.Admin” – if it is the head branch (next minor) – or another branch of the Dynamicweb 9 releases.

Map your /Files to your local file repository – see the installation guide on how to setup Dynamicweb.