<?xml version="1.0"?><?xml-stylesheet type="text/xsl" href="/rss.xsl"?><rss version="2.0"><channel><title>TFSIntegration Wiki &amp; Documentation Rss Feed</title><link>http://www.codeplex.com/TFSIntegration/Wiki/View.aspx?title=Home</link><description>TFSIntegration Wiki Rss Description</description><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=71</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td width="823" valign="top"&gt;
&lt;p&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;nbsp;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;span style="color:#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/span&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;span style="color:#c0504d"&gt;forum&lt;/span&gt;&lt;/a&gt;&lt;span style="color:#c0504d"&gt; which is monitored by the team.&lt;/span&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug
 tracking systems, but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS,
 and tools that synchronize data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
this page&lt;/a&gt;&amp;nbsp;or review &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;
the latest data sheet&lt;/a&gt;. &lt;br&gt;
&lt;br&gt;
This product is also released through the Visual Studio Code Gallery.&amp;nbsp; To decide whether you should be consuming that release or a build from this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tool
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
here&lt;/a&gt;. &lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; (BETA &amp;amp; work in progress) binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
the forum&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you&amp;rsquo;re thinking about migrating to TFS, but don&amp;rsquo;t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you&amp;rsquo;re looking for migration tools or partner services, please also see &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;
the TFS Migration and Integration Solutions page on MSDN&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt;. &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined on the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
Visual Studio Gallery&lt;/a&gt; and in the &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;
Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;the TFS Integration Tools Documentation&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration Platform,
 and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC adapter
 source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;the TFS Integration Tools Documentation&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
Visual Studio Gallery&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2011/06/06/toc-tfs-integration-tools-blog-posts-and-reference-sites.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Tue, 22 Jan 2013 19:58:36 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20130122075836P</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=70</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td width="823" valign="top"&gt;
&lt;p&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;nbsp;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;span style="color:#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/span&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;span style="color:#c0504d"&gt;forum&lt;/span&gt;&lt;/a&gt;&lt;span style="color:#c0504d"&gt; which is monitored by the team.&lt;/span&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_x_x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug
 tracking systems, but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS,
 and tools that synchronize data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
this page&lt;/a&gt;&amp;nbsp;or review &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;
the latest data sheet&lt;/a&gt;. &lt;br&gt;
&lt;br&gt;
This product is also released through the Visual Studio Code Gallery.&amp;nbsp; To decide whether you should be consuming that release or a build from this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Too
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
here&lt;/a&gt;. &lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; (BETA &amp;amp; work in progress) binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
the forum&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you&amp;rsquo;re thinking about migrating to TFS, but don&amp;rsquo;t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you&amp;rsquo;re looking for migration tools or partner services, please also see &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;
the TFS Migration and Integration Solutions page on MSDN&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt;. &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined on the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
Visual Studio Gallery&lt;/a&gt; and in the &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;
Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;the TFS Integration Tools Documentation&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration Platform,
 and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC adapter
 source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;the TFS Integration Tools Documentation&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
Visual Studio Gallery&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2011/06/06/toc-tfs-integration-tools-blog-posts-and-reference-sites.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>dtneumann</author><pubDate>Wed, 09 May 2012 20:33:00 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20120509083300P</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=69</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td width="823" valign="top"&gt;
&lt;p&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;nbsp;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;span style="color:#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/span&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;span style="color:#c0504d"&gt;forum&lt;/span&gt;&lt;/a&gt;&lt;span style="color:#c0504d"&gt; which is monitored by the team.&lt;/span&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking
 systems, but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools
 that synchronize data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
this page&lt;/a&gt;&amp;nbsp;or review &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;
the latest data sheet&lt;/a&gt;. &lt;br&gt;
&lt;br&gt;
This product is also released through the Visual Studio Code Gallery.&amp;nbsp; To decide whether you should be consuming that release or a build from this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Too
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
here&lt;/a&gt;. &lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; (BETA &amp;amp; work in progress) binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
the forum&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you&amp;rsquo;re thinking about migrating to TFS, but don&amp;rsquo;t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you&amp;rsquo;re looking for migration tools or partner services, please also see &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;
the TFS Migration and Integration Solutions page on MSDN&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt;. &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined on the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2"&gt;
Visual Studio Gallery&lt;/a&gt; and in the &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;
Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;the TFS Integration Tools Documentation&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration Platform,
 and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC adapter
 source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;the TFS Integration Tools Documentation&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
