Justinmind’s integration with Microsoft Team Foundation Server

Justinmind Enterprise is integrated with Microsoft Team Foundation Server (TFS), also known as Visual Studio Team Services or Azure DevOps Services, and you can import and export your work items to and from Justinmind.

Important:

  • This is only available to Justinmind Enterprise users
  • TFS work items are referred to as requirements when imported into Justinmind
  • Justinmind requirements are referred as issues when exported to TFS
  • When using TFS 2015, you will need to enable basic authentication. You can learn how to do that here. If you plan to use https, make sure you’re using a valid certificate that is not self-signed

Importing TFS work items to Justinmind

To import TFS work items into Justinmind:

  1. Open Justinmind and go to the Requirements module. To configure TFS, go to the “Plug-ins” main menu option and select “Team Foundation Server”. Then, select ‘Configuration’.import tfs items gif
  2. In the dialog that appears, you’ll need to fill in the following:Configuration
    1. Username of the TFS user
    2. The TFS user’s personal access token. You can create a token by following these instructions
    3. URL of your Visual Studio, DevOps, or TFS work space e.g. https://domainname.visualstudio.com/collectionname
    4. Project Key: the name of the TFS project. Add a forward-slash (/) before the project name
    5. Query: leave the field blank to begin with and click OK. Reopen the dialog and select/filter your queries.
    6. If you want your requirements to take on the TFS column settings, tick the “Use TFS requirements configuration” option. Untick this option if you want to use Justinmind’s column settings.
     
    Note the following:
    1. Query has to be at root level, i.e. Shared\Query. If stored at Shared\Folder\Query, you won’t get any results.
    2. Query must be set to return results in a flat list. It won’t display results as a tree.
    3. Any work item in query results will be imported as a “Requirement” – that includes bugs, tasks, and custom work item types. Users must do any filtering out in query.
  3. To import your TFS work items, go to the “Plug-ins” main menu option, and under “Team Foundation Server”, select “Import Requirements”.tfs import requirements
  4. A dialog will appear letting you know that the work items are being imported from TFS, and when the process has been completed. Click “OK”.tfs import requirements dialog
  5. If importing has been successful, you’ll see your TFS work items appear in the Requirements module.tfs import successful

Linking TFS work items to your prototypes

Once you have successfully imported your work items, you can start to use TFS to define scenarios, screens and events within your prototype.

To do so, go to the User Interface module. Then, simply drag Justinmind requirements (TFS work items in Justinmind) from the Requirements palette at the bottom of the editor to the canvas, and drop them on top of scenarios or UI elements.

Read more on adding requirements to your UI elements here.

Note: when you drag and drop a requirement to an element/scenario, the following dialog will appear:

Click “OK” to proceed or “Cancel” to return to the canvas.

View a TFS work item from a Justinmind requirement

From the canvas in the User Interface module, click “Simulate” to view your prototype. On the right, you’ll find a hamburger menu. Click it to see the Requirements panel (below to the Screens panel).

tfs work item from justinmind

Click on the linked requirement and you’ll find an option to “View component” on the left.

Click to see the linked element highlighted in green.

linked elements tfs

How to view TFS work items associated with a requirement

In the Simulation window, click on a linked requirement. Select “View in TFS”.

associate work item requirement

You will be taken to the associated work item within TFS.

Exporting Justinmind requirements to TFS

To export Justinmind requirements to TFS:

  1. Back in the Requirements module, go to the “Plug-ins” main menu option and select “Team Foundation Server”. Then select “Export Requirements”.
    • tfs export requirements
  2. A dialog will appear letting you know that the requirements are being exported to TFS. Click “OK”.
    • export requirements dialog
  3. Back in the Requirements module, click on the Integration tool URL of any requirement in the Requirements module to view the corresponding Justinmind requirement in TFS.
    • tfs integration tool url
  4. Once in TFS, click on the hyperlink icon in the “Links” section for a direct link to the Justinmind prototype related to this TFS work item. You will be taken to Justinmind’s simulation window.
    • tfs links section