I’m in the process of easing the installation of the Work Item Creator.
To do that, I wanted to detect in runtime if a given Team Project doesn’t have its Work Item Types (WITs) supporting hierarchy and then asking the user to add them.
It’s not very complicated to do, once you know how to do it (as always you might say).
To get the definition of a given Work Item Type and add a field, it’s not complicated:
2412 // Get the Xml Document for the given WIT
2413 XmlDocument doc = wit.Export(false);
2414 XmlElement fields = doc.SelectSingleNode("*/WORKITEMTYPE/FIELDS") as XmlElement;
2416 // Look for each field, and add the ones that are not present
2417 XmlElement field = fields.SelectSingleNode("FIELD[@refname="Cegedim.ParentWI"]") as XmlElement;
2418 if (field == null)
2420 field = doc.CreateElement("FIELD");
2421 field.SetAttribute("name", "ParentWI");
2422 field.SetAttribute("refname", "Cegedim.ParentWI");
2423 field.SetAttribute("type", "Integer");
2424 field.InnerXml = "
To validate the type before importing it:
2453 WITValidateSucceed = true;
2454 prj.WorkItemTypes.ImportEventHandler += new ImportEventHandler(WorkItemType_ValidationEventHandler);
2455 WorkItemType.Validate(prj, doc.OuterXml);
2456 if (WITValidateSucceed == false)
2458 MessageBox.Show("Work Item Type couldn’t pass validation, something went wrong", "Work Item Creator", MessageBoxButtons.OK, MessageBoxIcon.Error);
2459 return false;
The registered event will be fired if the validation failed. Why the Validate method doesn’t return a bool, I don’t know…
2473 void WorkItemType_ValidationEventHandler(object sender, ImportEventArgs e)
2475 WITValidateSucceed = e.Severity == ImportSeverity.Error;
Then, you’ll have to call Import from the WorkItemTypes collection to update your type:
prj being your Work Item “Project” instance.
Now there’s a small trick and if you don’t know it, you’ll be like me, wasting 2 hours trying to figuring out why your application is totally crashing when you try to modify two WITs in a row.
Importing an existing WIT will update the server side, but apparently the definition of your WITs are cached in local, and this cache is not updated by the Import method (it could have been…), so if you try to modify a second WIT, somehow the Team System Object Mode doesn’t like it!
The solution is not that hard though, after your import, you only have to call these two methods:
m_WIS being your instance of the Work Item Store. This way you local version is updated, and you can keep working on WIT modification!