TFS Addon communicates with TFS - Team Foundation Server and VSTS - Visual Studio Team Services using REST API. Configuration settings are defined in config.properties file located in /www/config/ folder.

You may use any text editor to add/update settings.

First pick a unique name for your TFS/VSTS system, e.g. MYTFS. The name must be in uppercase.

Copy and paste following settings into config.properties and adjust the values to yours:

ADDON.MYTFS.CLASS=com.webmbt.alm.addon.AddOnTFS
ADDON.MYTFS.URL=https://myvsts.visualstudio.com
ADDON.MYTFS.AUTH.TYPE=Basic
ADDON.MYTFS.AUTH.USERNAME=userid
ADDON.MYTFS.AUTH.PASSWORD=password/access token
ADDON.MYTFS.BUG.ENABLED=true
ADDON.MYTFS.REQ.ENABLED=true

• ADDON.MYTFS.CLASS=com.webmbt.alm.addon.AddOnTFS
• ADDON.MYTFS.URL=host and port pointing to your tfs/vsts server
• ADDON.MYTFS.AUTH.TYPE=Basic
• ADDON.MYTFS.AUTH.USERNAME=userid
• ADDON.MYTFS.AUTH.PASSWORD=either password or access token generated from TFS/VSTS.
• ADDON.MYTFS.BUG.ENABLED=true/false, if to enable defect interface, default false
• ADDON.MYTFS.REQ.ENABLED=true/false, if to enable requirement iterface, default false
• ADDON.MYTFS.REQ_WIQL=optional, WIQL to retrieve requirement items, default to pull items of type of REQ_ITEMTYPES with states of REQ_ITEMSTATES
• ADDON.MYTFS.BUG_WIQL=optional, WIQL to retrieve bug items, default to pull items of type of BUG_ITEMTYPES with states of BUG_ITEMSTATES
• ADDON.MYTFS.REQ_ITEMTYPES=optional, comma separated item types for requirement, default to Task,Requirement
• ADDON.MYTFS.BUG_ITEMTYPES=optional, comma separated item types for defect, default to Bug
• ADDON.MYTFS.REQ_ITEMSTATES=optional, comma separated item states for requirement, default to Active,In Progress
• ADDON.MYTFS.BUG_ITEMSTATES=optional, comma separated item states for defect, default to Active,New,In Progress
• ADDON.MYTFS.BUG_NEWSTATE=optional, states for new bug, default to the default state in your VSTS for new Bug items

Additional AUTH_.* fields supported for OAuth and OAuth2:

• ADDON.MYJIRA.AUTH.OAUTH.CONSUMER.KEY
• ADDON.MYJIRA.AUTH.OAUTH.CONSUMER.SECRET
• ADDON.MYJIRA.AUTH.OAUTH.ACCESS.TOKEN
• ADDON.MYJIRA.AUTH.OAUTH.SECRET.TOKEN
• ADDON.MYJIRA.AUTH.OAUTH2.SECURITY.TOKEN
• ADDON.MYJIRA.AUTH.OAUTH2.SIGNATURE

Each model that needs to access TFS/VSTS for requirement or defects must also be configured:

• Enable ALMPlugin in the model using model property.
• Select 'MYTFS' as the requirement and/or defect system using ALM Configuration.

ALM Config Settings:

• PROJECT=project key, it tells the ALM plugin which project in TFS/VSTS to search for the requirements and defects.
• REQ_QUERY_ID= id of TFS/VSTS query that retrieves the list of requirements of interest
• BUG_QUERY_ID= id of TFS/VSTS query that retrieves the list of defects of interest.
• BUT_ITERATION=optional. if specified, it will set bug item's IterationPath accordingly. example “Iteration 0”.