Visual Studio Gallery&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2011/06/06/toc-tfs-integration-tools-blog-posts-and-reference-sites.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>dtneumann</author><pubDate>Wed, 09 May 2012 20:29:33 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20120509082933P</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=68</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td width="823" valign="top"&gt;
&lt;p&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;nbsp;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;span style="color:#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/span&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;span style="color:#c0504d"&gt;forum&lt;/span&gt;&lt;/a&gt;&lt;span style="color:#c0504d"&gt; which is monitored by the team.&lt;/span&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking
 systems, but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools
 that synchronize data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
this page&lt;/a&gt;&amp;nbsp;or review &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;
the latest data sheet&lt;/a&gt;. &lt;br&gt;
&lt;br&gt;
This product is also released through the Visual Studio Code Gallery.&amp;nbsp; To decide whether you should be consuming that release or a build from this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Too
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
here&lt;/a&gt;. &lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; (BETA &amp;amp; work in progress) binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
the forum&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you&amp;rsquo;re thinking about migrating to TFS, but don&amp;rsquo;t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you&amp;rsquo;re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt;. &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined on the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2"&gt;
Visual Studio Gallery&lt;/a&gt; and in the &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;
Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a title="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe" href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2011/06/06/toc-tfs-integration-tools-blog-posts-and-reference-sites.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>dtneumann</author><pubDate>Wed, 09 May 2012 20:27:09 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20120509082709P</guid></item><item><title>Updated Wiki: Home</title><link>https://tfsintegration.codeplex.com/wikipage?version=67</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;
&lt;p&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;span style="color:#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/span&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;span style="color:#c0504d"&gt;forum&lt;/span&gt;&lt;/a&gt;&lt;span style="color:#c0504d"&gt; which is monitored by the team.&lt;/span&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking
 systems, but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools
 that synchronize data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
This product is also released through the Visual Studio Code Gallery.&amp;#160; To decide whether you should be consuming that release or a build from this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a title="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe" href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe&lt;/a&gt;.
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; (BETA &amp;amp; work in progress) binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt;. &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined on the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2"&gt;
Visual Studio Gallery&lt;/a&gt; and in the &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;
Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a title="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe" href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2011/06/06/toc-tfs-integration-tools-blog-posts-and-reference-sites.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Wed, 04 Apr 2012 21:59:29 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20120404095929P</guid></item><item><title>Updated Wiki: Home</title><link>https://tfsintegration.codeplex.com/wikipage?version=66</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;
&lt;p&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;span style="color:#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/span&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;span style="color:#c0504d"&gt;forum&lt;/span&gt;&lt;/a&gt;&lt;span style="color:#c0504d"&gt; which is monitored by the team.&lt;/span&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking
 systems, but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools
 that synchronize data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
This product is also released through the Visual Studio Code Gallery.&amp;#160; To decide whether you should be consuming that release or a build from this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a title="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe" href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe&lt;/a&gt;.
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt;. &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined on the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2"&gt;
Visual Studio Gallery&lt;/a&gt; and in the &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;
Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a title="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe" href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2011/06/06/toc-tfs-integration-tools-blog-posts-and-reference-sites.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Tue, 20 Mar 2012 10:52:32 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20120320105232A</guid></item><item><title>Updated Wiki: Home</title><link>https://tfsintegration.codeplex.com/wikipage?version=65</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;
&lt;p&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;span style="color:#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/span&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;span style="color:#c0504d"&gt;forum&lt;/span&gt;&lt;/a&gt;&lt;span style="color:#c0504d"&gt; which is monitored by the team.&lt;/span&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking
 systems, but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools
 that synchronize data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
