{"id":6271,"date":"2014-06-19T04:05:20","date_gmt":"2014-06-19T11:05:20","guid":{"rendered":"http:\/\/www.technosolutions.com\/kb\/?p=6271"},"modified":"2018-04-26T23:55:05","modified_gmt":"2018-04-27T06:55:05","slug":"creating-custom-work-item-types-or-work-item-type-fields-on-tfs-using-topteam-vsts-connector","status":"publish","type":"post","link":"http:\/\/www.technosolutions.com\/kb\/6271\/creating-custom-work-item-types-or-work-item-type-fields-on-tfs-using-topteam-vsts-connector\/","title":{"rendered":"Creating custom Work Item Types or Work Item Type fields on TFS using TopTeam VSTS Connector"},"content":{"rendered":"<p><!-- Start ScreenSteps Content --><\/p>\n<div class=\"LessonContent\">\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Overview<\/h3>\n<div class=\"StepInstructions\">\n<p>This article describes the procedure to create new <i>Work Item Types<\/i> (WIT) and <i>Work Item Type fields<\/i> using <i>Visual Studio Team System (VSTS) Connector.<\/i><\/p>\n<p><i><font color=\"#000000\">Work Item Types<\/font><\/i><font color=\"#000000\"> and <i>Work Item Type fields<\/i> can be created while defining a synchronization scheme.<\/font><br \/>\n<font color=\"#000000\">Refer to the article <\/font><a href=\"http:\/\/www.technosolutions.com\/kb\/6316\/defining-a-synchronization-scheme-for-the-team-system-project\" target=\"_blank\">Defining Synchronization Scheme for TopTeam VSTS Connector.<\/a><\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Who should read this?<\/h3>\n<div class=\"StepInstructions\">\n<ul>\n<li>TopTeam Users<\/li>\n<\/ul>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">IMPORTANT<\/h3>\n<div class=\"StepInstructions\">\n<p><i>Microsoft Visual Studio Team Services<\/i> (Cloud) does not support the API call required to create custom <i>Work Item Types (WITs)<\/i>. Therefore, you have to manually create WITs corresponding to <i>TopTeam<\/i> artifact types (record types that you want to synchronize) on VSTS Cloud and then synchronize corresponding <i>TopTeam<\/i> artifact types (record types) with VSTS Cloud.<\/p>\n<p>To create custom <i>Work Item Types<\/i> on <i>Team Services,<\/i> refer to the <a href=\"https:\/\/docs.microsoft.com\/en-us\/vsts\/work\/customize\/process\/customize-process-wit\" target=\"_blank\">Microsoft Visual Studio Team Services<\/a> article.<\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Step 1. Run TopTeam VSTS Connector<\/h3>\n<div class=\"StepInstructions\">\n<p>Refer to the article <a href=\"http:\/\/www.technosolutions.com\/kb\/6324\/starting-with-topteam-connector-for-visual-studio-team-system\/\" target=\"_blank\">Configuring TopTeam Connector for Visual Studio Team System.<\/a><\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Step 2. Create a new WIT that does not exist in Team System Project<\/h3>\n<\/p><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Step 2.1.  Select the option for creating a new WIT<\/h3>\n<div class=\"StepImage\" style=\"margin:10px 0px;\">\n<img loading=\"lazy\" decoding=\"async\" style=\"padding:3px; border: 1px solid #ccc;\" src=\"data:image\/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==\" data-layzr=\"http:\/\/www.technosolutions.com\/kb\/wp-content\/uploads\/2018\/04\/wpid28918-media_1388656316256-1-1-1.png\" width=\"800\" height=\"558\" alt=\"wpid28918-media_1388656316256-1-1-1.png\" \/>\n<\/div>\n<div class=\"StepInstructions\">\n<p>&nbsp;<\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Step 2.2. Enter a Name and Description for the WIT<\/h3>\n<div class=\"StepImage\" style=\"margin:10px 0px;\">\n<img loading=\"lazy\" decoding=\"async\" style=\"padding:3px; border: 1px solid #ccc;\" src=\"data:image\/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==\" data-layzr=\"http:\/\/www.technosolutions.com\/kb\/wp-content\/uploads\/2018\/04\/wpid28915-media_1387974866429-1-1-1.png\" width=\"421\" height=\"328\" alt=\"wpid28915-media_1387974866429-1-1-1.png\" \/>\n<\/div>\n<div class=\"StepInstructions\">\n<p>&nbsp;<\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Step 2.3. A new WIT is created and mapped<\/h3>\n<div class=\"StepImage\" style=\"margin:10px 0px;\">\n<img loading=\"lazy\" decoding=\"async\" style=\"padding:3px; border: 1px solid #ccc;\" src=\"data:image\/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==\" data-layzr=\"http:\/\/www.technosolutions.com\/kb\/wp-content\/uploads\/2018\/04\/wpid28914-hgj-1-1-1.png\" width=\"800\" height=\"558\" alt=\"wpid28914-hgj-1-1-1.png\" \/>\n<\/div>\n<div class=\"StepInstructions\">\n<p>&nbsp;<\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Step 3. Create a new Work Item Type field if it does not exist in the WIT column<\/h3>\n<\/p><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Step 3.1. Select the option for creating a new field<\/h3>\n<div class=\"StepImage\" style=\"margin:10px 0px;\">\n<img loading=\"lazy\" decoding=\"async\" style=\"padding:3px; border: 1px solid #ccc;\" src=\"data:image\/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==\" data-layzr=\"http:\/\/www.technosolutions.com\/kb\/wp-content\/uploads\/2018\/04\/wpid28919-media_1388656656973-1-1-1.png\" width=\"800\" height=\"558\" alt=\"wpid28919-media_1388656656973-1-1-1.png\" \/>\n<\/div>\n<div class=\"StepInstructions\">\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Step 3.2. Enter a Field Name and Field Type for the new Work Item Type Field<\/h3>\n<div class=\"StepImage\" style=\"margin:10px 0px;\">\n<img loading=\"lazy\" decoding=\"async\" style=\"padding:3px; border: 1px solid #ccc;\" src=\"data:image\/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==\" data-layzr=\"http:\/\/www.technosolutions.com\/kb\/wp-content\/uploads\/2018\/04\/wpid28916-media_1387976419845-1-1-1.png\" width=\"488\" height=\"296\" alt=\"wpid28916-media_1387976419845-1-1-1.png\" \/>\n<\/div>\n<div class=\"StepInstructions\">\n<p>1. Choose whether you want to create a new Field Definition or use an existing field definition<br \/>\n2. Specify the <i>Field Name<\/i>.<br \/>\n3. Specify the <i>Reference Name<\/i>.<br \/>\n4. Select the <i>Field Type<\/i> &#8211; t<font color=\"#000000\">he drop-down list will show the TFS field types that can be mapped to the selected TopTeam Field.<\/font><br \/>\n5. Click <i>OK<\/i>.<\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Step 3.3. Create a new WIT field with the &quot;Use existing field definition&quot; option<\/h3>\n<div class=\"StepImage\" style=\"margin:10px 0px;\">\n<img loading=\"lazy\" decoding=\"async\" style=\"padding:3px; border: 1px solid #ccc;\" src=\"data:image\/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==\" data-layzr=\"http:\/\/www.technosolutions.com\/kb\/wp-content\/uploads\/2018\/04\/wpid28917-media_1387976477166-1-1-1.png\" width=\"560\" height=\"422\" alt=\"wpid28917-media_1387976477166-1-1-1.png\" \/>\n<\/div>\n<div class=\"StepInstructions\">\n<p><font color=\"#0A0A0A\">The list shows all the field definitions that already exist in the currently selected Project.<\/font><br \/>\n<font color=\"#0A0A0A\">These existing field definitions will be included in the selected WIT.<\/font><\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">Step 3.4. The new WIT field is created and mapped<\/h3>\n<div class=\"StepImage\" style=\"margin:10px 0px;\">\n<img loading=\"lazy\" decoding=\"async\" style=\"padding:3px; border: 1px solid #ccc;\" src=\"data:image\/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==\" data-layzr=\"http:\/\/www.technosolutions.com\/kb\/wp-content\/uploads\/2018\/04\/wpid28920-media_1388656854824-1-1-1.png\" width=\"800\" height=\"558\" alt=\"wpid28920-media_1388656854824-1-1-1.png\" \/>\n<\/div>\n<div class=\"StepInstructions\">\n<p>&nbsp;<\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">The following image illustrates the Work Item Types List in VSTS<\/h3>\n<div class=\"StepImage\" style=\"margin:10px 0px;\">\n<img loading=\"lazy\" decoding=\"async\" style=\"padding:3px; border: 1px solid #ccc;\" src=\"data:image\/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==\" data-layzr=\"http:\/\/www.technosolutions.com\/kb\/wp-content\/uploads\/2018\/04\/wpid28921-media_1389011502212-1-1-1.png\" width=\"645\" height=\"421\" alt=\"wpid28921-media_1389011502212-1-1-1.png\" \/>\n<\/div>\n<div class=\"StepInstructions\">\n<p>&nbsp;<\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<h3 class=\"StepTitle\" style=\"font-size:20px;\">See Also<\/h3>\n<div class=\"StepInstructions\">\n<p><a href=\"http:\/\/www.technosolutions.com\/kb\/6344\/synchronizing-records-between-topteam-and-tfs-repositories-using-topteam-vsts-connector\/\" target=\"_blank\">Synchronizing records between TopTeam and TFS repositories using TopTeam VSTS Connector<\/a><br \/>\n<a href=\"http:\/\/www.technosolutions.com\/kb\/6285\/creating-execution-profile-for-topteam-vsts-connector\/\" target=\"_blank\">Creating Execution Profile for TopTeam VSTS Connector<\/a><br \/>\n<a href=\"http:\/\/www.technosolutions.com\/kb\/6292\/creating-synchronization-parameter-file\/\" target=\"_blank\">Creating synchronization parameter file for <\/a><a href=\"http:\/\/www.technosolutions.com\/kb\/6316\/defining-a-synchronization-scheme-for-the-team-system-project\" target=\"_blank\">TopTeam VSTS Connector<\/a><br \/>\n<a href=\"http:\/\/www.technosolutions.com\/kb\/6316\/defining-a-synchronization-scheme-for-the-team-system-project\" target=\"_blank\">Defining Synchronization Scheme for TopTeam VSTS Connector<\/a><\/p>\n<\/div><\/div>\n<div class=\"LessonStep top\">\n<div class=\"StepInstructions\">\n<p>Revised: April 27th, 2018<\/p>\n<\/div><\/div>\n<\/p><\/div>\n<p><!-- End ScreenSteps Content --><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Overview This article describes the procedure to create new Work Item Types (WIT) and Work Item Type fields using Visual Studio Team System (VSTS) Connector. Work Item Types and Work Item Type fields can be created while defining a synchronization scheme. Refer to the article Defining Synchronization Scheme for TopTeam VSTS Connector. Who should read this? TopTeam Users IMPORTANT Microsoft Visual Studio Team Services (Cloud) does not support the API call required to create custom Work Item Types (WITs). Therefore, you have to manually create WITs corresponding to TopTeam artifact types (record types that you want to synchronize) on VSTS <\/p>\n","protected":false},"author":6,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[58],"tags":[254,48],"class_list":["post-6271","post","type-post","status-publish","format-standard","hentry","category-connectors","tag-tfs","tag-vsts"],"jetpack_featured_media_url":"","jetpack_shortlink":"https:\/\/wp.me\/paoaNA-1D9","_links":{"self":[{"href":"http:\/\/www.technosolutions.com\/kb\/wp-json\/wp\/v2\/posts\/6271","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/www.technosolutions.com\/kb\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/www.technosolutions.com\/kb\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/www.technosolutions.com\/kb\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"http:\/\/www.technosolutions.com\/kb\/wp-json\/wp\/v2\/comments?post=6271"}],"version-history":[{"count":26,"href":"http:\/\/www.technosolutions.com\/kb\/wp-json\/wp\/v2\/posts\/6271\/revisions"}],"predecessor-version":[{"id":41144,"href":"http:\/\/www.technosolutions.com\/kb\/wp-json\/wp\/v2\/posts\/6271\/revisions\/41144"}],"wp:attachment":[{"href":"http:\/\/www.technosolutions.com\/kb\/wp-json\/wp\/v2\/media?parent=6271"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/www.technosolutions.com\/kb\/wp-json\/wp\/v2\/categories?post=6271"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/www.technosolutions.com\/kb\/wp-json\/wp\/v2\/tags?post=6271"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}