How to build MSFWinBuild (Team System Process Guidance)
I'm not going to walk through the details of modifying process guidance. Microsoft has some documentation that goes through a better general overview that you should consider for this purpose. What I want to give you is some tips on getting MSFWinBuild (the tool that is used to compile the Process Guidance source XML) up and running.
Here are some things that worked for me...
- Download your Process Guidance XML source from Microsoft:
- Download the Mvp.Xml binaries from SourceForge. This is required to support the next step.
- Download the MSFWinBuild utility from GotDotNet. I had to so some minor manual work to get the project to compile but these should be fairly obvious for you.
- In the Process Guidance, verify the parameters file (MSFAgileParams.xml for Agile) as the paths are hard coded and you'll need to update them for your directory structure. The CMMI source that I downloaded didn't include the params file; I used the agile version as a template to create a version for CMMI.
- Edit and debug the source XML to meet your requirements. This is most typically done with InfoPath as the included templates make it much simpler than brute-force XML. The files in question are under ...\Windows SharePoint Services\Process Guidance\Source\XML from your downloaded source.
- There is mismatch in the Mvp.Xml library with InfoPath. InfoPath strips a CRLF between <?XML...> tag and the following processing instruction tag; this causes an exception in the Mvp.Xml code and will cause the MSFWinBuild to fail. I've manually fix it by using notepad to clean-up the file after using InfoPath. Believe it or not, this is still easier than trying to manually modify the XML, even with a good XML editor.
- Finally, run MSFWinBuild from the command line and pass in the path to your parameters XML file.
This was a bear to get running the first time but hopefully these little hints will get you closer. Happy documenting!