FAQ #2: How do I enforce a rule on Area Path or Iteration Path?

I saw a question on this recently and thought it would be good to contribute to the FAQ that Gregg started:

Incidentally, this solution is from Gregg too 🙂

  <FIELD name=”Iteration Path – Validation” refname=”MyFields.IterationPathValidation” type=”String”>
   <HELPTEXT>Hidden field used to validate Iteration Path</HELPTEXT>
   <WHEN field=”System.IterationId” value=”XX“>
    <COPY from=”value” value=”Restricted” />
   <PROHIBITEDVALUES not = “[project]\Project Administrators”>
    <LISTITEM value=”Restricted”/>

Where XX is the Iteration ID of the root level node. Change Iteration to Area for Area Path field. So if you want to prevent users specifying just root node as AreaPath or IterationPath, put the project name (root) there and users will get an error message that “Iteration Path – Validation has invalid value.

Note: This will work for Area Path as well.



Comments (5)

  1. Martin Hinshelwood on TFS Event Handler CTP 2 Released. Brian Harry on Requirements management with Team…

  2. barnesbuilt says:

    This is exactly what I’m needing but it fails.  No matter what I put in it throws the error.  Any ideas?

  3. Hi barnesbuilt,

    Sorry for the delay.

    Could you reply back to sbhatia(at)Microsoft.com with the error?  We’ll look into it.



  4. richardb says:

    Using the XML definition above, it was impossible to get the field to validate, even if the user changed to a valid area path.  Here was my solution:

         <FIELD name="Iteration Path – Validation" refname="MyFields.IterationPathValidation" type="String">

      <HELPTEXT>Hidden field used to validate Iteration Path</HELPTEXT>

      <WHEN field="System.IterationId" value="XX">

       <COPY from="value" value="Restricted" />


      <WHENNOT field="System.IterationId" value="XX">

       <COPY from="value" value="Ok" />


      <PROHIBITEDVALUES not = "[project]Project Administrators">

       <LISTITEM value="Restricted"/>



Skip to main content