This product is also released through the Visual Studio Code Gallery.&amp;#160; To decide whether you should be consuming that release or a build from this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a title="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe" href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe&lt;/a&gt;.
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt;. &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined on the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2"&gt;
Visual Studio Gallery&lt;/a&gt; and in the &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;
Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a title="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe" href="http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe"&gt;
http://visualstudiogallery.msdn.microsoft.com/eb77e739-c98c-4e36-9ead-fa115b27fefe&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Tue, 20 Mar 2012 10:51:28 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20120320105128A</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=64</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;
&lt;p&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;span style="color:#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/span&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;span style="color:#c0504d"&gt;forum&lt;/span&gt;&lt;/a&gt;&lt;span style="color:#c0504d"&gt; which is monitored by the team.&lt;/span&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking
 systems, but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools
 that synchronize data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
This product is also released through the Visual Studio Code Gallery.&amp;#160; To decide whether you should be consuming that release or a build from this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2"&gt;
http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2&lt;/a&gt;.
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt;. &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined on the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2"&gt;
Visual Studio Gallery&lt;/a&gt; and in the &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;
Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a title="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2" href="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2"&gt;
http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Sat, 21 Jan 2012 17:07:21 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20120121050721P</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=63</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;
&lt;p&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;span style="color:#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/span&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;span style="color:#c0504d"&gt;forum&lt;/span&gt;&lt;/a&gt;&lt;span style="color:#c0504d"&gt; which is monitored by the team.&lt;/span&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking
 systems, but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools
 that synchronize data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
This product is also released through the Visual Studio Code Gallery.&amp;#160; To decide whether you should be consuming that release or a build from this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2"&gt;
http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2&lt;/a&gt;.
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt;. &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined on the
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2"&gt;
Visual Studio Gallery&lt;/a&gt; and in the &lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;
Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_x_x_x_x_x_Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Wed, 13 Apr 2011 17:29:58 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20110413052958P</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=62</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td width="823" valign="top"&gt;
&lt;p&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;nbsp;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;span style="color:#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/span&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;span style="color:#c0504d"&gt;forum&lt;/span&gt;&lt;/a&gt;&lt;span style="color:#c0504d"&gt; which is monitored by the team.&lt;/span&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking
 systems, but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools
 that synchronize data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
This product is also released through the Visual Studio Code Gallery.&amp;nbsp; To decide whether you should be consuming that release or a build from this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2"&gt;
http://visualstudiogallery.msdn.microsoft.com/f854dd59-8eeb-4673-8d9a-ae012989bfa2&lt;/a&gt;.
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you&amp;rsquo;re thinking about migrating to TFS, but don&amp;rsquo;t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you&amp;rsquo;re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt; (see the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; page for details). &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined in the
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_x_x_x_x_Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>dtneumann</author><pubDate>Fri, 25 Mar 2011 02:27:28 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20110325022728A</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=61</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div align="center"&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;
&lt;p align="center"&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;font color="#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/font&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;font color="#c0504d"&gt;forum&lt;/font&gt;&lt;/a&gt;&lt;font color="#c0504d"&gt; which is monitored by the team.&lt;/font&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking systems,
 but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools that synchronize
 data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
To decide whether you should rather be on the Visual Studio Code Gallery or on this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt; (see the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; page for details). &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined in the
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_x_x_x_Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Wed, 16 Mar 2011 14:48:32 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20110316024832P</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=60</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div align="center"&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;
&lt;p align="center"&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;font color="#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/font&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;font color="#c0504d"&gt;forum&lt;/font&gt;&lt;/a&gt;&lt;font color="#c0504d"&gt; which is monitored by the team.&lt;/font&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking systems,
 but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools that synchronize
 data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
To decide whether you should rather be on the Visual Studio Code Gallery or on this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt; (see the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; page for details). &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined in the
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_x_x_x_Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Wed, 16 Mar 2011 14:45:27 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20110316024527P</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=59</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;div align="center"&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827" align="center"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;
&lt;p align="center"&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;font color="#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/font&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;font color="#c0504d"&gt;forum&lt;/font&gt;&lt;/a&gt;&lt;font color="#c0504d"&gt; which is monitored by the team.&lt;/font&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;/div&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking systems,
 but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools that synchronize
 data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
To decide whether you should rather be on the Visual Studio Code Gallery or on this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt; (see the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; page for details). &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined in the
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_x_x_x_Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Wed, 16 Mar 2011 00:08:20 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20110316120820A</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=58</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;
&lt;p align="center"&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;font color="#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/font&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;font color="#c0504d"&gt;forum&lt;/font&gt;&lt;/a&gt;&lt;font color="#c0504d"&gt; which is monitored by the team.&lt;/font&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking systems,
 but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools that synchronize
 data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
