How to Connect a Dynamics 365 for Operations (AX7) TFS Project

by | Updated December 18, 2017 | Development, Dynamics 365 for Finance and Operations

Microsoft Dynamics 365 for Operations has changed the development model significantly. The MorphX development environment no longer exists. All the development is done in Visual Studio now. This allowed Microsoft to decouple the development tools from any running Dynamics environment. Now you develop against a set of local, XML-based files, not the online database.

As a result, connecting to Team Foundation Server (TFS) is significantly different. It is important to make sure you have the workspaces mapped correctly for everything to work.

This post will explain how to get a new development environment connected to your code in TFS.

Steps to connect an Dynamics 365 for Operations TFS Project:

Step 1. Launch Visual Studio

Step 2. Connect to TFS
a. Click Sign In at top right corner

Quick launch in AX 7


b. Enter your Credentials

VSO Credentials


c. Connect to the team project using Team Explorer Window
 i.  Click connect icon (looks like a 2 prong plug-in)
ii.  Then Manage Connections
iii.  Then Connect to Team Projects (from drop down)

Team Explorer Window


d.  Use the Select a Team Foundation Server: drop down to select the correct TFS server

Team Foundation Server


e.  Select the collection on the left from the Team Project Collections list (mine is DefaultCollection)
    f.  Select the Team Project.

Note: It is important that you use only one Team Project per AX7 development workstation. The reason for this is because you most map the Metadata to the I:AosService\PackageLocalDirectory (if an Azure VM) (or C:\Packages if it is a local install). This is the equivalent to the local Model Store. All the metadata in the XML files in that directory is what runs in the local AOS. Since TFS will only allow you to map a single project to one directory, it imposes a limit of one AX Team Project per Dev box. It is important to note that one TFS AX Team Project can contain multiple Visual Studio projects, they just need to be in the “Main\Projects” folder of the same TFS Team Project

Team Foundation Server


g.  Click Connect on the bottom right corner of the Connect to Team Foundation Server dialog.
h.  In the Source Control Explorer expand the team project / Trunk / Main. You will need to map both folders under main to your developer box.
           i.   Select the Metadata folder and click on the “Not Mapped” link next to the Local Path

Source Control Explorer


ii.  From the dialog to is launched, browse to the I:\AosService\PackagesLocalDirectory

Browse for Folder in Dynamics AX

 iii.  Click OK to select the I:\AosService\PackagesLocalDirectory directory
iv.  Unfortunately, TFS will automatically append “Metadata” to the path you chose so you will have to delete the “Metadata” from the end of the path, make sure the “Recursive” check box is checked and click “Map.”

Map in Dynamics AX

Map in Dynamics AX


iv. Get the latest from the Metadata TFS folder (Click OK from the dialog that pops up)
v.  Select the Projects folder and click on the “Not Mapped” link next to the Local Path: label.

Microsoft Visual Studio


vi. From the dialog to is launched, browse to the directory where you want to store all your Dynamics 365 for Operations (AX7) projects. (ie. Documents\Visual Studio 2015\Projects)
vii. Click OK to select the directory

Browse to Projects Directory


vii.  Make sure the “Recursive” check box is checked and click “Map.”

Map Projects Workspace

viii. Get the latest from the Metadata TFS folder (Click OK from the dialog that pops up)

Microsoft Visual Studio

You should now be able to open the solution in Visual Studio.

Related Posts

1 Comment

  1. Eugene

    Good article. For new VSO project, there are no Trunk/Main…. folders. The only folder there is BuildProcessTemplate. For a code upgrade project, all the folders are present which is what you explained.

Submit a Comment

Your email address will not be published. Required fields are marked *

Upcoming Events


01sep10:00 am10:30 amEnsuring Quality and Compliance for Batch Manufacturers in Life Sciences

01sep12:00 pm12:30 pmIs it Worth It to Move to the Cloud? A Look at Considerations for Current Agribusinesses Using Dynamics GP

01sep2:00 pm2:45 pmWhat’s New in Dynamics 365 Finance and Supply Chain

09sep11:00 am12:00 pmConfab Live with Stoneridge – Data Strategy and Reporting – Mining Decision Making Insights

15sep10:00 am11:00 amSolving the Biggest Challenges in Agribusiness Through Innovation and Technology

22sep12:00 am12:30 pmSimplifying Payroll and HR Management with ADP Workforce Now

22sep10:00 am10:30 amStreamlining Batch Manufacturing with Technology

22sep2:00 pm2:30 pmProcess Automation for Microsoft Dynamics D365 for Business Central, Finance and Operations and GP

23sep11:00 am12:00 pmConfab LIVE with Stoneridge - Riding the Wave 2 Release – Key Features Coming to Dynamics 365 this October

29sep10:00 am11:00 amTop Five Reasons Why NOW is the Right Time to Move from Salesforce to Dynamics 365 Customer Engagement

29sep12:00 pm12:45 pmUnderstanding Job Costing and Tax Management in Business Central

29sep2:00 pm3:00 pmDigitalizing Horticulture & Agriculture - How to Sell Plants Online and Simplify Business Management

30sep12:00 pm4:00 pmSecurity and Permissions Training for D365 Business Central or Dynamics NAV


06oct10:00 am10:30 amPreview of D365 Business Central Fall Release Features and Functionality

06oct12:00 pm12:30 pmInsider's Guide to New Features Available in the Fall Release of D365 Finance and Supply Chain

07oct11:00 am12:00 pmConfab LIVE with Stoneridge - Dataverse and Dynamics in Review – Let’s Get Technical

21oct11:00 am12:00 pmConfab LIVE with Stoneridge - Dataverse and Dynamics in Review – Let’s Get Functional

26oct(oct 26)9:00 am28(oct 28)5:00 pmStoneridge Connect Leadership and Community Conference

About Stoneridge
Stoneridge Software is a unique Microsoft Gold Partner, with emphasis on partner. With specialties in Microsoft Dynamics 365, Microsoft Dynamics AX, Microsoft Dynamics NAV, Microsoft Dynamics GP and Microsoft Dynamics CRM, we focus on attracting the most knowledgeable experts in the field to our team, and prioritize delivering stellar solutions with maximum impact for your business. At Stoneridge, we are deeply committed to your results. Each engagement is met with a dedicated team, ready to provide thorough, tailored, and expert service. Based in Minnesota, we intentionally “step into your shoes,” wherever you are. We focus on what you care about, and develop trusting, long-term relationships with our clients.

Subscribe To Our Blog

Sign up to get periodic updates on the latest posts.

Thank you for subscribing!