Add, Detect New, View, Edit and Delete Files

Adding Files

The Add Files/Folders command allows you to add new files or folders to the open repository by selecting items accessible to the local machine. You can include or exclude any file or folder underneath the selected folder, and a default exclusion list automatically excludes files or folders containing defined string patterns.

To activate the dialog box, do one of the following:

• Select Add Folders/Files from the File menu.

• Select Add Folders/Files on the Toolbar.

• Select Add Folders/Files from the destination Folder’s context menu.

• Ctrl+N

In addition to invoking the Add Folder/Files command, you can also simply drag a file or a folder to the file list pane of the main window. This will automatically bring up the Add Folders/Files dialog with the contents of your selection from the Windows Explorer.

Commit Add Files

If Auto-Commit has been selected (default), the files and folders will be added to the Vault repository immediately. If Auto-Commit has not been selected, the files and folders will be added to the repository as part of the next check in transaction.

Please see Auto-Commit for more information.

Detecting New Files

The Detect New Files command allows you to see which files exist in your local working folder that do not exist in Vault, therefore allowing you to easily add newly created files to the repository.

To activate the dialog box, do one of the following:

• Select Detect New Files to Add from the File menu.

• Select Detect New Files to Add from the destination Folder’s context menu.

Viewing Files

The View File command allows a user to view the latest version of a file without checking it out or replacing the local copy of the file. To view the most recent version in the repository, select a file. Then do one of the following to bring up the View File dialog box.

• On the Edit menu, click View File.

• Click View on the Toolbar.

• Right-click the selected file to bring up the File List Context Menu, then click View.

• Double-click the selected file.

Editing Files

The Edit File command checks out a file and launches an external editor in a single operation. Select a file and do one of the following to launch the editor.

• On the Edit menu, click Edit File.

• Click Edit on the Toolbar.

• Right-click the selected file to bring up the File List Context Menu, then click Edit.

Working Folder

A working folder must be defined in order to edit a file. If the working folder is not defined, the Set Working Folder dialog box will be displayed first. Canceling the Set Working Folder will cancel the Edit command.

Check Out

After the working folder is set, the Check Out dialog box is displayed. If Check Out is cancelled or if the check out fails for any reason, the Edit operation is cancelled. If you successfully check the file out, the file will come up in the selected editor.

Editor

In Windows, Notepad is the default editor. To select a different editor as a default, please see External Programs Options.

Deleting Files

The Delete command allows you to delete files from the repository. If multiple files are selected, the Delete command will delete them all at the same time. A user must have permissions set by the administrator in the Admin Tool to delete files. To activate the dialog box, click Delete from the File menu or on the Toolbar.

Please Note: The Delete command is non-destructive. The file or folder still exists in the history of the repository and can be recovered by clicking the Undelete command found in the Folder Properties dialog box.

The Vault client does not allow operations which destroy history. The Obliterate command is available in the Vault Admin Tool.

Checked Out Files

You can delete a file that is currently checked out, even if it is exclusively checked out. A warning message is displayed before allowing this. If you attempt to check in a file that has been deleted, an error message will be displayed.

Pinned Files

A file with a primary pin on it can be deleted. A file with a secondary pin can be deleted only if the parent folder with the primary pin is also being deleted. For example, if $/foo/bar is pinned, then the delete operation will succeed at $/foo and $/foo/bar but will fail on any subfolder or file within $/foo/bar. Please see Pin Files for more information.

Commit Delete