To decide whether you should rather be on the Visual Studio Code Gallery or on this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt; (see the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; page for details). &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined in the
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_x_x_x_Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Wed, 16 Mar 2011 00:07:45 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20110316120745A</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=57</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;
&lt;p align="center"&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;&lt;font color="#c0504d"&gt;Please do not create issues or discussions using the Issue Tracker for this project, but instead use the MSDN
&lt;/font&gt;&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;&lt;font color="#c0504d"&gt;forum&lt;/font&gt;&lt;/a&gt;&lt;font color="#c0504d"&gt; which is monitored by the team.&lt;/font&gt;&lt;/p&gt;
&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking systems,
 but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools that synchronize
 data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
To decide whether you should rather be on the Visual Studio Code Gallery or on this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt; (see the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; page for details). &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined in the
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_x_x_x_Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Wed, 16 Mar 2011 00:06:14 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20110316120614A</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=56</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;Please do not create issues using the Issue Tracker for this project, but instead use the MSDN
&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;forum&lt;/a&gt; which is monitored by the team.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking systems,
 but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools that synchronize
 data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
To decide whether you should rather be on the Visual Studio Code Gallery or on this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt; (see the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; page for details). &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined in the
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_x_x_x_Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Tue, 15 Mar 2011 14:19:20 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20110315021920P</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=55</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;Please do not create issues using the Issue Tracker for this project, but instead use the MSDN
&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;forum&lt;/a&gt; which is monitored by the team.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking systems,
 but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools that synchronize
 data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
To decide whether you should rather be on the Visual Studio Code Gallery or on this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;ol&gt;
&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt; (see the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; page for details). &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined in the
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/126821"&gt;Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_x_x_x_Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Tue, 15 Mar 2011 14:18:30 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20110315021830P</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=54</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td width="823" valign="top"&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;nbsp;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;Please do not create issues using the Issue Tracker for this project, but instead use the MSDN
&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;forum&lt;/a&gt; which is monitored by the team.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking systems,
 but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools that synchronize
 data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
To decide whether you should rather be on the Visual Studio Code Gallery or on this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;ol&gt;
&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you&amp;rsquo;re thinking about migrating to TFS, but don&amp;rsquo;t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you&amp;rsquo;re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476#DownloadId=91073"&gt;
Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt; (see the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; page for details). &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined in the
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/91073"&gt;Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_x_x_Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Mon, 22 Nov 2010 16:52:11 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20101122045211P</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=53</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td width="823" valign="top"&gt;&lt;span style="font-size:large"&gt;&lt;strong&gt;&lt;em&gt;&lt;span style="color:#ff0000"&gt;NOTICE&lt;/span&gt;&amp;nbsp;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/span&gt;Please do not create issues using the Issue Tracker for this project, but instead use the MSDN
&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;forum&lt;/a&gt; which is monitored by the team.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking systems,
 but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools that synchronize
 data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
&lt;p&gt;The Microsoft Visual Studio &lt;strong&gt;TFS Integration Tools&lt;/strong&gt; is a suite of tools, built on top of the
&lt;strong&gt;TFS Integration Platform&lt;/strong&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
To decide whether you should rather be on the Visual Studio Code Gallery or on this Codeplex site you can review the following three questions:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;strong&gt;supported&lt;/strong&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;strong&gt;bleeding-edge&lt;/strong&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;strong&gt;custom adapter&lt;/strong&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;ol&gt;
&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;/li&gt;&lt;/ol&gt;
&lt;p&gt;&lt;strong&gt;Have a question or comment?&lt;/strong&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.&lt;/p&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
&lt;p&gt;If you&amp;rsquo;re thinking about migrating to TFS, but don&amp;rsquo;t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you&amp;rsquo;re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;/a&gt;.&lt;/p&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
&lt;p&gt;One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476#DownloadId=91073"&gt;
Migration Guidance Document&lt;/a&gt;).&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Migration&lt;/strong&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;strong&gt;lossy data transfer&lt;/strong&gt; (see the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; page for details). &lt;/li&gt;&lt;li&gt;&lt;strong&gt;Upgrade&lt;/strong&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;strong&gt;full fidelity, meaning there is no data loss&lt;/strong&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
&lt;p&gt;TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Version Control&lt;/strong&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;strong&gt;Work Item Tracking&lt;/strong&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
&lt;p&gt;The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;/a&gt;.&lt;/p&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
&lt;p&gt;Please also be aware of the Limitations that exist for this platform, as outlined in the
&lt;a href="Limited to migrating only Version Control items, Work Items, and the links between them. Other portions of Team Projects are not migrated by this tool, including Reports, Team Build data, and SharePoint content.  "&gt;
Migration Guidance&lt;/a&gt; document. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.&lt;/p&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
&lt;p&gt;If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the TFS Integration
 Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document is the actual POC
 adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_x_Rangers"&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
