3.8.2 Version Control in Java Virtual Folders
When
you select the command Version Control from the context-sensitive menu,
a dialog box will appear that allows you to view the version history of the
selected object and gives you access to the version control functions: Check
In, Check Version, Revert, Delete and Take Out (see Figure
25).
To apply these commands to a version of a document:
- Right click on the object you wish to apply the Version Control command to.
- From the context-sensitive menu that appears, choose the option Version
Control.
- In the Version Control dialog box, click on the version on which
you want to perform the version control function and click on the appropriate
button (Check In, Check Out, Revert, Delete,
Take Out, Set Committed Version).
- Click on the Close button to exit the dialog box.
Figure 25: The Version Control dialog box
VIEWING COMMENTS
If you double click on any version in the Version Control dialog box, a
secondary dialog box will appear, displaying the comment that was entered with
that version. See Figure 26.
Figure 26: Version Control dialog with version comment
CHECK OUT / CHECK IN FROM CONTEXT-SENSITIVE MENU
It is also possible to apply the Check In and Check Out commands
directly from the context-sensitive menu, without opening the Version Control
dialog box.
Check Out will only appear on the context-sensitive menu when you click
on an object for which you have write rights and which is version controlled.
Check In will only appear on the context-sensitive menu when you click
on an object for which you have write rights and which are not yet version
controlled, or which are version controlled and checked out.
CHECK OUT A DOCUMENT
To
check out a document:
- Click with your right mouse button on the document you wish to check out
- Choose Check Out from the context-sensitive menu. A dialog box
appears showing all versions existing for the document (Figure 27).
- Choose the version you wish to check out.
- Click on the OK button to check out the version.
If you select
the checkbox labeled Do not show this dialog next time, you will only be
able to check out the most recent version of the document with this method. You
will still be able to check out previous versions by accessing the Version
Control dialog box (see
page
30).
A notification dialog will display the progress of the check out action, and
list any errors that might occur.
The document now appears in the Java Virtual Folders view as an experimental
version.
Figure 27: Check Out dialog box
CHECK OUT MULTIPLE DOCUMENTS
It is also possible to check out more than one document at a time. To check out
multiple documents:
- Select the documents you wish to check out by clicking on them once.
Select sequential documents by holding down your shift button and clicking,
select documents that are not next to each other by holding down your control
button (Ctrl) and clicking.
- Click with your right mouse button on one of the selected documents.
- Choose Check Out from the context-sensitive menu. You will not be
given the option to check out previous versions of the documents. The most
recent version of all documents will be checked out.
CHECK
IN A DOCUMENT
To
check in a document:
- Click with your right mouse button on the document you wish to check in.
- Choose Check In from the context-sensitive menu.
- A dialog box appears where you can enter a comment and set the version
number for the new committed version (see Figure 28).
If you select the
checkbox Check in only if content changed, the document will only be
checked in if its content has been modified. If the content has not been
changed, the previous version number will be reverted to and the experimental
version deleted.
A dialog box appears showing the progress of the action, and listing any errors
that might occur.
The document now appears in the Java Virtual Folders view with its new version
number.
Figure 28: Check In dialog box