Team Foundation Version Control (TFVC) | Ranorex
Help CenterUser GuideInterfaces and connectivity

Team Foundation Version Control (TFVC)

 

In this chapter

    About Team Foundation Version Control (TFVC) and Ranorex Studio

    Team Foundation Version Control (TFVC) is a centralized version control system by Microsoft included in Team Foundation Server.

    You will need to install the following software to work with TFVC in Ranorex Studio:

    Team Explorer 2013 for Visual Studio (Requires a free Microsoft account and Visual Studio Dev Essential subscription)

    MSSCCI Provider for Visual Studio 2013 & 2015

    Don’t worry about the 2013/2015 designations in the software names if you’re using later versions (e.g. 2017) of Visual Studio or TFS. They are compatible and the TFVC integration will work.

    Ranorex Studio will assist you with this dialog in case the required software is not present on the machine:

    The MSSCCI interface supports single byte character sets (SBCS) only. Here you can find a description on how to change the code page. This means there is no MBCS support.

    Add a Ranorex Solution to TFVC

    Please make sure your Team Foundation Server infrastructure is set up and working.

    For adding an existing Ranorex Solution to TFVC open the context menu of the solution. Go to ‘Source Control’ and click on ‘Add Solution to Source Control’.

    To add a new Ranorex Solution right from the beginning to TFVC check the option ‘Add to Source Control’ in the ‘New Project’ dialog.

    The ‘Source Control Wizard’ will be opened.

    Please follow these instructions:

    Choose ‘Microsoft Team Foundation Server’ as Source Control provider.

    Select your Team Foundation Server.
    Choose the folder you want to add your solution to.
    Select the files you want to have under source control and deselect the files you don’t want to have under source control respectively and perform a check in.

    After performing these steps, your solution is under source control and your local copy is up to date.

    Check out a Ranorex Solution from TFVC

    Please make sure your Team Foundation Server infrastructure is set up and working.

    Open ‘Tools’ menu, move to ‘Source Control’ and click on ‘Checkout…’.


    Choose ‘Microsoft Team Foundation Server’ as Source Control provider in Source Control Wizard.
    Specify the local check out Directory
    Select your Team Foundation Server.
    Choose the folder in the repository you want to check out from server.

    The chosen solution will be checked out.

    Icon overlays in Projects View

     

    Overlay icons are added to the items in the Projects view in Ranorex Studio as the solution is under source control.

    Icon overlays
    Normal File under source control, not checked out for editing.
    Conflicted File under source control, checked out, not dirty.
    Modified File under source control, checked out, dirty.
    Added File added to project, not checked in.

     

    Options

    In Ranorex Studio Options you can find options related to TFVC.

    Open main menu item ‘Tools’ and choose ‘Options…’. In the following dialog select folder ‘Tools’ and sub-item ‘TFS Options’. By default, all checkboxes are checked.

    If you are working with TFVC and running into performance problems with big solutions, uncheck ‘Enable file state ‘Modified’ check’.