&lt;p&gt;The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical specialists
 from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.&lt;/p&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Mon, 22 Nov 2010 16:51:06 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20101122045106P</guid></item><item><title>Updated Wiki: Home</title><link>http://tfsintegration.codeplex.com/wikipage?version=52</link><description>&lt;div class="wikidoc"&gt;
&lt;h1&gt;Welcome to the TFS Integration Platform!&lt;/h1&gt;
&lt;p&gt;
&lt;table border="2" cellspacing="0" cellpadding="2" width="827"&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td valign="top" width="823"&gt;&lt;font size="5"&gt;&lt;strong&gt;&lt;em&gt;&lt;font color="#ff0000"&gt;NOTICE&lt;/font&gt;&amp;#160;
&lt;br&gt;
&lt;/em&gt;&lt;/strong&gt;&lt;/font&gt;Please do not create issues using the Issue Tracker for this project, but instead use the MSDN
&lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;forum&lt;span&gt;&lt;/span&gt;&lt;/a&gt; which is monitored by the team.&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;br&gt;
The TFS Integration Platform is a project developed by the Team Foundation Server (TFS) product group and the
&lt;a href="#x_Rangers"&gt;Visual Studio ALM Rangers&lt;/a&gt; to facilitate the development of tools that integrate TFS with other systems. Currently, the scope of this project is to enable TFS to integrate with other version control and work-item/bug tracking systems,
 but the eventual goal of this project is to enable integration with a broader range of tools/systems (i.e. build). This platform enables the development of two major classifications of tools: tools that move data unidirectionally into TFS, and tools that synchronize
 data bidirectionally. &lt;br&gt;
