Configuration Files

The TFS Migration and Sync Toolkit is configured by an XML file. The XML schema contains many nodes some of which are described below:

Top Level Nodes

Name Description
Providers Contains individual providers to be used by the Toolkit. A Provider is used by a Session to determine what data is being migrated/sycned to TFS. Each Provider node contains an AssemblyQualifiedName for the assembly associated with that data provider. Providers are also required for any EventSinks used by a Session and the Linking engine.
Servers Contains the TFS nodes for each Server being migrated/sycned to or from. TFS nodes contain a URL for the server.
Settings Defines the name-value mappings for global Toolkit Settings.
VC Contains the version control specific Sessions and Settings.
WIT Contains the work item tracking specific Sessions and Settings.
SQL Contains the ConnectionString, Database name, and Server name for the SQL server to be used by the Toolkit. If the ConnectionString is specified, it is not necessary to specify the Database name and Server name. If all are specified, the ConnectionString will be used in place of the Database and Server pair. Note: the SQL instance used for migration should not be the SQL instance used by the TFS data tier.

Version Control (VC) Node

Name Description
Settings Settings for all VC Sessions. A list of VC Settings can be found on the Version Control Settings page.
Sessions Defines the VC Sessions. The Session table below defines the nodes of the VC Session node.

VC Session

Name Description
Settings VC Settings specific to this Session.
Mappings Contains the Mapping of source paths to target paths to be migrated/synced by this Session. If the cloak value is set to "true", the Mapping will be cloaked out from the mapping of its parent.
Tfs Defines the TFS (destination) server and workspace to be used in this Session. This is where migrated items are migrated to.
Source Defines the source server from which data will be migrated. This node is specific to the Provider for the Session.
EventSinks Defines the sinks for events from this Session. EventSinks include report adaptors. Details are specific to the individual Provider.


Work Item Tracking (WIT) Node

Name Description
Settings Settings for all WIT Sessions.
Sessions Defines the WIT Sessions. The Session table below defines the nodes of the WIT Session node.
FieldMaps Defines the Field Maps. See Field Map table below.
ValueMaps Defines the Value Maps. See Value Map table below.

WIT Session

Name Description
Settings WIT Settings specific to this Session.
Tfs Defines the TFS (destination) server, including the Project, Filter, and MetadataSync settings.
Source Defines the source server from which data will be migrated. Note: this can be another Tfs source.
WorkItemType Defines the mapping between TFS work item types, and types from the source system. FieldMaps are specified here.
Policies Determines how various sync policies should operate. A list of Policies can be found on the Work Item Tracking Policies page.
EventSinks Defines the sinks for events from this Session. EventSinks include report adaptors. Details are specific to the individual Provider.
Linking Defines the linking Engine to be used to handle the link processing. Also specifies a Version Control Session which links from this Session are connected to.

Field Map

Name Description
Field Defines the mapping between a field in TFS and the other system being migrated/synced. Fields also contain references to ValueMaps.
Exclude Defines the fields that will not be synced and the

Value Map

Name Description
Value Defines the mapping between values in TFS and the other system being migrated/synced.

Last edited Jun 29, 2007 at 4:50 PM by mmitrik, version 1

Comments

No comments yet.