A couple of days ago someone asked me how to export the areas and iterations from one project and be able to use them as a template to create other projects. Creating a set of pre-defined Areas & Iterations is a feature of the TFS process templates. In this post I’ve included a sample to show how to export the Areas and Iterations of an existing project into the format required for the Project Creation Wizard to use.<\/p>\n
It is a command line tool with usage of the following form:<\/p>\n
ExportClassifications \/server:<yourserver> <yourproject><\/p>\n
This will create a file called Classification.xml that contains properly formatted XML for the Project Creation Wizard to use.<\/p>\n
The only things that remain are <\/p>\n
I’ve attached the full sample project and a compiled version of the exe to this post for those who want it. I’ve also included here the “heart” of the code that does the real work if you’re just intersted in the API mechanics.<\/p>\n
\/\/ Connect to the server. \/\/ Get the common structure interface. \/\/ Get the project we want to operate on. \/\/ Create the XML document that we are going to write the areas and iterations to. \/\/ Create the tasks top level node. \/\/ Create the node for the CommonStructureService task. \/\/ Create the node to contain the data for the CommonStructureService task. \/\/ Create the container for the root level CSS heirarchy nodes. \/\/ Get the list of heirarchies from the server. \/\/ Get the XML for this CSS Hierarchy. \/\/ Skip down the hierarchy past the root node (which contains the same data as in the \/\/ Write the reference to the project mapping file. Brian<\/p>\n
TeamFoundationServer tfs = new TeamFoundationServer(server);<\/font><\/p>\n
ICommonStructureService css = (ICommonStructureService)tfs.GetService(typeof(ICommonStructureService));<\/font><\/p>\n
ProjectInfo projectInfo = css.GetProjectFromName(project);<\/font><\/p>\n
XmlDocument doc = new XmlDocument();
doc.AppendChild(doc.CreateXmlDeclaration(“1.0”, “utf-8”, null));<\/font><\/p>\n
XmlNode parent = doc.CreateNode(XmlNodeType.Element, “tasks”, String.Empty);
doc.AppendChild(parent);<\/font><\/p>\n
XmlNode child = doc.CreateNode(XmlNodeType.Element, “task”, String.Empty);
AddAttribute(doc, child, “id”, “UploadStructure”);
AddAttribute(doc, child, “name”, “Creating project structure”);
AddAttribute(doc, child, “plugin”, “Microsoft.ProjectCreationWizard.Classification”);
AddAttribute(doc, child, “completionMessage”, “Team project structure created.”);
parent.AppendChild(child);
parent = child;<\/font><\/p>\n
child = doc.CreateNode(XmlNodeType.Element, “taskXml”, String.Empty);
parent.AppendChild(child);
parent = child;
XmlNode taskXmlNode = child;<\/font><\/p>\n
child = doc.CreateNode(XmlNodeType.Element, “Nodes”, String.Empty);
parent.AppendChild(child);
parent = child;<\/font><\/p>\n
NodeInfo[] nodes = css.ListStructures(projectInfo.Uri);
foreach (NodeInfo node in nodes)
{
\/\/ Handle the root nodes in the hierarchy specially because they have slightly different
\/\/ naming and attribute handling.
String name;
if (node.StructureType == “ProjectModelHierarchy”)
{
name = “Area”;
}
else
{
name = “Iteration”;
}
child = doc.CreateNode(XmlNodeType.Element, “Node”, String.Empty);
AddAttribute(doc, child, “StructureType”, node.StructureType);
AddAttribute(doc, child, “Name”, name);
AddAttribute(doc, child, “xmlns”, String.Empty);
parent.AppendChild(child);<\/font><\/p>\n
XmlElement parentXmlNode = css.GetNodesXml(new String[] { node.Uri }, true);<\/font><\/p>\n
\/\/ NodeInfo that we got with ListStructures).
XmlNode inNode = parentXmlNode.ChildNodes[0];
if (inNode.ChildNodes.Count > 0)
{
inNode = inNode.ChildNodes[0];
WriteNodes(doc, child, inNode.ChildNodes);
}
}<\/font><\/p>\n
child = doc.CreateNode(XmlNodeType.Element, “properties”, String.Empty);
taskXmlNode.AppendChild(child);
parent = child;
child = doc.CreateNode(XmlNodeType.Element, “property”, String.Empty);
AddAttribute(doc, child, “name”, “MSPROJ”);
AddAttribute(doc, child, “value”, @”Classification\\FileMapping.xml”);
AddAttribute(doc, child, “isFile”, “true”);
parent.AppendChild(child);
<\/font><\/p>\n