{"id":5483,"date":"2012-03-06T12:23:00","date_gmt":"2012-03-06T12:23:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/visualstudioalm\/2012\/03\/06\/update-your-agile-team-project-to-support-additional-functionality-after-you-upgrade-from-tfs-2010-to-tfs11-beta\/"},"modified":"2022-07-26T06:10:25","modified_gmt":"2022-07-26T14:10:25","slug":"update-your-agile-team-project-to-support-additional-functionality-after-you-upgrade-from-tfs-2010-to-tfs11-beta","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/update-your-agile-team-project-to-support-additional-functionality-after-you-upgrade-from-tfs-2010-to-tfs11-beta\/","title":{"rendered":"Update Your Agile Team Project to Support Additional Functionality After You Upgrade from TFS 2010 to TFS11 Beta"},"content":{"rendered":"

Summary<\/span><\/h2>\n

When a new version of TFS comes out, there are new features. Some of those features are backed by metadata such as work item types and work item categories. If you had to upgrade your TFS 2008 team project to TFS 2010 you know that this can be a daunting exercise. For TFS11 there are also a couple of features that need changes to the metadata.\u00a0 <\/span><\/p>\n

There is metadata that is required for a feature to get it working. To add the required metadata for all new TFS11 features, follow steps in the MSDN article <\/span>Updating an Upgraded Team Project to Access New Features<\/span><\/a>. <\/span><\/span><\/p>\n

Besides the required metadata, there is also metadata that is optional. Features function correct if you leave the optional metadata out, but you get a lesser experience on these features. This blog post talks about adding the optional metadata to your Agile team project. <\/span><\/p>\n

The optional metadata is:<\/span><\/p>\n

    \n
  1. Add the New state to the User Story <\/span><\/li>\n
  2. Add the Removed state to the User Story and the Task<\/span><\/li>\n
  3. Add StartWork and StopWork actions to support state transitions when adding a task or bug in progress or removing it from progress in the My Work pane <\/span><\/li>\n
  4. Add the Storyboard tab in the User Story work item type<\/span><\/li>\n<\/ol>\n

    This post is talking about a team project that was created with the Agile process template, however step 3 and 4 can also be applied to Scrum and CMMI projects.<\/span><\/p>\n

    Adding the New state <\/span><\/h2>\n

    TFS11 introduced the planning tools (Product Backlog, Iteration Backlog and Board). The items shown in the Planning Tools are configured with the so-called metastates. When you open the CommonConfiguration.xml file (found in the \u201cAgileWorkItem TrackingProcess\u201d subdirectory) for the process template MSF for Agile Software Development 6.0, you see the following mapping <\/span><\/p>\n

    \"image\"<\/span><\/a><\/span><\/p>\n

    The metastates are defined in the type attribute (Proposed, InProgress or Complete), and you map these metastates to the states in your work items. <\/span><\/p>\n

    The logic the Product Backlog is using to build this query is in psuedo code<\/span><\/p>\n

    SELECT fields FROM WorkItems WHERE
    \u00a0\u00a0\u00a0 ((State = \u2018Proposed\u2019 OR State = \u2018InProgress\u2019) AND IterationPath == \u2018RootIterationPath\u2019) OR\u00a0
    \u00a0\u00a0\u00a0 ((State = \u2018Proposed\u2019) AND IterationPath <> \u2018RootIterationPath\u2019)<\/span><\/p>\n

    The process template MSF for Agile Software Development v5.0 has for its requirement (the User Story work item type) only the states Active, Resolved and Closed. When you take a close look at the file CommonConfiguration.xml file in the subdirectory Agile of the localized zip (provided in the article Updating an Upgraded Team Project to Access New Features<\/span><\/a>), you will see that it is a slightly modified version, were the following mapping is applied:<\/span><\/p>\n

    \"image\"<\/span><\/a><\/span><\/p>\n

    With this modified settings, you are able to apply the settings to your VS 2010 Agile team project. The effect of these settings is that a user story that is assigned to an iteration stays on the Product Backlog until you have resolved it which is not what you\u2019d expected. To fix this, you have to add the New state to the user story and fix the metastate mappings.<\/span><\/p>\n

    Modify the work item type<\/span><\/p>\n

    To add this state apply these steps to the User Story<\/strong> and Task <\/strong>work item types (replace the yellow marked text with your configuration and replace the green text with the appropriate work item type)<\/span><\/p>\n

      \n
    1. Run the following command from the Developer Command Prompt to export the User Story work item type \n

      <\/span>\u00a0\u00a0\u00a0 witadmin exportwitd \/collection:http:\/\/localhost<\/span>:8080\/tfs\/defaultcollection<\/span> \/p:Agile5<\/span> \/n:\u201dwit<\/span>\u201d \/f:\u201d%temp%<\/span>wit<\/span>.xml\u201d
      <\/span><\/span><\/li>\n

    2. Run the following command from the Developer Command Prompt the following command to open the exported work item type in Visual Studio \n

      <\/span>\u00a0\u00a0\u00a0 devenv \u201c%temp%wit<\/span>.xml\u201d
      <\/span><\/span><\/li>\n

    3. Add the following code snippet between the lines <<\/span><\/span><\/span>STATES><\/span><\/span><\/span><\/span><\/span><\/span> and <<\/span><\/span><\/span>STATE<\/span><\/span><\/span> <\/span><\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Active<\/span><\/span><\/span>“<\/span><\/span>><\/span><\/span><\/span> \n

      <\/span><STATE<\/span><\/span><\/span> <\/span><\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>New<\/span><\/span><\/span>“<\/span><\/span><\/span>>
      \u00a0\u00a0\u00a0 <\/span><<\/span><\/span>FIELDS<\/span><\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>FIELD<\/span><\/span><\/span> <\/span><\/span><\/span>refname<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.VSTS.Common.ResolvedDate<\/span><\/span><\/span>“<\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>EMPTY<\/span><\/span><\/span><\/span> \/><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/<\/span><\/span>FIELD<\/span><\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>FIELD<\/span><\/span><\/span> <\/span><\/span><\/span>refname<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.VSTS.Common.ResolvedBy<\/span><\/span><\/span>“<\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>EMPTY<\/span><\/span><\/span><\/span> \/><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/<\/span><\/span>FIELD<\/span><\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>FIELD<\/span><\/span><\/span> <\/span><\/span><\/span>refname<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.VSTS.Common.ClosedDate<\/span><\/span><\/span>“<\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>EMPTY<\/span><\/span><\/span><\/span> \/><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/<\/span><\/span>FIELD<\/span><\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>FIELD<\/span><\/span><\/span> <\/span><\/span><\/span>refname<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.VSTS.Common.ClosedBy<\/span><\/span><\/span>“<\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>EMPTY<\/span><\/span><\/span><\/span> \/><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/<\/span><\/span>FIELD<\/span><\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>FIELD<\/span><\/span><\/span> <\/span><\/span><\/span>refname<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.VSTS.Common.ActivatedDate<\/span><\/span><\/span>“<\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>EMPTY<\/span><\/span><\/span><\/span> \/><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/<\/span><\/span>FIELD<\/span><\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>FIELD<\/span><\/span><\/span> <\/span><\/span><\/span>refname<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.VSTS.Common.ActivatedBy<\/span><\/span><\/span>“<\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>EMPTY<\/span><\/span><\/span><\/span> \/><\/span>
      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/<\/span><\/span>FIELD<\/span><\/span><\/span><\/span>><\/span>
      \u00a0\u00a0\u00a0 <\/<\/span><\/span>FIELDS<\/span><\/span><\/span><\/span>><\/span>
      <\/<\/span><\/span>STATE<\/span><\/span><\/span>><\/span><\/span><\/span><\/span><\/span>
      <\/span><\/span><\/span><\/span><\/li>\n

    4. \n

      Now that you have added the New state, the next step is to fix the transitions. The instructions assume you have not any modified states nor transitions.
      Replace the current initial state (which are the lines between <<\/span><\/span><\/span>TRANSITION<\/span><\/span><\/span> <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“”<\/span><\/span> <\/span><\/span><\/span>to<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Active<\/span><\/span><\/span>“<\/span><\/span><\/span>><\/span> <\/span><\/span><\/span>and the closing <\/<\/span><\/span><\/span>TRANSITION<\/span><\/span><\/span>><\/span><\/span><\/span><\/span> tag) with the following code snippet:
      <\/span> \n<<\/span>TRANSITION<\/span><\/span><\/span> <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“”<\/span><\/span> <\/span><\/span><\/span>to<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>New<\/span><\/span><\/span>“<\/span><\/span><\/span>>\u00a0
      \u00a0 <<\/span><\/span><\/span>REASONS<\/span><\/span><\/span><\/span>>\u00a0
      \u00a0\u00a0\u00a0 <<\/span><\/span><\/span>DEFAULTREASON<\/span><\/span><\/span> <\/span><\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>New<\/span><\/span><\/span>“<\/span><\/span><\/span> \/>\u00a0
      \u00a0 <\/<\/span><\/span><\/span>REASONS<\/span><\/span><\/span><\/span>>\u00a0
      \u00a0 <<\/span><\/span><\/span>FIELDS<\/span><\/span><\/span><\/span>>\u00a0
      \u00a0\u00a0\u00a0 <<\/span><\/span><\/span>FIELD<\/span><\/span><\/span> <\/span><\/span><\/span>refname<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>System.Description<\/span><\/span><\/span>“<\/span><\/span><\/span>>\u00a0
      \u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span><\/span>DEFAULT<\/span><\/span><\/span> <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>value<\/span><\/span><\/span>“<\/span><\/span> <\/span><\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>As a <\/span><\/span><\/span>&<\/span><\/span><\/span>lt;type of user<\/span><\/span><\/span>&<\/span><\/span><\/span>gt; I want <\/span><\/span><\/span>&<\/span><\/span><\/span>lt;some goal<\/span><\/span><\/span>&<\/span><\/span><\/span>gt; so that <\/span><\/span><\/span>&<\/span><\/span><\/span>lt;some reason<\/span><\/span><\/span>&<\/span><\/span><\/span>gt;<\/span><\/span><\/span>“<\/span><\/span><\/span> \/>\u00a0
      \u00a0\u00a0\u00a0 <\/<\/span><\/span><\/span>FIELD<\/span><\/span><\/span><\/span>>\u00a0
      \u00a0 <\/<\/span><\/span><\/span>FIELDS<\/span><\/span><\/span><\/span>>\u00a0
      <\/<\/span><\/span><\/span>TRANSITION<\/span><\/span><\/span><\/span>>
      <<\/span><\/span><\/span>TRANSITION<\/span><\/span><\/span> <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>New<\/span><\/span><\/span>“<\/span><\/span> <\/span><\/span><\/span>to<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Active<\/span><\/span><\/span>“<\/span><\/span><\/span>>\u00a0
      \u00a0 <<\/span><\/span><\/span>REASONS<\/span><\/span><\/span><\/span>>\u00a0
      \u00a0\u00a0\u00a0 <<\/span><\/span><\/span>DEFAULTREASON<\/span><\/span><\/span> <\/span><\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Implementation started<\/span><\/span><\/span>“<\/span><\/span><\/span> \/>\u00a0
      \u00a0 <\/<\/span><\/span><\/span>REASONS<\/span><\/span><\/span><\/span>>\u00a0
      \u00a0 <<\/span><\/span><\/span>FIELDS<\/span><\/span><\/span><\/span>>\u00a0
      \u00a0\u00a0\u00a0 <<\/span><\/span><\/span>FIELD<\/span><\/span><\/span> <\/span><\/span><\/span>refname<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.VSTS.Common.ActivatedBy<\/span><\/span><\/span>“<\/span><\/span><\/span>>\u00a0
      \u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span><\/span>COPY<\/span><\/span><\/span> <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>currentuser<\/span><\/span><\/span>“<\/span><\/span><\/span> \/>\u00a0
      \u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span><\/span>VALIDUSER<\/span><\/span><\/span><\/span> \/>\u00a0
      \u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span><\/span>REQUIRED<\/span><\/span><\/span><\/span> \/>\u00a0
      \u00a0\u00a0\u00a0 <\/<\/span><\/span><\/span>FIELD<\/span><\/span><\/span><\/span>>\u00a0
      \u00a0\u00a0\u00a0 <<\/span><\/span><\/span>FIELD<\/span><\/span><\/span> <\/span><\/span><\/span>refname<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.VSTS.Common.ActivatedDate<\/span><\/span><\/span>“<\/span><\/span><\/span>>\u00a0
      \u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span><\/span>SERVERDEFAULT<\/span><\/span><\/span> <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>clock<\/span><\/span><\/span>“<\/span><\/span><\/span> \/>\u00a0
      \u00a0\u00a0\u00a0 <\/<\/span><\/span><\/span>FIELD<\/span><\/span><\/span><\/span>>\u00a0
      \u00a0\u00a0\u00a0 <<\/span><\/span><\/span>FIELD<\/span><\/span><\/span> <\/span><\/span><\/span>refname<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>System.AssignedTo<\/span><\/span><\/span>“<\/span><\/span><\/span>><\/span>\u00a0
      \u00a0\u00a0\u00a0\u00a0\u00a0 <<\/span><\/span>DEFAULT<\/span><\/span><\/span> <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>currentuser<\/span><\/span><\/span>“<\/span><\/span><\/span> \/><\/span>\u00a0
      \u00a0\u00a0\u00a0 <\/<\/span><\/span>FIELD<\/span><\/span><\/span><\/span>><\/span>\u00a0
      \u00a0 <\/<\/span><\/span>FIELDS<\/span><\/span><\/span><\/span>><\/span>
      <\/<\/span><\/span>TRANSITION<\/span><\/span><\/span><\/span>><\/span>
      <\/span><\/span><<\/span><\/span>TRANSITION<\/span><\/span><\/span> <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Active<\/span><\/span><\/span>“<\/span><\/span> <\/span><\/span><\/span>to<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>New<\/span><\/span><\/span>“<\/span><\/span><\/span>><\/span>\u00a0
      \u00a0 <<\/span><\/span>REASONS<\/span><\/span><\/span><\/span>><\/span>\u00a0
      \u00a0\u00a0\u00a0 <<\/span><\/span>DEFAULTREASON<\/span><\/span><\/span> <\/span><\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Implementation halted<\/span><\/span><\/span>“<\/span><\/span><\/span> \/><\/span>\u00a0
      \u00a0 <\/<\/span><\/span>REASONS<\/span><\/span><\/span><\/span>><\/span>
      <\/<\/span><\/span>TRANSITION<\/span><\/span><\/span>><\/span><\/span><\/span><\/span><\/span> <\/span><\/span><\/span><\/p>\n<\/li>\n

    5. \n

      Save the file
      <\/span><\/p>\n<\/li>\n

    6. Run the following command from the Developer Command Prompt to import the modified definition for the User Story work item type \n

      \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 witadmin importwitd \/collection:http:\/\/localhost<\/span>:8080\/tfs\/defaultcollection<\/span> \/p:Agile5<\/span> \/f:\u201d%temp%<\/span>wit<\/span>.xml\u201d
      <\/span><\/li>\n<\/ol>\n

      Modify the metastate mapping<\/span><\/h3>\n

      The next step is to fix the mapping of the states in the CommonConfiguration.xml file. To do this follow these steps:<\/span><\/p>\n

        \n
      1. Run the following command from the Developer Command Prompt to export the current common configuration \n

        \u00a0\u00a0\u00a0 <\/span>witadmin exportcommonprocessconfig \/collection:http:\/\/localhost<\/span>:8080\/tfs\/defaultcollection<\/span> \/p:Agile5<\/span> \/f:%temp%<\/span>commonconfiguration.xml
        <\/span><\/span><\/li>\n

      2. Run the following command from the Developer Command Prompt the following command to open the exported common configuration settings in Visual Studio \n

        \u00a0\u00a0\u00a0 <\/span>devenv %temp%commonconfiguration.xml
        <\/span><\/span><\/li>\n

      3. Locate the tag<\/span> <<\/span><\/span>RequirementWorkItems<\/span><\/span><\/span> <\/span><\/span><\/span>category<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.RequirementCategory<\/span><\/span><\/span>” <\/span><\/span>plural<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Stories<\/span><\/span><\/span>“<\/span><\/span>><\/span><\/span><\/span>
        <\/span><\/span><\/li>\n
      4. Replace the line <<\/span><\/span>State<\/span><\/span><\/span> <\/span><\/span><\/span>type<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Proposed<\/span><\/span><\/span>” <\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Active<\/span><\/span><\/span>“<\/span><\/span><\/span>><\/span> <\/span><\/span><\/span>with the following lines \n

        <\/span><<\/span><\/span>State<\/span><\/span><\/span> <\/span><\/span><\/span>type<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Proposed<\/span><\/span><\/span>” <\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>New<\/span><\/span><\/span>“<\/span><\/span><\/span>>
        <State<\/span><\/span><\/span> <\/span><\/span><\/span>type<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>InProgress<\/span><\/span><\/span>” <\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Active<\/span><\/span><\/span>“<\/span><\/span>> <\/span><\/span><\/span><\/span><\/span><\/span>
        <\/span><\/span><\/li>\n

      5. Locate the tag<\/span> <<\/span><\/span>TaskWorkItems<\/span><\/span><\/span> <\/span><\/span><\/span>category<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.TaskCategory<\/span><\/span><\/span>“<\/span><\/span>><\/span><\/span><\/span>
        <\/span><\/span><\/li>\n
      6. \n

        Insert the following line as first metastate mapping in the TaskWorkItems <\/p>\n

        <<\/span><\/span>State<\/span><\/span><\/span> <\/span><\/span><\/span>type<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Proposed<\/span><\/span><\/span>” <\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>New<\/span><\/span><\/span>“<\/span><\/span>> <\/span><\/span><\/span><\/span>
        <\/span><\/p>\n<\/li>\n

      7. \n

        The result should be like <\/p>\n

        <\/span><\/span><\/a>\"image\"<\/a><\/span>
        <\/span><\/p>\n<\/li>\n

      8. Save the file
        <\/span><\/li>\n
      9. Run the following command from the Developer Command Prompt to import the modified common configuration \n

        \u00a0\u00a0\u00a0 <\/span>witadmin importcommonprocessconfig \/collection:http:\/\/localhost<\/span>:8080\/tfs\/defaultcollection<\/span> \/p:Agile5<\/span> \/f:%temp%<\/span>commonconfiguration.xml<\/span><\/span><\/li>\n<\/ol>\n

        Adding the Removed state<\/span><\/h2>\n

        Because all states of the user story and the task work item type are mapped to a metastate, the iteration backlog and the task board show all the existing work items. In practice there is work that needs to be cut. To be able to cut work, a new state is required that will not be mapped. Therefor we have added the Removed state to the user story and the task work item type in the TFS 11 Agile process template. If you want to be able to cut work in your upgrade team project, you want to add this Removed state too.<\/span><\/p>\n

        To add this state apply these steps to the User Story <\/strong>and Task <\/strong>work item types (replace the yellow marked text with your configuration and replace the green text with the appropriate work item type)<\/span><\/p>\n

          \n
        1. Run the following command from the Developer Command Prompt to export the User Story work item type \n

          <\/span>\u00a0\u00a0\u00a0 witadmin exportwitd \/collection:http:\/\/localhost<\/span>:8080\/tfs\/defaultcollection<\/span> \/p:Agile5<\/span> \/n:\u201dwit<\/span>\u201d \/f:\u201d%temp%<\/span>wit<\/span>.xml\u201d
          <\/span><\/span><\/li>\n

        2. Run the following command from the Developer Command Prompt the following command to open the exported work item type in Visual Studio \n

          <\/span>\u00a0\u00a0\u00a0 devenv \u201c%temp%wit<\/span>.xml\u201d
          <\/span><\/span><\/li>\n

        3. Add the following code snippet to the <<\/span><\/span><\/span>STATES><\/span><\/span><\/span><\/span><\/span><\/span><\/span> section (the order of the states is not important): \n

          <\/span><STATE<\/span><\/span><\/span> <\/span><\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Removed<\/span><\/span><\/span>” \/<\/span><\/span>> <\/span><\/span><\/span><\/span> <\/span>
          <\/span><\/span><\/span><\/span><\/li>\n

        4. \n

          Now that you have added the Removed state, the next step is to fix the transitions. Add the following code snippet to the <<\/span><\/span><\/span>TRANSITIONS><\/span><\/span><\/span><\/span><\/span><\/span> section (the order of the transitions is not important)
          <\/span> \n<<\/span>TRANSITION<\/span><\/span><\/span> <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“New”<\/span><\/span> <\/span><\/span><\/span>to<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Removed<\/span><\/span><\/span>“<\/span><\/span><\/span>>\u00a0
          \u00a0 <<\/span><\/span><\/span>REASONS<\/span><\/span><\/span><\/span>>\u00a0
          \u00a0\u00a0\u00a0 <<\/span><\/span><\/span>DEFAULTREASON<\/span><\/span><\/span> <\/span><\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Removed from the backlog<\/span><\/span><\/span>“<\/span><\/span><\/span> \/>\u00a0
          \u00a0 <\/<\/span><\/span><\/span>REASONS<\/span><\/span><\/span><\/span>>
          <\/span><\/span><\/span><\/<\/span><\/span><\/span>TRANSITION<\/span><\/span><\/span><\/span>>
          <<\/span><\/span><\/span>TRANSITION<\/span><\/span><\/span> <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Removed<\/span><\/span><\/span>“<\/span><\/span> <\/span><\/span><\/span>to<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>New<\/span><\/span><\/span>“<\/span><\/span><\/span>>\u00a0
          \u00a0 <<\/span><\/span><\/span>REASONS<\/span><\/span><\/span><\/span>>\u00a0
          \u00a0\u00a0\u00a0 <<\/span><\/span><\/span>DEFAULTREASON<\/span><\/span><\/span> <\/span><\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Reconsidering the User Story<\/span><\/span><\/span>“<\/span><\/span><\/span> \/>\u00a0
          \u00a0 <\/<\/span><\/span><\/span>REASONS<\/span><\/span><\/span><\/span>>
          <\/span><\/span><\/span><\/<\/span><\/span>TRANSITION<\/span><\/span><\/span>><\/span><\/span><\/span><\/span><\/span> <\/span><\/span><\/span><\/p>\n<\/li>\n

        5. \n

          Save the file
          <\/span><\/p>\n<\/li>\n

        6. Run the following command from the Developer Command Prompt to import the modified definition for the work item type \n

          <\/span>\u00a0\u00a0\u00a0 witadmin importwitd \/collection:http:\/\/localhost<\/span>:8080\/tfs\/defaultcollection<\/span> \/p:Agile5<\/span> \/f:\u201d%temp%<\/span>wit<\/span>.xml\u201d
          <\/span><\/span><\/li>\n<\/ol>\n

          Adding the StartWork and StopWork action<\/span><\/h2>\n

          In the new My Work pane you can add work items you\u2019re working on to In Progress<\/span><\/p>\n

          \"image\"<\/a><\/span><\/p>\n

          \u00a0<\/span><\/p>\n

          and you can of course also remove it from In Progress<\/span><\/p>\n

          \"image\"<\/a><\/span><\/p>\n

          \u00a0<\/span><\/p>\n

          In addition to moving it around in the My Work pane, it also tries to change the state of the work item that you are adding to or removing from In Progress. To know which transition it needs to use, My Work is using two new actions. Until now there was only the action Microsoft.VSTS.Actions.Checkin<\/span>, to transition the state of work items associated with a changeset at a checkin. Internally there is an API called \u201cstring GetNextState(string action)\u201d that returns the next state for the given action. <\/span><\/p>\n

          To support transitioning the work item that is added to In Progress, there is the Microsoft.VSTS.Actions.StartWork<\/span> action, and there is the Microsoft.VSTS.Actions.StopWork <\/span>action to transition your work item when you remove it from In Progress. In the shipped Process Templates we have added the actions in the Task work item, and in the Bug work item in the CMMI process template. <\/span><\/p>\n

          To add these actions apply these steps to the Task <\/strong>work item types (replace the yellow marked text with your configuration)<\/span><\/p>\n

            \n
          1. Run the following command from the Developer Command Prompt to export the User Story work item type \n

            <\/span>\u00a0\u00a0\u00a0 witadmin exportwitd \/collection:http:\/\/localhost<\/span>:8080\/tfs\/defaultcollection<\/span> \/p:Agile5<\/span> \/n:\u201d<\/span>task\u201d \/f:\u201d%temp%<\/span><\/span>task.xml\u201d
            <\/span><\/span><\/li>\n

          2. Run the following command from the Developer Command Prompt the following command to open the exported work item type in Visual Studio \n

            <\/span>\u00a0\u00a0\u00a0 devenv \u201c%temp%task.xml\u201d
            <\/span><\/span><\/li>\n

          3. Locate the snippet \n

            <\/span><<\/span><\/span>TRANSITION <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>New<\/span><\/span><\/span>” to<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Active<\/span><\/span><\/span>“<\/span><\/span><\/span><\/span><\/span>>
            \u00a0\u00a0 …
            <\/span><\/span><\/span><\/<\/span><\/span>TRANSITION<\/span><\/span><\/span><\/span>>
            <\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/li>\n

          4. Insert the following code snippet in the transition
            <\/span>
            <<\/span><\/span>ACTIONS<\/span><\/span><\/span><\/span><\/span><\/li>\n
          5. >
            \u00a0 <ACTION <\/span><\/span><\/span><\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.VSTS.Actions.StartWork“<\/span><\/span><\/span><\/span><\/span>>
            <\/span><\/<\/span><\/span>ACTIONS<\/span><\/span><\/span><\/span>><\/span> \n

            <\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/li>\n

          6. Locate the snippet \n

            <\/span><<\/span><\/span>TRANSITION <\/span><\/span><\/span>from<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Active<\/span><\/span><\/span>” to<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>New<\/span><\/span><\/span>“<\/span><\/span><\/span><\/span><\/span>>
            \u00a0\u00a0 …
            <\/span><\/span><\/span><\/<\/span><\/span>TRANSITION<\/span><\/span><\/span><\/span>>
            <\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/li>\n

          7. \n

            Insert the following code snippet in the transition
            <\/span>
            <<\/span><\/span>ACTIONS<\/span><\/span><\/span><\/span>>
            \u00a0 <ACTION <\/span><\/span><\/span><\/span><\/span>value<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Microsoft.VSTS.Actions.StopWork“<\/span><\/span><\/span><\/span><\/span>>
            <\/span><\/<\/span><\/span>ACTIONS<\/span><\/span><\/span><\/span>><\/span>
            <\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span>\n<\/p>\n<\/li>\n

          8. \n

            Save the file
            <\/span><\/p>\n<\/li>\n

          9. Run the following command from the Developer Command Prompt to import the modified definition for the work item type \n

            <\/span>\u00a0\u00a0\u00a0 witadmin importwitd \/collection:http:\/\/localhost<\/span>:8080\/tfs\/defaultcollection<\/span> \/p:Agile5<\/span> \/f:\u201d%temp%<\/span>task<\/span>.xml\u201d<\/span><\/span><\/li>\n<\/ol>\n

            The following image shows the result of these actions in the Agile task<\/span><\/p>\n

            \"image\"<\/a><\/span><\/p>\n

            Add Storyboard tab <\/span><\/h2>\n

            Since the early days there were requests to make it easier to define the user stories. TFS11 introduces <\/span>Storyboarding<\/span><\/a> which make use of PowerPoint to create a storyboard of your user story. We have added in TFS11 a new tab to the User Story work item type to integrate storyboarding. <\/span><\/span><\/p>\n

            To add this storyboard integration apply these steps to the User Story <\/strong>work item types (replace the yellow marked text with your configuration)<\/span><\/p>\n

              \n
            1. Run the following command from the Developer Command Prompt to export the User Story work item type \n

              <\/span>\u00a0\u00a0\u00a0 witadmin exportwitd \/collection:http:\/\/localhost<\/span>:8080\/tfs\/defaultcollection<\/span> \/p:Agile5<\/span> \/n:\u201d<\/span>user story<\/span>\u201d \/f:\u201d%temp%<\/span><\/span>user story<\/span>.xml\u201d
              <\/span><\/span><\/li>\n

            2. Run the following command from the Developer Command Prompt the following command to open the exported work item type in Visual Studio \n

              <\/span>\u00a0\u00a0\u00a0 devenv \u201c%temp%user story.xml\u201d
              <\/span><\/span><\/li>\n

            3. Locate the snippet \n

              <\/span> <<\/span><\/span>Tab <\/span><\/span><\/span>Label<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Details<\/span><\/span><\/span>“<\/span><\/span><\/span>>
              \u00a0\u00a0 <Control <\/span><\/span><\/span><\/span><\/span>FieldName<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>System.Description<\/span><\/span><\/span>” Type<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>HtmlFieldControl<\/span><\/span><\/span>” Dock<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Fill<\/span><\/span><\/span>“<\/span><\/span><\/span><\/span><\/span><\/span><\/span>>
              <\/<\/span><\/span>Tab<\/span><\/span><\/span><\/span>>
              <\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/li>\n

            4. Add the following code snippet between the Details<\/strong> and the Implementation<\/strong> tab
              <\/span>
              <<\/span><\/span>Tab <\/span><\/span><\/span>Label<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>Storyboard<\/span><\/span><\/span>“<\/span><\/span><\/span>>
              \u00a0 <Control <\/span><\/span><\/span><\/span><\/span>Name<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>StoryboardsControl<\/span><\/span><\/span>” Type<\/span><\/span><\/span>=<\/span><\/span><\/span>“<\/span><\/span>LinksControl<\/span><\/span><\/span>“<\/span><\/span><\/span><\/span><\/span>>
              <\/span>\u00a0\u00a0\u00a0 <LinksControlOptions<\/span><\/span><\/span><\/span><\/span><\/span>>
              \u00a0\u00a0\u00a0\u00a0\u00a0 <WorkItemLinkFilters <\/span><\/span><\/span><\/span><\/span>FilterType<\/span><\/span><\/span>=<\/span><\/span><\/span>“excludeAll<\/span><\/span>” \/<\/span><\/span><\/span><\/span><\/span>>
              <\/span><\/span><\/span>\u00a0\u00a0\u00a0\u00a0\u00a0 <ExternalLinkFilters <\/span><\/span><\/span><\/span><\/span>FilterType<\/span><\/span><\/span>=<\/span><\/span><\/span>“include<\/span><\/span>“<\/span><\/span><\/span><\/span><\/span>>
              <\/span><\/span><\/span>\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <Filter <\/span><\/span><\/span><\/span><\/span>LinkType<\/span><\/span><\/span>=<\/span><\/span><\/span>“Storyboard<\/span><\/span>” \/<\/span><\/span><\/span><\/span><\/span>>
              <\/span><\/span><\/span>\u00a0\u00a0\u00a0\u00a0\u00a0 <\/ExternalLinkFilters<\/span><\/span><\/span><\/span><\/span><\/span>>
              <\/span><\/span><\/span>\u00a0\u00a0\u00a0\u00a0\u00a0 <LinkColumns<\/span><\/span><\/span><\/span><\/span><\/span>>
              <\/span><\/span><\/span>\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <LinkColumn <\/span><\/span><\/span><\/span><\/span>RefName<\/span><\/span><\/span>=<\/span><\/span><\/span>“System.Title<\/span><\/span>” \/<\/span><\/span><\/span><\/span><\/span>>
              <\/span><\/span><\/span>\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <LinkColumn <\/span><\/span><\/span><\/span><\/span>LinkAttribute<\/span><\/span><\/span>=<\/span><\/span><\/span>“System.Links.Comment<\/span><\/span>” \/<\/span><\/span><\/span><\/span><\/span>>
              <\/span><\/span><\/span>\u00a0\u00a0\u00a0\u00a0\u00a0 <\/LinkColumns<\/span><\/span><\/span><\/span><\/span><\/span>>
              <\/span><\/span><\/span>\u00a0\u00a0\u00a0 <\/LinksControlOptions<\/span><\/span><\/span><\/span><\/span><\/span>>
              <\/span><\/span><\/span><\/span><\/span><\/span>\u00a0 <\/Control<\/span><\/span><\/span><\/span><\/span><\/span>>
              <\/span><\/span><\/span><\/<\/span><\/span>Tab<\/span><\/span><\/span><\/span>><\/span>\u00a0
              <\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/span><\/li>\n
            5. Save the file
              <\/span><\/li>\n
            6. Run the following command from the Developer Command Prompt to import the modified definition for the work item type \n

              <\/span>\u00a0\u00a0\u00a0 witadmin importwitd \/collection:http:\/\/localhost<\/span>:8080\/tfs\/defaultcollection<\/span> \/p:Agile5<\/span> \/f:\u201d%temp%<\/span><\/span>user story<\/span>.xml\u201d<\/span><\/span><\/li>\n<\/ol>\n

              You have now successfully applied all changes to your Agile team project to use all the features as we have designed them. We would love to hear your feedback in the <\/span>MSDN Forums<\/span><\/a> to ask questions, on <\/span>Microsoft Connect<\/span><\/a> to file bugs and <\/span>user voice<\/span><\/a> to suggest new features.<\/span><\/span><\/p>\n

              Ewald Hofman
              Program Manager, Team Foundation Server<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"

              Summary When a new version of TFS comes out, there are new features. Some of those features are backed by metadata such as work item types and work item categories. If you had to upgrade your TFS 2008 team project to TFS 2010 you know that this can be a daunting exercise. For TFS11 there […]<\/p>\n","protected":false},"author":111,"featured_media":45953,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[227,253,1],"tags":[],"class_list":["post-5483","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-agile","category-azure-devops-server","category-devops"],"acf":[],"blog_post_summary":"

              Summary When a new version of TFS comes out, there are new features. Some of those features are backed by metadata such as work item types and work item categories. If you had to upgrade your TFS 2008 team project to TFS 2010 you know that this can be a daunting exercise. For TFS11 there […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/5483","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/users\/111"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=5483"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/5483\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/45953"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=5483"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=5483"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=5483"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}