Test Area 5: Change Source Control

This source-control plug-in test area covers changing the source control via the Change Source Control command.

Change Source Control command provides four basic functions for the user:

• Bind:

  Allows a user to establish or reestablish a source control link between a solution/project and the version store.

• Unbind:

  Removes a project/solution from source control on a per-connection basis.

• Connect/Disconnect:

Toggles connected or offline state of the controlled solution — covered in Area 3. For more information, see Test Area 3: Check Out/Undo Checkout.

Command Menu Access

The following Visual Studio integrated development environment menu path is used in the test cases.

Change Source Control:File -> Source Control -> Change Source Control.

Test Cases

The following are specific test cases for the Change Source Control command test area.

Case 5a: Bind

Bind allows the user to add source code control info to the selected projects and solutions. The user is typically prompted to identify a project in source control to which these are to be added. The user may not create a new project in source control as part of this operation (contrast with Add to Source Control).

Action	Test Steps	Expected Results to Verify
Bind to empty location	Create a new project. Add the solution to source control. Open Change Source Control dialog box (File -> Source Control -> Change Source Control). Click Unbind. Accept warning dialog box if it appears. Select all items. Click Bind. Browse to an empty location in a source control store. Click OK to close the Change Source Control dialog box. Click Continue with these bindings in confirmation dialog box. Click OK in the warning dialog box if it appears. Check in everything. If this step succeeds, continue to next step. Open solution from source control to a new location.	Result from Step 12: Solution and project are bound to and written to the new target in the version store. Solution and project files are checked in. Version store project hierarchy matches folder hierarchy of the project on disk. Result from Step 13: All project items are downloaded.
Bind to location that is in sync with client	Create new project. Add the solution to source control. Create a duplicate of the solution and project in the version store (Share and Branch if using Visual SourceSafe). Open Change Source Control dialog box (File -> Source Control -> Change Source Control). Unbind All. Click OK to close Change Source Control dialog box. Reopen Change Source Control dialog box. Select all. Click Bind. Browse to the branched location of the solution and project (from step 3) Click OK to close the Change Source Control dialog box. Get Latest recursively for all items.	File content after the get is the same as before the get.
Bind to location that is out of sync with client	Create new project. Add the solution to source control. Create a duplicate of the solution and project in the version store (Share and Branch if using Visual SourceSafe). Modify files in the branched project in the version store. Open Change Source Control dialog box (File -> Source Control -> Change Source Control). Unbind all. Click OK to close Change Source Control dialog box. Reopen Change Source Control dialog box. Select all. Click Bind. Browse to branched location for solution and project. Click OK to close the Change Source Control dialog box. Accept Warning dialog box if it appears. Get Latest recursive for all items.	Files that were modified in Step 4 are also modified locally.
Bind solution that was never under source control	Create an empty folder in source control. Create a client project. Open Change Source Control dialog box (File -> Source Control -> Change Source Control). Bind the solution to empty location in source control. Click OK to close the Change Source Control dialog box. Click Continue with these bindings in confirmation dialog box. Click OK in the warning dialog box if it appears.	Solution is added to source control. Solution and project are checked out.
Cancel Bind	Create a new project. Add the solution to source control. Open the Change Source Control dialog box. Unbind All. Click OK button to close the dialog box. If this step succeeds, continue to next step. Reopen the Change Source Control dialog box. Bind to unrelated location. Click Cancel.	Result from Step 5: The solution is no longer under source control Result from Step 8: Solution is still NOT under source control.

Case 5b: Unbind

Unbind removes source code control info from projects and their solution. The affected projects and solution are based on a mix of user selection and how the items were added to source control.

Action	Test Steps	Expected Results to Verify
Unbind solution containing one File System or local IIS Web project and one client project	Create a File System or local IIS Web project. Add the solution to source control. Add a new client project to the solution. Accept Check Out of the solution if prompted. Open the Change Source Control dialog box. Click Unbind. Click OK to close the dialog box. Attempt to check out solution, project, solution items, project items.	Solution and projects are NOT under source control. Source Control menu commands do not appear.
Cancel Unbind	Create a new project. Add the solution to source control. Open the Change Source Control dialog box. Click Unbind all. Click Cancel.	Solution is under source control.

Case 5c: Rebind

Rebind is simply a combination of unbind and bind — the process of rebinding a project/solution that was previously under source control and was unbound.

Action	Test Steps	Expected Results to Verify
Rebind solution and projects without closing the Change Source Control dialog box	Create a new project. Add the solution to source control. Open the Change Source Control dialog box. Click Unbind. Select all rows. Click Bind. Click OK to close the Change Source Control dialog box. Accept checkout if prompted.	Solution and project are under source control.
Rebind project only without closing Change Source Control dialog box	Create a new project. Add only the project to source control using (File->Source Control->Add Selected Projects to Source Control. Open the Change Source Control dialog box. Unbind only the project. Bind only the project.	Solution remains uncontrolled. Project remains controlled.
Rebind solution only without closing Change Source Control dialog box	Create a new project. Add only the solution to source control using (File -> Source Control -> Add Selected Projects to Source Control. Open the Change Source Control dialog box. Unbind only the solution (Do not close Change Source Control dialog box.) Bind only the solution. Click OK to close the dialog box. Check out solution and solution items (if any.)	Solution remains controlled. Project remains uncontrolled.
Rebind solution/project only when in same directory	Create a new project. Add only the project to source control using (File -> Source Control -> Add Selected Projects to Source Control. Close the solution. Create a new solution with at least two projects. Add the solution to source control. Add the project created in Step 1 from source control. Accept the checkout of the solution if prompted. Check in the entire solution. Open the Change Source Control dialog box. Select the added project (from Step 6) and click Unbind. Click OK to close the dialog box. Accept the checkout if prompted. Reopen Change Source Control dialog box. Select the added project (from Step 6) and click Bind. Select the original location.	Solution and projects remain controlled.

See Also

Concepts

Test Guide for Source Control Plug-ins