&lt;br&gt;
Prior to this project, we had a similar effort called the TFS Migration and Synchronization Toolkit. This platform is designed to replace that project. You can find the archived wiki content for that project on the
&lt;a href="/TFSIntegration/wikipage?title=Archive&amp;referringTitle=Home"&gt;Archive&lt;/a&gt; page, and the releases are still available on the Downloads tab.
&lt;br&gt;
&lt;/p&gt;
&lt;h1&gt;Should you be here or on Visual Studio Code Gallery?&lt;/h1&gt;
The Microsoft Visual Studio &lt;b&gt;TFS Integration Tools&lt;/b&gt; is a suite of tools, built on top of the
&lt;b&gt;TFS Integration Platform&lt;/b&gt;, that facilitate integration between external systems and Team Foundation Server. For more information visit
&lt;a href="http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx"&gt;
http://blogs.msdn.com/b/willy-peter_schaub/archive/2010/09/02/tfs-integration-platform-or-tools-or-both.aspx&lt;span&gt;&lt;/span&gt;&lt;/a&gt; or review the latest data sheet
&lt;a href="http://tfsintegration.codeplex.com/releases/35476/download/147910"&gt;http://tfsintegration.codeplex.com/releases/35476/download/147910&lt;span&gt;&lt;/span&gt;&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
To decide whether you should rather be on the Visual Studio Code Gallery or on this Codeplex site you can review the following three questions:
&lt;ol&gt;
&lt;li&gt;Are you looking for a fully &lt;b&gt;supported&lt;/b&gt; product, that you can install and run, then you should be looking at the Team Foundation Server Integration Tools on
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;span&gt;&lt;/span&gt;&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;Are you looking for the &lt;b&gt;bleeding-edge&lt;/b&gt; binary, source and documentation bits, then this Codeplex site is the correct location
&lt;/li&gt;&lt;li&gt;Are you a &lt;b&gt;custom adapter&lt;/b&gt; developer looking for the TFS Integration Platform, then this Codeplex site is the correct location
&lt;ol&gt;
&lt;li&gt;Interested in contributing? Visit the page on &lt;a href="/TFSIntegration/wikipage?title=Contributing&amp;referringTitle=Home"&gt;
Contributing&lt;/a&gt; for more information. Check out these &lt;a href="/TFSIntegration/wikipage?title=Community&amp;referringTitle=Home"&gt;
Community&lt;/a&gt; developed migration/integration projects. &lt;/li&gt;&lt;/ol&gt;
&lt;/li&gt;&lt;/ol&gt;
&lt;b&gt;Have a question or comment?&lt;/b&gt; Please use the &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
http://social.msdn.microsoft.com/Forums/en-US/tfsintegration&lt;span&gt;&lt;/span&gt;&lt;/a&gt; rather than the Issue Tracker on this site. We monitor the forum closely and infrequently look at items in the Issue Tracker.
&lt;br&gt;
&lt;h2&gt;Migration Guidance&lt;/h2&gt;
If you’re thinking about migrating to TFS, but don’t know where to start, then check out the recommended download (Migration Guidance Document) for the
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;TFS Integration Platform&lt;/a&gt; release. This document outlines many of the common scenarios for migrating data into TFS, and it provides recommended options for each scenario.
&lt;br&gt;
&lt;br&gt;
If you’re looking for migration tools or partner services, please also see the TFS Migration and Integration Solutions page on MSDN
&lt;a href="http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;http://msdn.microsoft.com/en-us/teamsystem/bb840033.aspx&lt;span&gt;&lt;/span&gt;&lt;/a&gt;.
&lt;br&gt;
&lt;h3&gt;Upgrade vs. Migration&lt;/h3&gt;
One common area of confusion is around the definition of &amp;quot;migration&amp;quot;, especially as to how it compares with the term &amp;quot;upgrade&amp;quot;. Below is an explanation of how these concepts differ (also see the aforementioned
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476#DownloadId=91073"&gt;
Migration Guidance Document&lt;span&gt;&lt;/span&gt;&lt;/a&gt;).
&lt;ul&gt;
&lt;li&gt;&lt;b&gt;Migration&lt;/b&gt; - For this project, and for TFS in general, we use the term &amp;quot;migration&amp;quot; to refer to moving data between two TFS server instances. Migration is done through the APIs of TFS by using external tools, and is a
&lt;b&gt;lossy data transfer&lt;/b&gt; (see the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; page for details). &lt;/li&gt;&lt;li&gt;&lt;b&gt;Upgrade&lt;/b&gt; - We would define &amp;quot;upgrade&amp;quot; as the fully supported, in-the-box process of changing to the next version of TFS (e.g. upgrading from TFS 2005 to TFS 2008). Upgrades are done at the database level, and are
&lt;b&gt;full fidelity, meaning there is no data loss&lt;/b&gt;. &lt;/li&gt;&lt;/ul&gt;
&lt;h2&gt;Scope&lt;/h2&gt;
TFS is currently comprised of several major feature areas, including, version control, work item tracking, build automation, reporting, and SharePoint. At this point in time, the TFS Integration Platform is scoped to only support a the following TFS features:
&lt;ul&gt;
&lt;li&gt;&lt;b&gt;Version Control&lt;/b&gt; - This includes the migration of all files and folders, and support for preserving changeset contents. The following changetypes are currently supported: add, edit, rename, delete, branch, merge, and type.
&lt;/li&gt;&lt;li&gt;&lt;b&gt;Work Item Tracking&lt;/b&gt; - This includes the migration of all work item revisions, fields, in-use areas and iterations, and links (including links to changesets).
&lt;/li&gt;&lt;/ul&gt;
&lt;h3&gt;Vision&lt;/h3&gt;
The TFS Integration Platform is a development platform for partners and customers who are interested in building bridges from other systems to TFS. One goal of the project is to make it simple to write a simple adapter for connecting such systems. We intend
 to continue to invest in raising the level of abstraction for those interested in building solutions by providing a common host UI and eventually wiring in features like offline and more natural cross-domain support into the platform.
