Differences

This shows you the differences between two versions of the page.

--- tfs_addon [2017/12/23 20:11] – [Enable TFS AddOn for Models] admin
+++ tfs_addon [2020/05/10 03:34] (current) – removed admin
@@ Line 1: / Line 1: @@
-===== Microsoft TFS/VSTS AddOn Configuration =====
-//TFS Addon// communicates with {{https://www.visualstudio.com/en-us/news/releasenotes/tfs2017-relnotes | 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.
-==== Minimum Configuration ====
-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 Settings ====
-  * 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
-==== Enable TFS AddOn for Models =====
-Each model that needs to access //TFS/VSTS// for requirement or defects must also be configured:
-  * Enable [[ALMPlugin]] in the model using [[modelnode | model property]].
-  * Select 'MYTFS' as the requirement and/or defect system using [[alm_configuration | ALM Configuration]].
-=== Requirements Setting ===
-  * PROJECT=project name, required, it tells the ALM plugin which project in TFS/VSTS to search for the requirements, must be the same for both Requirement and Defect setting.
-  * TEAM=team name, optional, to instruct addon to pull requirement items for the specified team if REQ_WIQL has not been specified, it must be the same for both Requirement and Defect.
-  * REQ_QUERY_ID=query-id, from tfs/vsts that retrieves a list of requirements to be tested by the model
-=== Defect Setting ===
-  * PROJECT=project name, required, it tells the ALM plugin which project in TFS/VSTS to search for the defects, must be the same for both Requirement and Defects setting.
-  * TEAM=team name, optional, if specified it must be the same for both Requirement and Defect.
-  * BUG_QUERY_ID=query-id, from TFS/VSTS that retrieves a list of defect raised by this model
-  * BUG_ITERATION=iteration name - optional. if specified, it will set bug item's IterationPath accordingly