TS 61 CC

NetBeans ClearCase Support Test Specification for

Author: Peter Pis
Version: 1.0
Lastupdate: 08.02.2008
Introduction: ClearCase is one of the supported version control systems in the IDE. This document describes how ClearCase profile for NetBeans ClearCase Support module should be tested in order to know whether all of its functionality work correctly.

Contents

Test suite: Standard development of project

Purpose: This suite tests the most often used commands of typical CC user.
Setup: Make sure that cleartool can be run from within the command. Dynamic or snapshot View has been setup for valid VOB, and user you are logged in has r/w access to it. Switch View | Show Versioning Labels option from the main menu.

  1. Checkout folder
    1. Switch to
      "Favorites"
      view and invoke {"Add to Favorites"} popup menu action. Choose the directory where CC View points.
    2. Select directory where your project will be placed for the next test case and invoke Clearcase | Checkout... popup menu action.
    3. "Checkout"
      dialog shows up. {"Checkout Message"} area, "Button" recently used messages and "Reserved Checkout" check box should be in this dialog.
    4. Check
      "Reserved Checkout"
      check box.
    5. Enter
      "Checkout Message"
       : {"I need it"} and push "Checkout" button.
    • {{result|EXPECTED RESULT: Directory node should have
      "[Reserved;\main\X]"
      annotation and blue color where X stands for revision number. In the {"Output"} tab there should be "Checked out <directory name> from version "\main\X".
  2. Putting project into a CC View
    1. Invoke
      "File | New Project..."
      from main menu.
    2. "New Project"
      window shows up. Choose e.g {"General | Java Application"} and push "Next" button.
    3. Setup name of the project, project location inside the checkout directory of CC View used in previous test case and push
      "Finish"
      button.
    4. Switch to
      "Projects"
      view.
    • EXPECTED RESULT: Make sure that all nodes have
      "[New; ]"
      annotations and their color is green.
  3. Adding Project under source control
    1. Select project root and invoke Clearcase | Add To Source Control popup menu action.
    2. "Add - <Project Name>"
      window shows up. There should be {"Describing Message"} area, "Button" for recently used messages, "Files to Add" table, "Checkin Added Files" check box in the dialog. While gathering files to be added there should be progress bar "Preparing Add to" indicating the process. Verify that all files of the project are listed in "Files To Add" table.
    3. Enter
      "Describing Message"
      : {"Clearcase saves me"}.
    4. Check
      "Checkin Added Files"
      check box.
    5. Push
      "Add"
      button.
    • EXPECTED RESULT: Project sources shouldn't have any annotations and color of nodes should be black.
  4. File modifying
    1. Select e.g.
      "Main.java"
      file, modify it. Before editing the file it should have {"[R/o]"} in editor tab.
    2. Insert brand-new line somewhere into the file.
    3. Delete some other line but not directly next to the new line.
    4. Modify another line but not directly next to the lines mentioned above and Save the file. File should have
      "[Reserved;\main\X]"
      annotation and its color should be blue.
    • EXPECTED RESULT: The file
      "Main.java"
      must change its foreground color to blue.
  5. File differences
    1. Select this file.
    2. Invoke Versioning | Diff action from main menu.
    • EXPECTED RESULT: All three differences must be highlighted in a special window with both versions of the file. New line is green, removed line is red and modified one is blue.
  6. Files differences
    1. Create new package
      "xx.yy"
      in this project.
    2. Create new
      "Java Class"
      {"NewClass"} in package "xx.yy".
    3. Select project root and invoke Versioning | Show Changes from main menu.
    4. Files should be listed in
      "Clearcase"
      tab - {"Main.java"} and "NewClass".
    5. Select the root of the project and invoke Clearcase | Diff popup menu action.
    • EXPECTED RESULT: Special window is displayed.
      "Main.java"
      and {"NewClass.java"} should be contained in a table. Verify functionality of "UP" and "DOWN" arrows. (Arrow navigates among all differences on processed files). Verify functionality of "Diff" icon in "Clearcase" tab - same result as for context command.
  7. Checkin file
    1. Switch to
      "Clearcase"
      tab.
    2. Push
      "Checkin All"
      icon.
    3. "Checkin"
      dialog shows up. {"Checkin Message"} area, "Button" recently used messages, "Files To Checkin" table, "Preserve Modification Time" and "Force Checkin Of Unmodified Files" check boxes should be there. "Files To Checkin" table should contain 4 records: "Main.java" and "NewClass.java", "xx" and "yy".
    4. Push the
      "Checking"
      button. Note that next time you will invoke the {"Checkin"} dialog again, the checkin message will be prefilled with the last one used. You can choose from list of previously entered checkin messages by clicking the "Recent Messages" button (sheet icon above the text field).
    • EXPECTED RESULT: Verify that blue badges disappeared. Only this record should be shown in
      "Clearcase"
      tab.
  8. Checkin file (Force Checkin of Unmodified Files)
    1. Modify and save
      "Main.java"
      file. Now undo all changes and save this file.
    2. Switch to
      "Clearcase"
      tab.
    3. Push
      "Checkin All"
      icon.
    4. "Checkin"
      dialog shows up. {"Main.java"} should be listed in checkin table.
    5. Leave both check boxes unchecked.
    6. Push the
      "Checking"
      button.
    7. Error dialog should be shown... File can't be checkin.
    8. Select
      "Main.java"
      and invoke Clearcase | Checkin... popup menu action.
    9. Make sure that only
      "Force Checkin of Unmodified Files"
      check box. Push {"Checkin"} button.
    • EXPECTED RESULT: Make sure that revision of the
      "Main.java"
      was increased by one in {"Output"} tab.
  9. Checkin file (Preserve Modification Time)
    1. Modify and save
      "Main.java"
      file.
    2. Switch to
      "Clearcase"
      tab.
    3. Push
      "Checkin All"
      icon.
    4. Make sure that only
      "Preserve Modification Time"
      check box. Push {"Checkin"} button.
    5. Push the
      "Checking"
      button.
    • EXPECTED RESULT: Make sure that revision of the
      "Main.java"
      was increased by one in {"Output"} tab. Externally verify the modification time.
  10. Rename file
    1. Select
      "NewClass2.java"
      file and invoke Refactor | Rename popup menu action.
    2. In upcoming dialog enter new name for it ("Renamed"). Push
      "Refactor"
      button.
    3. File should be renamed. Make sure its status is [[[Reserved;\main\X | [Reserved; \main\X]] and color is blue and pristine file should disappear.
    4. Select this file and invoke Clearcase | Checkin action. Push
      "Checkin"
      dialog.
    • EXPECTED RESULT: Make sure that there is no
      "NewClass2.java"
      . Status of {"Renamed.java"} is up-to-date (its color is black).
  11. Rename directory
    1. Switch to
      "Files"
      view.
    2. Select
      "xx"
      file and invoke Refactor | Rename popup menu action.
    3. In upcoming dialog enter new name for it ("aa"). Push
      "Refactor"
      button.
    4. All files from
      "xx"
      package and {"src"} folder should be [[Reserved;\main\X] and color of them is blue.
    5. Push Checkin All button from
      "Clearcase - Versioning"
      view. Push {"Checkin"} dialog.
    • EXPECTED RESULT: All files from
      "xx"
      package and {"src"} node are up-to-date (their color is black). They should disappear from "Clearcase - Versioning" view.
  12. Ignore file
    1. Create new
      "Java class"
      ("NewClass2") into {"xx.yy"} package.
    2. Select this java file and invoke Clearcase | Ignore .
    • EXPECTED RESULT:
      "NewClass2.java"
      should change its color to gray.
  13. Working with ignored file
    1. Open
      "NewClass2.java"
      into the editor, modify this file and save the changes.
    2. Switch to
      "Projects"
      view, select project root and invoke Versioning | Show Changes from main menu.
    • EXPECTED RESULT: Verify that there no badges indicating path to
      "NewClass2.java"
      file. Color of file name should be gray. This should NOT be listed in {"Clearcase"} tab.
  14. Unignore file
    1. Select
      "NewClass2.java"
      in {"Projects"} view and invoke Versioning | Unignore popup menu action. Verify that this action is also accessible from main menu.
    2. "Clearcase"
      tab should contain {"NewClass2.java (Locally New)"} files. Path to this should be indicated with blue badges.
    3. Select project root and invoke Versioning | Checkin... action from main menu.
    4. "Checkin"
      dialog shows up, enter some checkin message and push {"Checkin"} button.
    • EXPECTED RESULT: File should disappear from
      "Clearcase"
      tab. Font color of {"NewClass2.java"} file is black now.
  15. Ignore directory
    1. Switch to
      "Files"
      view.
    2. Create new
      "Java class"
      ("NewClass") into {"aa"} package.
    3. Select
      "aa"
      package and invoke Clearcase | Ignore .
    • EXPECTED RESULT:
      "NewClass.java"
      should change its color to gray. Both {"aa"} and "NewClass.java" should have [Ignored; ] textual annotation.
  16. Unignore directory
    1. Select
      "aa"
      package in {"Files"} view and invoke Versioning | Unignore popup menu action. Verify that this action is also accessible from main menu.
    • EXPECTED RESULT:
      "Clearcase"
      tab should contain {"aa (Locally New)"} and "NewClass.java (Locally New)" files. Path to this should be indicated with blue badges in "Projects" and "Files" views.
  17. Delete locally new files
    1. Select
      "aa"
      and invoke Delete popup menu action.
    2. "Safe delete"
      dialog shows up.
    3. Push
      "OK"
      button.
    • EXPECTED RESULT:
      "aa"
      and {"NewClass"} should disappear from the "Clearcase", "Projects" and "Files" tabs.
  18. Exclude file from Checkin
    1. Create
      "JFrame"
      in {"xx.yy"} package.
    2. Invoke Clearcase | Checkin... on this JFrame in
      "Projects"
      view.
    3. Switch to
      "Clearcase"
      tab, there should be listed {"NewJFrame.java"} and "NewJFrame.form" files. Select both the files and invoke Checkin....
    4. "Checkin"
      dialog should be displayed with these JFrame files. Change the {"Action"} to "Exclude from Checkin" for both files. "Checkin" button should be disabled. Cancel this dialog.
    5. Select
      "JFrame"
      and invoke _Clearcase | Exclude from Checkin__
    • EXPECTED RESULT: Both files have to be excluded from commit with no change of their statuses. Include To Checkin action should be accessible in popup menu actions in
      "Clearcase"
      tab and performing Include in Checkin must return file to be ready for {"checkin"}.
  19. Checkout/Uncheckout file - Reserved
    1. Select
      "Main.java"
      in {"Projects"} view and invoke Versioning | Checkout... popup menu action. Check "Reserved Checkout" check box. Push "Checkout" button. Verify that this action is also accessible from main menu.
    2. "Clearcase"
      tab should contain {"Main.java (Reserved)"} file. Path to this should be indicated with blue badges.
    3. Select
      "Main.java"
      in {"Files"} view and invoke Versioning | Uncheckout... popup menu action. Check "create back up of checked out file" check box. Push "Uncheckout" button. Verify that this action is also accessible from main menu.
    • EXPECTED RESULT: File should disappear from
      "Clearcase"
      tab. Font color of {"Main.java"} file is black now. Also verify that if file is checked out "Checkout..." action is disabled and vice versa. "Main.java.keep.1" should be shown in "Clearcase" tab only. (Externally delete "Main.java.keep.1")
  20. Checkout/Uncheckout file - Unreserved
    1. Select
      "Main.java"
      in {"Projects"} view and invoke Clearcase | Checkout... popup menu action. Uncheck "Reserved Checkout" check box. Push "Checkout" button. Verify that this action is also accessible from main menu.
    2. "Clearcase"
      tab should contain {"Main.java (Unreserved)"} file. Path to this should be indicated with blue badges.
    3. Select
      "Main.java"
      in {"Files"} view and invoke Versioning | Uncheckout... popup menu action. Check "create back up of checked out file" check box. Push "Uncheckout" button. Verify that this action is also accessible from main menu.
    • EXPECTED RESULT: File should disappear from
      "Clearcase"
      tab. Font color of {"Main.java"} file is black now. Also verify that if file is checked out "Checkout..." action is disabled and vice versa. "Main.java.keep.1" should be shown in "Clearcase" tab.
  21. Reserve
    1. Select
      "Main.java"
      in {"Projects"} view and invoke Clearcase | Checkout... popup menu action. Uncheck "Reserved Checkout" check box. Push "Checkout" button. Verify that this action is also accessible from main menu.
    2. "Clearcase"
      tab should contain {"Main.java (Unreserved)"} file. Path to this should be indicated with blue badges.
    3. Select
      "Main.java"
      in {"Files"} view and invoke Versioning | Reserve... main menu action. In "Reserve Checkout" dialog enter "Checkout Message" and push "Reserve" button.
    • EXPECTED RESULT: File should be shown in
      "Clearcase"
      tab as {"Reserved"}. Font color of "Main.java" file is blue now.
  22. Unreserve
    1. Select
      "Main.java"
      in {"Files"} view and invoke Versioning | Reserve... main menu action. In "Unreserve Checkout" dialog enter "Checkout Message" and push "Unreserve" button.
    • EXPECTED RESULT: File should be shown in
      "Clearcase"
      tab as {"Unreserved"}. Font color of "Main.java" file is blue now.
  23. Update
    • Setup: Make sure that SNAPSHOT view is used as a base for this case. Make some modifications in another view.
    1. Select
      "Project"
      root node and invoke __Clearcase | Update.
    • EXPECTED RESULT: File should be shown in
      "Clearcase"
      tab as {"Unreserved"}. Font color of "Main.java" file is blue now.

}}

Test suite: Clearcase Options

Purpose: This suite tests some configurable options of Clearcase.
Setup: No preparation required.

  1. Invoking Clearcase Options
    1. Invoke Tools | Options from main menu.
    2. Push
      "Miscellaneous"
      button.
    3. Select
      "Versioning"
      tab and then select {"Clearcase"} from the "Versioning Systems" list.
    • EXPECTED RESULT: There should be three configurable options:
      "Cleartool Executable Path"
      with {"Browse..."} button, "Disabled (manual checkout required to modify files)", "Prompt For Action", "Hijack", "Unreserved" with "Fallback to Hijack" checkbox, "Reserved" with "Fallback to Unreserved", "Fallback to Hijack" check boxes radio buttons and "Versioning Labels" with "Add Variable.." and "Schedule View Private Files For Check-In" check box.
  2. Setting up Cleartool executable path
    • Comments: This test case is needed only if the
      "cleartool"
      executable is not in the PATH variable and NetBeans is unable to locate it.
    • Setup: Follow steps from "Invoking Clearcase Options" test case.
    1. Push the
      "Browse"
      button.
    2. "Browse for the Cleartool Executable"
      dialog appears. Use it to locate {"cleartool"} executable and press "OK" button.
    • EXPECTED RESULT: After confirmation (using
      "OK"
      ) button and IDE restart, NetBeans should be able to use cleartool executable present in selected folder.
  3. Status Label Format
    • Setup: Complete case 1 and delete everything from
      "Status Label Format text field."
    1. Push
      "Add Variable..."
      button next to {"Format..."} field.
    2. New window labeled
      "Add Variable"
      appears. There should be {"status"}, "version" and "rule" variables listed.
    3. Select line starting with
      "{version}"
      , push {"OK"} button in this window and then "OK" button to confirm Options changes.
    • EXPECTED RESULT: In
      "Projects"
      view you should see version of each file. (It is necessary to have View
  4. Disabled (manual checkout required to modify files)
    • Setup: Complete case 1
    1. Select
      "Disabled (manual checkout required to modify files)"
      and push {"Ok"} button.
    2. Try to edit file that is not checked out (color is black).
    • {{{1}}}
  5. Prompt for Action
    • Setup: Complete case 1
    1. Select
      "Prompt for Action"
      and push {"Ok"} button.
    2. Try to edit file that is not checked out (color is black) and save it.
    • EXPECTED RESULT: TBD: Clearcase dialog shows up. There should be
      "Hijack"
      , {"Checkout Reserved"} and "Checkout Unreserved" radio buttons. Choose each option and verify whether file gets appropriate status "Hijacked", "Reserved" or "Unreserved".
  6. Hijack
    • Setup: Complete case 1 and make sure the file comes from SNAP SHOT view.
    1. Select
      "Hijack"
      and push {"Ok"} button.
    2. Try to edit file that is not checked out (color is black) and save it.
    • EXPECTED RESULT:
      "Clearcase"
      tab should list file as {["Hijacked"]}. Color of node in explorers should be blue and path to this should be indicated by badges.
  7. Unreserved
    • Setup: Complete case 1
    1. Select
      "Unreserved"
      and push {"Ok"} button.
    2. Try to edit file that is not checked out (color is black) and save it.
    • EXPECTED RESULT:
      "Clearcase"
      tab should list file as {["Unreserved"]}. Color of node in explorers should be blue and path to this should be indicated by badges.
  8. Reserved
    • Setup: Complete case 1
    1. Select
      "Unreserved"
      and push {"Ok"} button.
    2. Try to edit file that is not checked out (color is black) and save it.
    • EXPECTED RESULT:
      "Clearcase"
      tab should list file as {["Reserved"]}. Color of node in explorers should be blue and path to this should be indicated by badges.
  9. Schedule View Private Files For Check-In
    • Setup: Complete case 1.
    1. Check the
      "Schedule View Private Files For Check-In"
      checkbox and push {"OK"} button.
    2. Add one new file to your project. Add one new file externally (eg. copy some file to src folder of your project).
    3. Select project root and invoke Versioning | Checkin....
    • EXPECTED RESULT: All newly added files should have
      "Ignored"
      in their textual annotation next node. {"Clearcase"} tab shouldn't list any new file.


Test suite: Inspecting sources

Purpose: This suite tests "archeology" searching.
Setup: No preparation required.

  1. Annotations
    1. Select
      "Main.java"
      node and invoke Clearcase | Show Annotations popup menu action.
    2. "Annotations" column and "Stripes" should be displayed around the editor area of this file.
    3. Select desired line (with revision "\main\1").
    4. All lines with revision ("\main\1") should be colored blue in "annotations" column. "Stripes" should show navigations to this revision too.
    5. Move mouse pointer over "Revision" column and invoke popup menu.
    • EXPECTED RESULT: There should be Diff to and Hide Annotations actions listed in popup menu.
  2. Annotations actions
    1. Choose Diff ... action.
    2. "Diff" tab should be opened into the editor for specified revisions.
    3. Choose Close Annotations action.
    4. This action should hide annotation column and stripes too.
    • EXPECTED RESULT: Verify functionality on various revisions and navigations with the use of "Stripes".
  3. View Revision
    1. Select
      "Main.java"
      node and invoke Clearcase | View Revision... popup menu action.
    2. "View Revision"
      dialog should be opened. Make sure that {"Revision"} and "Working Branch LATEST" radio buttons.
    3. Select
      "Revision"
      radio button, enter {"\main\1"} for the text field (revision selector) and push "View" button.
    • EXPECTED RESULT: New tab has to be opened into editor area. The title should be
      "Main.java @ \main\1"
      . Repeat steps of this test case to verify functionality of {"Working Branch LATEST"}.


Test suite: External features

Purpose: This suite tests other features of Clearcase like version tree etc.
Setup: No preparation required.

  1. Browse History
    1. Select
      "Main.java"
      in {"Files"} view and invoke Versioning | Browse History popup menu action..
    • EXPECTED RESULT: Appropriate native component of ClearCase must be opened with correct information..
  2. Browse Version Tree
    1. Select
      "Main.java"
      in {"Files"} view and invoke Versioning | Browse Version Tree popup menu action..
    • EXPECTED RESULT: Appropriate native component of ClearCase must be opened with correct information..
  3. Show Properties
    1. Select
      "Main.java"
      in {"Files"} view and invoke Versioning | Show Properties popup menu action..
    • EXPECTED RESULT: Appropriate native component of ClearCase must be opened with correct information..


Not logged in. Log in, Register

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2012, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo