AmitGh's WebLoghttp://blogs.msdn.com/b/amitgh/atom.aspxTelligent Evolution Platform Developer Build (Build: 5.6.50428.7875)2006-08-17T16:40:00ZBypass Workitemtracking Workitem ruleshttp://blogs.msdn.com/b/amitgh/archive/2006/08/20/709737.aspx2006-08-21T00:56:00Z2006-08-21T00:56:00Z<P><FONT face=Verdana size=2>In the TFS Workitemtracking Web service, you can call the Update method and set an attribute called BypassRules to true. That bypasses most of the rules for the Workitemtype in the Project. It is meant to be used to migrate data into the Server from other sources, where the data being passed in may not match the rules currently in existence on the server. A few things to note about this:</FONT></P>
<OL>
<LI><FONT face=Verdana size=2>The BypassRules functionality is not exposed via the TFS Workitemtracking Object Model. It can only be used by calling the Web Service directly or via the Proxy and passing up your own Update XML package to the Update method.</FONT></LI>
<LI><FONT face=Verdana size=2>Only members of the Service Accounts group are allowed to make calls with this flag set. (Otherwise all the WI rules would be meaningless if anyone could choose to bypass rules whenever they wanted.)</FONT></LI>
<LI><FONT face=Verdana size=2>Though most rules realted to Workitems are not verified by the Server when this flag is passed in, a few rules still get verified because they are related to the structural integrity of the WI data. These rules are:</FONT></LI>
<OL>
<LI><FONT face=Verdana size=2>The WorkitemType field needs to have a valid value (a valid value would be a WIT name which is defined for the Project).</FONT></LI>
<LI><FONT face=Verdana size=2>The Rev of the WI being updated needs to be the one currently on the server. (You cannot repeat Revisions or create gaps in them)</FONT></LI>
<LI><FONT face=Verdana size=2>The State field cannot be empty.</FONT></LI>
<LI><FONT face=Verdana size=2>The "Changed Date" value cannot be empty. This is set by the server, the XML package should just mark it as such.</FONT></LI>
<LI><FONT face=Verdana size=2>The AreaId field should not be empty</FONT></LI>
<LI><FONT face=Verdana size=2>The IterationID field should not be empty</FONT></LI>
<LI><FONT face=Verdana size=2>The AreaID field should not be a deleted node.</FONT></LI>
<LI><FONT face=Verdana size=2>The IterationID field should not be a deleted node.</FONT></LI>
<LI><FONT face=Verdana size=2>The Created Date field should not be empty.</FONT></LI>
<LI><FONT face=Verdana size=2>The Created By field should not be empty.</FONT></LI></OL></OL>
<P><FONT face=Verdana size=2>A sample package is pasted below. Say the Bug workitemtype in a Project allows new Bugs to be created only with State = Active. The Bypass rules package below, when run by a member of the Service Accounts group, will ignore that rule.</FONT></P>
<P><FONT face=Verdana size=2><Package><BR> <InsertWorkItem ObjectType='WorkItem' <STRONG>BypassRules='1'</STRONG>><BR> <Columns><BR> <Column Column='System.AreaID' Type='Number'><Value>5</Value></Column><BR> <Column Column='System.IterationID' Type='Number'><Value>10</Value></Column><BR> <Column Column='System.WorkItemType' Type='String'><Value>bug</Value></Column><BR> <Column Column='System.Title' Type='String'><Value>New bug</Value></Column><BR> <STRONG><Column Column='System.State' Type='String'><Value>Closed</Value></Column><BR></STRONG> <Column Column='System.Reason' Type='String'><Value>New</Value></Column><BR> <Column Column='System.CreatedDate' Type='ServerDateTime'></Column><BR> <Column Column='System.CreatedBy' Type='String'><Value>John Doe</Value></Column><BR> <Column Column='System.ChangedBy' Type='String'><Value>John Doe</Value></Column> <BR> </Columns><BR> </InsertWorkItem><BR></Package></FONT></P><div style="clear:both;"></div><img src="http://blogs.msdn.com/aggbug.aspx?PostID=709737" width="1" height="1">MSDNArchivehttp://blogs.msdn.com/MSDNArchive/ProfileUrlRedirect.ashxAbout this blog...http://blogs.msdn.com/b/amitgh/archive/2006/08/17/704947.aspx2006-08-18T02:40:00Z2006-08-18T02:40:00ZMy name is Amit Ghosh and I am a Dev Lead for the Workitemtracking Server component for Team Foundation Server. Planning to use this as a public forum for information about the WIT in the TFS 1.0 release and plans for WIT in future releases.<div style="clear:both;"></div><img src="http://blogs.msdn.com/aggbug.aspx?PostID=704947" width="1" height="1">MSDNArchivehttp://blogs.msdn.com/MSDNArchive/ProfileUrlRedirect.ashx