Submitting Changes to the Source Control Server

Team Foundation source control files are checked in to the source control server using the Pending Changes window or the Checkin dialog box. For more information, see Using the Check In and Pending Changes Windows. These check-ins are submitted atomically as changesets. During a check-in the user can associate work items, provide release notes and review check-in policy adherence for the changes. Various information of the check-in process can be customized by an administrator.

The Team Foundation source control check in process performs the following actions:

  • Validates compliance with check-in policy.

  • Submits source file changes.

  • Updates associated work items.

  • Sends e-mail notification.

How the check in process works

When the check-in operation is performed, the source file updates either succeed completely or fail completely. If any of the changes in the list of pending changes cannot be submitted to the server (for example, you lose network connectivity in the middle of the operation), none of the changes are committed and a changeset is not created.

If the basis version of any item in the list of pending changes differs from the latest server version (for example, you checked out version 4 of stellar.cs and the latest server version is now version 6), Team Foundation prompts you to resolve any conflicts between your version and the latest server version first. The Resolve dialog box appears to help you investigate and resolve version differences. After you resolve outstanding differences and re-test your code, you can then attempt to check in your changes again.

Upon completion of the check-in operation:

  • The changes are committed to the server as a changesets and the changeset number is displayed.

  • Files that were checked out are returned to a read-only state. Your changes appear in the server and can be retrieved by other users.

  • E-mail is delivered to team members who have subscribed for check-in notification.

  • Work items are updated.

Customizing the check in process

A Team Foundation administrator can configure the check-in notes and check-in policies that apply to a given team project. For more information, see Walkthrough: Customizing Check-in Policies and Notes.

In This Section


Team Foundation Source Control Command-Line Reference

See Also

Other Resources

Working with Team Foundation Source Control