&lt;br&gt;
&lt;br&gt;
Through the development of solutions built on top of this platform by our team, and by our partners, we plan to drive features back into the platform. Feedback from end users of those solutions will also be critical to prioritizing the right areas of investment,
 so please help us by sharing your experiences and feedback in our &lt;a href="http://social.msdn.microsoft.com/Forums/en-US/tfsintegration"&gt;
forum&lt;span&gt;&lt;/span&gt;&lt;/a&gt;. &lt;br&gt;
&lt;h2&gt;Limitations&lt;/h2&gt;
Please also be aware of the &lt;a href="/TFSIntegration/wikipage?title=Limitations&amp;referringTitle=Home"&gt;
Limitations&lt;/a&gt; that exist for this platform. Not all scenarios are currently able to be supported due to limitations of TFS, and not all features of TFS are in scope for this project.
&lt;br&gt;
&lt;h2&gt;Getting Started&lt;/h2&gt;
If you're a developer and you are looking to get started building an adapter, the best resource for you is the Custom Adapter POC Documentation which you can find in the the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;span&gt;&lt;/span&gt;&lt;/a&gt;, built by the Rangers. This release contains a document that walks through the setup of a development environment for the
 TFS Integration Platform, and contains a guided tour of a proof of concept (POC) adapter. The document was written with the purpose of helping adapter developers understand the key concepts for building adapters on the platform. Accompanying this document
 is the actual POC adapter source code, which is in the downloads page. &lt;br&gt;
&lt;br&gt;
If you're looking to learn more details about the platform, the core architecture, and the included TFS adapters, check out the TFS Integration Tools Documentation on
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;span&gt;&lt;/span&gt;&lt;/a&gt;.
&lt;br&gt;
&lt;br&gt;
Developers looking to start building adapters will also need the installable from
&lt;a href="http://tfsintegration.codeplex.com/releases/view/35476"&gt;http://tfsintegration.codeplex.com/releases/view/35476&lt;span&gt;&lt;/span&gt;&lt;/a&gt; or
&lt;a href="http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e"&gt;
http://visualstudiogallery.msdn.microsoft.com/en-us/5a8d1703-7987-4081-ba2f-9d0b68b0ed3e&lt;span&gt;&lt;/span&gt;&lt;/a&gt;. This release contains the binaries for the platform as well as the TFS adapters.
&lt;br&gt;
&lt;br&gt;
For those developers that want to see the latest source code for this project, please go to the Source Code tab.
&lt;br&gt;
&lt;br&gt;
&lt;a name="x_Rangers"&gt;&lt;/a&gt;
&lt;h2&gt;Visual Studio ALM Rangers&lt;/h2&gt;
The &lt;a href="http://msdn.microsoft.com/en-us/teamsystem/ee358786.aspx"&gt;Visual Studio ALM Rangers&lt;span&gt;&lt;/span&gt;&lt;/a&gt; are delivering guidance to this initiative with support from Microsoft software engineers, Microsoft Most Valued Professionals (MVPs) and technical
 specialists from technology communities around the globe, giving you a real-world view from the field, where the technology has been tested and used.
&lt;br&gt;
&lt;h2&gt;Links&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="http://msdn2.microsoft.com/en-us/teamsystem/bb840033.aspx"&gt;Migration and Integration Solutions&lt;span&gt;&lt;/span&gt;&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub/archive/2009/10/07/tfs-integration-platform-summary-of-links.aspx"&gt;Table of Contents for Willy's blog&lt;span&gt;&lt;/span&gt;&lt;/a&gt;
&lt;/li&gt;&lt;li&gt;&lt;a href="http://blogs.msdn.com/willy-peter_schaub"&gt;Willy Peter's Blog&lt;span&gt;&lt;/span&gt;&lt;/a&gt;
&lt;/li&gt;&lt;/ul&gt;
&lt;/div&gt;&lt;div class="ClearBoth"&gt;&lt;/div&gt;</description><author>wschaub</author><pubDate>Fri, 22 Oct 2010 00:09:51 GMT</pubDate><guid isPermaLink="false">Updated Wiki: Home 20101022120951A</guid></item></channel></rss>